dirname() - パス名の親ディレクトリーの報告

標準

形式

#define _XOPEN_SOURCE_EXTENDED 1
#include <libgen.h>

char *dirname(char *path);

機能説明

dirname() 関数は、パス名が入っている文字ストリングを指すポインター を受け取って、そのファイルの親ディレクトリーのパス名であるストリングを指す ポインターを戻します。パスの末尾の (/) 文字は、パスの一部としてカウントされません。

path に (/) が含まれていないと、dirname() は、ストリング "." を指すポインターを戻します。path が NULL ポインターの場合、または空ストリングを指す場合は、dirname() は、ストリング "." を指すポインターを戻します。

dirname() 関数は、path が指すストリングを変更する場合があります。

Input String       Output String
"/usr/lib"         "/usr"
"/usr/"            "/"
"usr"              "."
"/"                "/"
"."                "."
".."               "."

戻り値

正常に実行された場合、dirname() は、path の親ディレクトリーであるストリングを 指すポインターを戻します。

path が NULL ポインターの場合、または空ストリングを指す場合は、dirname() は、ストリング "." を指すポインターを戻します。

errno 値は定義されていません。

関連情報

• libgen.h
• basename() - パス名の最新コンポーネントの戻し