I/O Collections
, (*1)
API
The entry point for accessing I/O collections are the io.collections.IOCollection implementations:, (*2)
-
io.collections.FileCollection - files in a given filesystem path
-
io.collections.ArchiveCollection - files inside a XAR archive
To access the files from more than one collection, use the io.collections.CollectionComposite class., (*3)
Iteration
The subpackage io.collections.iterate allows iterating I/O collections., (*4)
-
io.collections.iterate.IOCollectionIterator - iterate a given I/O collection, optionally recursive
-
io.collections.iterate.FilteredIOCollectionIterator - as above, but with an optional filter
Filters
The following filters are available:, (*5)
Date-based:, (*6)
io.collections.iterate.AccessedAfterFilter(util.Date $date)io.collections.iterate.AccessedBeforeFilter(util.Date $date)io.collections.iterate.CreatedAfterFilter(util.Date $date)io.collections.iterate.CreatedBeforeFilter(util.Date $date)io.collections.iterate.ModifiedAfterFilter(util.Date $date)io.collections.iterate.ModifiedBeforeFilter(util.Date $date)
Size-based:, (*7)
io.collections.iterate.SizeEqualsFilter(int $compare)io.collections.iterate.SizeBiggerThanFilter(int $limit)io.collections.iterate.SizeSmallerThanFilter(int $limit)
Name-based:, (*8)
io.collections.iterate.ExtensionEqualsFilter(string $compare)io.collections.iterate.NameEqualsFilter(string $compare)io.collections.iterate.NameMatchesFilter(string $pattern)io.collections.iterate.UriMatchesFilter(string $pattern)
Type-based:, (*9)
io.collections.iterate.CollectionFilter()
To combine filters, use the util.Filters class., (*10)
Example
This finds all JPEG files inside the directory /home/thekid/multimedia:, (*11)
use io\collections\FileCollection;
use io\collections\iterate\{FilteredIOCollectionIterator, ExtensionEqualsFiler};
use util\cmd\Console;
use util\Filters;
$iterator= new FilteredIOCollectionIterator(
new FileCollection('/home/thekid/multimedia'),
Filters::allOf([new ExtensionEqualsFilter('.jpg'), new ExtensionEqualsFilter('.JPG')]),
true
);
foreach ($iterator as $file) {
Console::writeLine($file);
}
See also
Wallogit.com
