Scroll to navigation

CANONICALIZE_FILE_NAME(3) Podręcznik programisty Linuksa CANONICALIZE_FILE_NAME(3)

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)

ATRYBUTY

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

ZGODNE Z

Funkcja jest rozszerzeniem GNU.

ZOBACZ TAKŻE

readlink(2), realpath(3)

O STRONIE

Angielska wersja tej strony pochodzi z wydania 4.07 projektu Linux man-pages. Opis projektu, informacje dotyczące zgłaszania błędów oraz najnowszą wersję oryginału można znaleźć pod adresem https://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ą 4.07 oryginału.

2015-03-02 GNU