DirectoryIterator::key

(PHP 5, PHP 7, PHP 8)

DirectoryIterator::keyReturn the key for the current DirectoryIterator item

Description

publicDirectoryIterator::key(): mixed

Get the key for the current DirectoryIterator item.

Parameters

This function has no parameters.

Return Values

The key for the current DirectoryIterator item as an int.

Changelog

VersionDescription
8.1.0 When the iterator is uninitialized, an Error is thrown now. Previously, the method returned false.

Examples

Example #1 A DirectoryIterator::key() example

<?php
$dir
= new DirectoryIterator(dirname(__FILE__));
foreach (
$dir as $fileinfo) {
if (!
$fileinfo->isDot()) {
echo
$fileinfo->key() . " => " . $fileinfo->getFilename() . "\n";
}
}
?>

The above example will output something similar to:

0 => apple.jpg 1 => banana.jpg 2 => index.php 3 => pear.jpg

See Also

To Top