dirname
(PHP 4, PHP 5)
dirname —
Beschreibung
string dirname
( string $path
)
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 (/).
Rückgabewerte
Gibt den Pfad des ü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 "1) " . dirname("/etc/passwd") . PHP_EOL; // 1) /etc
echo "2) " . dirname("/etc/") . PHP_EOL; // 2) / (or \ on Windows)
echo "3) " . dirname("."); // 3) .
?>
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.
Hinweis:
Seit PHP 4.3.0 werden sie von dirname() oft einen
Schrägstrich oder einen Punkt zurückbekommen, wo die frühere
Funktionalität eine leere Zeichenkette ergeben hätte.
Prüfen sie das folgende Beispiel für die Änderung:
Siehe auch
- basename() - Gibt letzten Namensteil einer Pfadangabe zurück
- pathinfo() - Liefert Informationen über einen Dateipfad
- realpath() - Löst einen Pfad in einen absoluten und eindeutigen auf
