dirname
Gibt den Pfad des übergeordneten Verzeichnisses zurück
Beschreibung
string dirname
( string $path
[, int $levels = 1
] )
Parameter-Liste
-
path
-
Ein Pfad.
Unter Windows wird sowohl der Slash (/) als
auch der Backslash (\) als Trennzeichen bei
Pfadangaben benutzt. Unter anderen Betriebssystemen hingegen nur
der Slash (/).
-
levels
-
Die Anzahl an übergeordneten Ebenen
Dies muss eine Zahl größer 0 sein.
Rückgabewerte
Gibt den Pfad eines übergeordneten Verzeichnisses zurück. Sind keine
Pfadtrenner in path, wird ein Punkt
('.') zurückgegeben, das aktuelle Verzeichnis
kennzeichnend. Ansonsten ist die zurückgegebene Zeichenkette der
path mit dem abschließenden
/component entfernt.
Beispiele
Beispiel #1 dirname Beispiel
<?php
echo dirname("/etc/passwd") . PHP_EOL;
echo dirname("/etc/") . PHP_EOL;
echo dirname(".") . PHP_EOL;
echo dirname("C:\\") . PHP_EOL;
echo dirname("/usr/local/lib", 2);
?>
Das oben gezeigte Beispiel erzeugt
eine ähnliche Ausgabe wie:
/etc
/ (or \ on Windows)
.
C:\
/usr
Anmerkungen
Hinweis:
dirname arbeitet nur mit der Eingabe Zeichenkette
und beachtet nicht das eigentliche Dateisystem oder Pfadbestandteile wie
etwa "..".
Hinweis:
dirname beachtet die Spracheinstellungen (locale);
soll sie daher die korrekte Namensbasis in Pfaden mit einem
Mehrbytezeichensatz erkennen, muss die passende Spracheinstellung (locale)
mit der setlocale Funktion gesetzt werden.
Siehe auch
- basename
- pathinfo
- realpath