Description:
------------
---
From manual page: http://www.php.net/function.readdir#refsect1-function.readdir-examples
---

From documentation: "Returns the entry name on success or FALSE on failure." Function returns NULL instead of FALSE in case of bad dir_handler. I think it should be mentioned in documentation at least.
If dir_handler is not exactly resource, then i.e.: "while(FALSE === readdir('definitely_not_handler'));" can end very badly.

Test script:
---------------
var_dump(readdir('definitely_not_handler'));

Expected result:
----------------
FALSE

Actual result:
--------------
NULL