drupal_dirname

  1. drupal
    1. 8
    2. 7
Versions
7 – 8 drupal_dirname($uri)

Gets the name of the directory from a given path.

PHP's dirname() does not properly pass streams, so this function fills that gap. It is backwards compatible with normal paths and will use PHP's dirname() as a fallback.

Compatibility: normal paths and stream wrappers.

Parameters

$uri A URI or path.

Return value

A string containing the directory name.

See also

http://drupal.org/node/515192

dirname()

Related topics

▾ 4 functions call drupal_dirname()

FileUnmanagedCopyTest::testOverwriteSelf in modules/simpletest/tests/file.test
Copy a file onto itself.
file_destination in includes/file.inc
Determines the destination path for a file depending on how replacement of existing files should be handled.
file_unmanaged_copy in includes/file.inc
Copies a file to a new location without invoking the file API.
image_style_create_derivative in modules/image/image.module
Creates a new image derivative based on an image style.

Code

includes/file.inc, line 2258

<?php
function drupal_dirname($uri) {
  $scheme = file_uri_scheme($uri);

  if ($scheme && file_stream_wrapper_valid_scheme($scheme)) {
    return file_stream_wrapper_get_instance_by_scheme($scheme)->dirname($uri);
  }
  else {
    return dirname($uri);
  }
}
?>