canonicalize_file_name - zwraca kanoniczną, absolutną
ścieżkę pliku
Standardowa biblioteka C (
libc,
-lc)
#define _GNU_SOURCE /* Patrz feature_test_macros(7) */
#include <stdlib.h>
char *canonicalize_file_name(const char *ścieżka);
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(path, NULL);
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.
Zobacz
realpath(3)
Informacje o pojęciach używanych w tym rozdziale można
znaleźć w podręczniku
attributes(7).
| Interfejs |
Atrybut |
Wartość |
|
canonicalize_file_name() |
Bezpieczeństwo wątkowe |
MT-Safe |
Funkcja jest rozszerzeniem GNU.
readlink(2),
realpath(3)
Autorami polskiego tłumaczenia niniejszej strony podręcznika
są: Robert Luberda <
[email protected]> i Michał
Kułach <
[email protected]>
Niniejsze tłumaczenie jest wolną dokumentacją.
Bliższe informacje o warunkach licencji można uzyskać
zapoznając się z
GNU
General Public License w wersji 3 lub nowszej. Nie przyjmuje się
ŻADNEJ ODPOWIEDZIALNOŚCI.
Błędy w tłumaczeniu strony podręcznika prosimy
zgłaszać na adres listy dyskusyjnej
[email protected]