Hello,

I recently added a comment to the documentation on Boolean types. It 
is relevant also under the section for Comparative Operators and any 
functions which may find a needle in position 0 of a haystack. The 
=== and !== operators are not mentioned in the official documentation 
of Booleans. They are mentioned under Comparative Operators but are 
not defined. The operator === is mentioned in the strpos section, the 
array_search section and possibly the sections covering other 
functions that may find a needle in position 0 of a haystack.

I suggest that something like my comment to the Boolean section be 
incorporated. The thing is I'm not sure I did a great job, nor do I 
know how to handle explanations in other sections, nor which other 
sections (functions) will make use of === and !== in this way. And it 
seems to me that the information should be part of the official 
documentation. It is not an 'extra'.

I would suggest that the documentation section for each function that 
may find a needle at position 0 of a haystack should say something 
like the following:
This function returns false if the needle is not found, otherwise it 
returns the position where the needle was found. This value will not 
equate to 'true' if the needle is found at position 0.  So the 
correct ways to ask if the function found a result are
if (strpos($needle,$haystack) !== false)
and
if(strpos($needle,$haystack) === false).

Or you may want to say it only once and direct readers to the section 
where it is said. But it seems to me if you do it that way it is 
still important to warn users that the functions will not return 
true. The only boolean they can check for with === and !== is false.

Many thanks!


Best regards, John Clements