table of contents
- bullseye-backports 4.18.1-1~bpo11+1
- testing 4.18.1-1
- unstable 4.18.1-1
CANONICALIZE_FILE_NAME(3) | Руководство программиста Linux | CANONICALIZE_FILE_NAME(3) |
ИМЯ¶
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).
Интерфейс | Атрибут | Значение |
canonicalize_file_name() | Безвредность в нитях | MT-Safe |
СООТВЕТСТВИЕ СТАНДАРТАМ¶
Эта функция является расширением GNU.
СМ. ТАКЖЕ¶
ЗАМЕЧАНИЯ¶
Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.
ПЕРЕВОД¶
Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.
15 сентября 2017 г. | GNU |