`Iterable.any` docs slightly unclear?

[ditman]

I was reading the docs for Iterable.any and it says this:

Checks every element in iteration order, and returns true if any of them make test return true, otherwise returns false. Returns false if the iterable is empty.

At first I thought that it'd check every (all) element in iteration order, then return true if any of them makes test return true.

But the implementation actually returns immediately:

• https://github.com/dart-lang/sdk/blob/107995fcdbe10af87ee02bfd39593e567fa59e77/sdk/lib/core/iterable.dart#L481

I think something like this may be clearer:

"Checks elements in iteration order, and returns true when any of them makes test return true, otherwise returns false."

(This maybe too subtle a change for my level of english, though 😅)

[dart-github-bot]

Summary: User finds Iterable.any documentation unclear. The current wording implies a complete iteration before returning, while it short-circuits.

[lrhn]

Old docs are often quite terse. Makes sense to write something more here.