Provided by: manpages-zh_1.5.2-1_all bug

NAME

       dirname, basename - 分析路徑成員

總覽 (SYNOPSIS)
       #include <libgen.h>

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

描述 (DESCRIPTION)
       dirnamebasename  把  以  null 結尾 的 路徑名 分解為 目錄 和 檔名.
       一般情況下, dirname 返回 路徑名 的 前面部分, 直到  (但不包括)  最後一個
       '/',  而 basename 則 返回 最後一個 '/' 後面 的 內容. 如果 路徑名 以 '/'
       結尾, 該 '/' 被認為 不是 路徑名 的 一部分.

       如果 路徑名 path 不包含 斜槓 '/', dirname 返回 字符串 ".", 而  basename
       返回  path  的 副本. 如果 路徑名 path 是 "/", 則 dirnamebasename 均
       返回 "/". 如果 路徑名 path 是 NULL 指針 或 指向  空串,  則  dirnamebasename 均 返回 ".".

       把  dirname  返回的  字符串,  "/", 和 basename 返回的 字符串 連接 起來,
       能夠 產生 一個 完整 的 路徑名.

       無論 dirname 還是 basename 都 有可能 更改 path 的 內容, 因此 如果  需要
       保護  原有  路徑名, 應該 傳送 副本 作為 參數. 此外, dirnamebasename
       返回的 指針 可能 指向 一塊 靜態分配 的 記憶體, 會被 下次 調用 覆蓋.

       下面 的 例子  (摘自  SUSv2)  展示了  對於  不同的  路徑名,  dirnamebasename 返回 的 字符串:

       path           dirname        basename
       "/usr/lib"     "/usr"         "lib"
       "/usr/"        "/"            "usr"
       "usr"          "."            "usr"
       "/"            "/"            "/"
       "."            "."            "."
       ".."           "."            ".."

示例 (EXAMPLE)
       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);
       free(dirc);
       free(basec);

返回值 (RETURN VALUE)
       dirnamebasename 均 返回 以 null 結尾的 字符串 的 指針.

BUGS

       在  glibc  的 各個 版本 中, 直到 (並包括) 2.2.1, dirname 無法 正確 處理
       以 '/' 字符 結尾 的 路徑名. 如果 參數 是 NULL 指針, 他 還會 產生 段沖突
       (segmentation violation).

遵循 (CONFORMING TO)
       SUSv2

另見 (SEE ALSO)
       dirname(1), basename(1)

[中文版維護人]
       徐明 <xuming@users.sourceforge.net>

[中文版最新更新]
       2003/05/13

《中國Linux論壇man手冊頁翻譯計劃》
       http://cmpp.linuxforum.net