#47330 [Opn->Csd]: key return value should be specified

ID: 47330 Updated by: torben@php.net Reported By: thuejk at gmail dot com -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: All PHP Version: Irrelevant Previous Comments: ------------------------------------------------------------------------ [2009-08-27 04:48:25] svn@php.net Automatic comment from SVN on behalf of torben Revision: http://svn.php.net/viewvc/?view=revision&revision=287789 Log: Document the fact that key() returns NULL when the array pointer is out of bounds. Addresses Bug #47330. ------------------------------------------------------------------------ [2009-08-26 16:31:40] torben@php.net Yes, I should have said "defined as NULL" instead of "is NULL". You can define it as NULL but it will be silently converted to the empty string. ------------------------------------------------------------------------ [2009-08-26 16:26:32] thuejk at gmail dot com Ah, I misunderstood. Null is not a possible array index, hence my confusion. Array indices are always strings or ints. (as I found out when debugging a face of a float being silently truncated to int when used as an array index...) ------------------------------------------------------------------------ [2009-08-26 16:20:34] torben@php.net You're correct that key() does not return NULL if the array value is NULL, but that's not what I said; I said "array index", not "array value". That said, I must apologize as I was also incorrect: key() does not in fact return NULL if the array index is NULL; it returns the empty string. That's what I get for posting when I should have gone to bed instead. Re-opening. ------------------------------------------------------------------------ [2009-08-26 08:58:00] thuejk at gmail dot com >key() also returns NULL if the array index currently being examined >contains NULL, and therefore gives no useful information as to whether >the end of the array has been passed or not. And anyway, if theis is a case it is an even worse bug than my original report, since the manual states Return Values: Returns the index. It specifically does NOT say anything about returning null if the array value is null. ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/47330 -- Edit this bug report at http://bugs.php.net/?id=47330&edit=1