Linux repositories inspector
GNU
2017-09-15
Aliases: dirname(3), dirname(3), dirname(3), dirname(3), dirname(3), dirname(3), dirname(3), dirname(3), dirname(3), dirname(3)

man-pages-ru

Russian man pages from the Linux Documentation Project

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

ИМЯ

basename, dirname - разделяет путь на компоненты

ОБЗОР

#include <libgen.h>

char *dirname(char *path);
char *basename(char *path);

ОПИСАНИЕ

Предупреждение: есть две разных функции basename() — смотрите далее.
Функция dirname() и basename() разделяют строку с путём, заканчивающуюся null, на каталог и имя файла. Обычно, dirname() возвращает строку до последнего символа \(aq/\(aq, не включая его, а basename() возвращает часть, следующую за последним символов \(aq/\(aq. Конечные символы \(aq/\(aq не считаются частью пути.
Если path не содержит косую черту, то dirname() возвращает строку «.», а basename() возвращает копию path. Если строка path равна «/», то dirname() и basename() возвращают строку «/». Если значение path равно указателю null или указывает на пустую строку, то dirname() и basename() возвращают строку «.».
Если объединить строку, возвращаемую dirname(), «/» и строку, возвращаемую basename(), то получится первоначальный путь.
Функции dirname() и basename() могут изменить содержимое path, поэтому желательно передавать копию строки при их вызове.
Данные функции могут возвращать указатели на статически выделенную память, которая может измениться при последующих вызовах. Или же они могут возвращать указатель на часть path, поэтому строка, на которую ссылается path, не должна изменяться или освобождаться до тех пор, пока указатель, возвращаемый функцией, станет ненужным.
В следующих примерах (взяты из SUSv2) показаны строки, возвращаемые dirname() и basename() для различных путей:
путь dirname basename
/usr/lib /usr lib
/usr/ / usr
usr . usr
/ / /
. . .
.. . ..

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

Функции dirname() и basename() возвращают указатели на строки, оканчивающиеся null (не передавайте эти указатели free(3)).

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).
Интерфейс Атрибут Значение
basename(), dirname() Безвредность в нитях MT-Safe

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

POSIX.1-2001, POSIX.1-2008.

ЗАМЕЧАНИЯ

Существует две различные версии basename() — версия POSIX, описанная выше, и версия GNU, которая описана далее
#define _GNU_SOURCE /* смотрите feature_test_macros(7) */ #include <string.h>
Версия GNU никогда не изменяет свои аргументы и возвращает пустую строку, если path оканчивается символом косой черты, а в частности, если значение равно «/». Версии GNU для dirname() не существует.
Если в исходный код включён файл <libgen.h>, то из glibc используется версия basename(), описанная в POSIX, иначе — версия GNU.

ДЕФЕКТЫ

Функции версии POSIX, реализованные в glibc, изменяют аргумент path, что приводит к ошибки сегментации при их вызове со статической строкой вида «/usr/».
До glibc 2.2.1, функция dirname() некорректно обрабатывала пути, оканчивающиеся символами \(aq/\(aq, а также вызывало ошибку сегментирования, если указывался аргумент со значением NULL.

ПРИМЕР

Следующий пример кода демонстрирует использование basename() и dirname(): char *dirc, *basec, *bname, *dname; char *path = "/etc/passwd";
dirc = strdup(path); basec = strdup(path); dname = dirname(dirc); bname = basename(basec); printf("dirname=%s, basename=%s\n", dname, bname);

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

⇧ Top