`find` should return null when a value could not be found, instead of false

[rtheunissen]

This applies to all current and future variations of find.

[morrisonlevi]

Deque has a find; what else? I seem to remember some docs for this ext but can't seem to find them anymore.

[morrisonlevi]

Ah, docs are on php.net now. Will look into this. Edit: it looks like the Sequence interface and its two implementations Vector and Deque are the only ones that have find. Will PR this soon.

[morrisonlevi]

I think I've fixed everything I can find (ha) about it.

[rtheunissen]

I've actually changed my mind on this. find should support an optional default value and throw an exception if the key couldn't be found and no default was provided. So if you know you have string keys you can use $map->find(5, false) which would return false if a key for the value 5 couldn't be found. This allows us to not be ambiguous by returning null or false when those two values could have been used as keys. It's up to the developer to establish an appropriate "not found" value. A side effect of this is that it imitates how get(key, default) works, only in reverse.