Doc #51177 [NEW]: Iterator::key() return value should not say "integer 0 on failure"

From: Operating system: n/a PHP version: 5.3.2RC3 Package: Documentation problem} Bug Type: Documentation Problem Bug description:Iterator::key() return value should not say "integer 0 on failure" Description: ------------ The documentation for the return value of Iterator::key() states that it will be integer 0 on failure. 1. The docs also state that an E_WARNING will be issued. This is probably the only correct response. 2. Integer 0 is a valid key for an iterator so it should not be used as an error signal value. Test script: --------------- <?php $x = array(); $x[] = 'zero'; $x[] = 'one'; $obj = new ArrayObject($x); $iter = $obj->getIterator(); echo $iter->key() . PHP_EOL; echo $iter->current() . PHP_EOL; ?> Expected result: ---------------- 0 zero Actual result: -------------- 0 zero [Correct output, but it doesn't match the docs since key() is not returning an error but it is returning 0.] -- Edit bug report at http://bugs.php.net/bug.php?id=51177&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=51177&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=51177&r=trysnapshot53 Try a snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=51177&r=trysnapshot60 Fixed in SVN: http://bugs.php.net/fix.php?id=51177&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=51177&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=51177&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=51177&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=51177&r=needscript Try newer version: http://bugs.php.net/fix.php?id=51177&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=51177&r=support Expected behavior: http://bugs.php.net/fix.php?id=51177&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=51177&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=51177&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=51177&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=51177&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=51177&r=dst IIS Stability: http://bugs.php.net/fix.php?id=51177&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=51177&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=51177&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=51177&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=51177&r=mysqlcfg