dirname

在 PHP 4.0.3 中，dirname() 被修正為 POSIX 兼容。本質上就意味著如果在 path 中沒有斜線，則返回一個點（'.'），表示當前目錄。否則返回的是把 path 中結尾的 /component（最後一個斜線以及後面部分）去掉之後的字元串。注意這意味著在老的函式返回一個空字元串的情形下通常從 dirname() 得到的是斜線或者一個點。

基本介紹

• 外文名：dirname
• 語法：dirname Path
• 用途：把指定路徑除了最後寫標準輸出
• 退出狀態：此命令返回零值表成功

概述

註明

(PHP 3, PHP 4, PHP 5)

dirname -- 返迴路徑中的目錄部分

說明

string dirname ( string path )

給出一個包含有指向一個檔案的全路徑的字元串，本函式返回去掉檔案名稱後的目錄名。

在 Windows 中，斜線（/）和反斜線（\）都可以用作目錄分隔設定。在其它環境下是斜線（/）。

例子 1. dirname() 例子

<?php

$path = "/etc/passwd";

$file = dirname($path); // $file is set to "/etc"

dirname() 從 PHP 4.3.0 開始有所改變。請看以下例子：

<?php

// PHP 4.3.0 以前

dirname('c:/'); // 返回 '.'

// PHP 4.3.0 以後

dirname('c:/'); // 返回 'c:'

?>

Dirname 命令

用途

把指定路徑除了最後以外的部分寫到標準輸出。

語法

dirname Path

描述

dirname 命令讀取指定路徑名刪除最後一個“/”（斜槓）及其後面的字元，保留其他部分，並寫結果到標準輸出。如果最後一個“/”後無字元，dirname 命令使用倒數第二個“/”，並忽略其後的所有字元。dirname 命令在創建路徑名的時候遵從以下規則：

如果 Path 參數為“//”（雙斜槓），或者參數 Path 全部由斜槓組成，將其轉換為單斜槓“/”。跳過步驟 2 到 7。 從指定路徑刪除尾部的“/”字元。 如果參數 Path 中沒有剩下的“/”，則將路徑轉換成 . （點）。跳過步驟 4 到 7。 從路徑中刪除尾部的所有非斜槓字元。 如果剩下的路徑為“//”（雙斜槓），跳到步驟 6。 刪除路徑尾部的斜槓字元。 如果剩下的路徑為空，則轉換成單斜槓“/”。例如，輸入：

dirname // 結果為 /（斜槓）。輸入：

dirname /a/b/ 結果為：/a。輸入：

dirname a 結果為 . （點）。輸入：

dirname a/b 結果為路徑名 a。

命令 dirname 和 basename 通常在 shell 內部命令替換使用，以指定一個與指定輸入檔案名稱略有差異的輸出檔案名稱。

退出狀態

此命令返回下列退出值：

0	成功完成
>0	發生錯誤。

示例

要構造和另一檔案位於相同目錄的一個檔案名稱，請輸入：

AOUTFILE=`dirname $TEXTFILE`/a.out這將設定 shell 變數 AOUTFILE 作為檔案 a.out 的名稱，它與 TEXTFILE 位於同一目錄。如果 TEXTFILE 是 /home/fran/prog.c，則 dirname $TEXTFILE 的值成了 /home/fran，且 AOUTFILE 變成了 /home/fran/a.out。

檔案

/usr/bin/dirname

包含令 dirname 命令