ИМЯ

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

ОБЗОР

#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).

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

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

СМОТРИТЕ ТАКЖЕ

readlink(2), realpath(3)