NAZWA¶
canonicalize_file_name - zwraca kanoniczną, absolutną
ścieżkę pliku
SKŁADNIA¶
#define _GNU_SOURCE /* Patrz
feature_test_macros(7) */
#include <stdlib.h>
char *canonicalize_file_name(const char
*ścieżka);
OPIS¶
Funkcja
canonicalize_file_name() zwraca łańcuch
zawierający kanoniczną, absolutną
ścieżkę odnoszącą się do
ścieżki, zakończony znakiem null. W zwracanym
łańcuchu rozwiązywane są dowiązania
symboliczne, składniki ścieżek
. i
...
pathname components. Kolejne znaki (
/) są zastępowane
pojedynczym ukośnikiem.
Zwracany łańcuch jest dynamicznie alokowany przez
canonicalize_file_name(), a wywołujący powinien
zwolnić przydział za pomocą
free(3), gdy
przestanie być on potrzebny.
Wywołanie
canonicalize_file_name(ścieżka) jest
odpowiednikiem wywołania:
realpath(ścieżka, NULL);
WARTOŚĆ ZWRACANA¶
W przypadku powodzenia
canonicalize_file_name() zwraca
łańcuch zakończony znakiem null. Po wystąpieniu
błędu (np. składnik ścieżki jest nie do
odczytania lub nie istnieje)
canonicalize_file_name() zwraca NULL i
ustawia
errno aby poinformować o błędzie.
BŁĘDY¶
Zobacz
realpath(3)
ZGODNE Z¶
Funkcja jest rozszerzeniem GNU.
ZOBACZ TAKŻE¶
readlink(2),
realpath(3)
O STRONIE¶
Angielska wersja tej strony pochodzi z wydania 3.71 projektu Linux
man-pages. Opis projektu, informacje dotyczące zgłaszania
błędów, oraz najnowszą wersję
oryginału można znaleźć pod adresem
http://www.kernel.org/doc/man-pages/.
TŁUMACZENIE¶
Autorami polskiego tłumaczenia niniejszej strony podręcznika man
są: Robert Luberda <robert@debian.org> i Michał
Kułach <michal.kulach@gmail.com>.
Polskie tłumaczenie jest częścią projektu
manpages-pl; uwagi, pomoc, zgłaszanie błędów na
stronie
http://sourceforge.net/projects/manpages-pl/. Jest zgodne z
wersją
3.71 oryginału.