GlobIterator::__construct
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
GlobIterator::__construct — Construct a directory using glob
Description
public
GlobIterator::__construct(
string
$pattern,
int $flags = FilesystemIterator::KEY_AS_PATHNAME | FilesystemIterator::CURRENT_AS_FILEINFO)
Constructs a new directory iterator from a glob expression.
Parameters
-
pattern -
A glob() pattern.
-
flags -
Option flags, the flags may be a bitmask of the FilesystemIterator constants.
Errors/Exceptions
Throws an UnexpectedValueException if the directory does not exist.
Throws a ValueError if the directory is an empty string.
Changelog
| Version | Description |
|---|---|
| 8.0.0 | Now throws a ValueError if directory is an empty string; previously it threw a RuntimeException. |
Examples
Example #1 GlobIterator example
<?php
$iterator = new GlobIterator('*.dll', FilesystemIterator::KEY_AS_FILENAME);
if (!$iterator->count()) {
echo 'No matches';
} else {
$n = 0;
printf("Matched %d item(s)\r\n", $iterator->count());
foreach ($iterator as $item) {
printf("[%d] %s\r\n", ++$n, $iterator->key());
}
}
?>
The above example will output something similar to:
Matched 2 item(s) [1] php5ts.dll [2] php_gd2.dll
See Also
- DirectoryIterator::__construct() - Constructs a new directory iterator from a path
- GlobIterator::count() - Get the number of directories and files
- glob() - Find pathnames matching a pattern
© 1997–2021 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/globiterator.construct.php
