無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

dirname

(PHP 4, PHP 5)

dirnameパス中のディレクトリ名の部分を返す

説明

string dirname ( string $path )

この関数は、ファイルへのパス名を有する文字列を引数とし、 ディレクトリの名前を返します。

パラメータ

path

パス。

Windows では、スラッシュ(/)とバックスラッシュ (\)の両方がディレクトリ区切り文字として使われます。 その他の環境ではスラッシュ(/)になります。

返り値

ディレクトリの名前を返します。 path にスラッシュが無い場合は、 カレントディレクトリを示すドット ('.') を返します。それ以外の場合は、スラッシュ以降の /component 部分を取り除いた path を返します。

変更履歴

バージョン 説明
5.0.0 dirname() がバイナリセーフとなりました。
4.0.3 dirname() が POSIX 準拠となりました。

例1 dirname() の例

<?php
$path 
"/etc/passwd";
$file dirname($path); // $file は "/etc" となります
?>

注意

注意: PHP 4.3.0 以降では、これまでは dirname() が空文字列を返していたような状況で スラッシュやドットを返すことが多くなりました。

以下の例で変更点をご確認ください。

<?php

// PHP 4.3.0 より前のバージョン
dirname('c:/'); // '.' を返します

// PHP 4.3.0 以降のバージョン
dirname('c:/x'); // 'c:\' を返します
dirname('c:/Temp/x'); // 'c:/Temp' を返します
dirname('/x'); // '\' を返します

?>