Руководство по PHP
Пред. |  | След.

# dirname

(PHP 3, PHP 4, PHP 5)

dirname -- Возвращает имя каталога из указанного пути

## Описание

string dirname ( string path )

Данная функция возвращает имя каталога, содержащегося в параметре `path`.

На платформах Windows в качестве разделителей имен директорий используются оба слэша (прямой `/` и обратный `\`). В других операционных системах разделителем служит прямой слэш (`/`).

Пример 1. Пример использования функции dirname()

`<?php $path = "/etc/passwd"; $file = dirname($path); // $file содержит "/etc" ?>`

> Замечание: Начиная с PHP версии 4.0.3, функция dirname() стала совместима со стандартом POSIX. Это, по существу, означает, что, если в `path` отсутствуют слэши, функция вернет точку ('`.`'), обозначающую текущий каталог. Иначе результатом выполнения функции будет являться значение параметра `path` с отброшенным завершающим `/компонентом`. Обратите внимание, что вы будете часто получать точку или слэш в ситуациях, в которых прежняя фунциональность dirname() возвращала бы пустую строку.

dirname() изменила своё поведение в PHP 4.3.0. Примеры:

`<?php //до PHP 4.3.0 dirname('c:/'); // returned '.' //после PHP 4.3.0 dirname('c:/'); // returns 'c:' ?>`

dirname() стала правильно обрабатывать двоичные данные начиная с версии PHP 5.0.0

См.также описание функций basename(), pathinfo() и realpath().

Пред. | Начало | След.
delete | Уровень выше | disk_free_space