NAZWA¶

canonicalize_file_name - zwraca kanoniczną, absolutną ścieżkę pliku

BIBLIOTEKA¶

Standardowa biblioteka C (libc, -lc)

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 oraz składowe ścieżek . i .. . 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ładowa ś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)

ATRYBUTY¶

Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

STANDARDY¶

Funkcja jest rozszerzeniem GNU.

ZOBACZ TAKŻE¶

readlink(2), realpath(3)

TŁUMACZENIE¶

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

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 manpages-pl-list@lists.sourceforge.net.