Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



   canonicalize_file_name - возвращает канонизированный абсолютный путь

canonicalize_file_name(3) возвращает канонизированный абсолютный путь


ОБЗОР

#define _GNU_SOURCE /* смотрите feature_test_macros(7) */
#include <stdlib.h>

char *canonicalize_file_name(const char *path);


ОПИСАНИЕ

Функция canonicalize_file_name() возвращает строку, завершающуюся null, содержащую канонизированный абсолютный путь соответствующего path. В возвращаемой строке раскрываются символьные ссылки, а также компоненты пути . и ... Стоящие подряд символы косой черты (/) заменяются одной чертой.

Место под возвращаемую строку выделяется canonicalize_file_name() динамически и вызывающий должен освободить его с помощью free(3), когда оно станет ненужным.

Вызов canonicalize_file_name(path) эквивалентен вызову:

    realpath(path, NULL);


ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При нормальном завершении работы canonicalize_file_name() возвращает строку с null в конце. При ошибке (например, компонент пути невозможно прочитать или он не существует), canonicalize_file_name() возвращает NULL и устанавливает в errno соответствующее значение ошибки.


ОШИБКИ

Смотрите realpath(3).


АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс Атрибут Значение
canonicalize_file_name() безвредность в потоках: безвредно (MT-Safe)


СООТВЕТСТВИЕ СТАНДАРТАМ

Эта функция является расширением GNU.