Why not to use count($finder)?

Because that will iterate through every single file that matches. If I only want to know if some exist or not, that's an overly expensive check

I remember a similar proposal that wasn't accepted, because the use case is not common enough.
You can achieve it in just one extra line btw:

foreach ($finder as $thing) {
    // do things here
    break;
}

It may be only one extra line but a lot of the clarity is lost. You see a foreach and you think we're doing something with the results, it's misleading

@duncan3dc, I'm not sure but I think you could try to use the Iterator::valid method instead of foreach loop:

if ($finder->getIterator->valid()) {
}

@voronkovich Not if the iterator is an IteratorAggregate you can't

I like this feature proposal ... and I recently needed it 😄

However, I don't like the proposed found() method name, so I checked the method names of PHP SPL iterators. They don't have a method to check if the iterator has elements, but somewhat related it's the valid() method (e.g. in ArrayIterator, valid() returns true if the array contains any more entries).

I'd prefer a more descriptive method name: hasResults(), hasItems(), hasEntries(), hasElements(), etc.

I like the proposal too, and it can be useful, hasResults() is quite nice

👍 for hasResults

@symfony/deciders we need to make a decision here. Personally I'm "-0" :)

I'm 👍

Thank you @duncan3dc.