Doc #51453 [NEW]: Mentioning NULL as special value for replacement in array_splice()

From: Operating system: PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:Mentioning NULL as special value for replacement in array_splice() Description: ------------ Documentation of array_splice() should mention NULL as a special value for replacement (just as objects) as typecasting NULL into an array results in an empty array. If you want the splicing to create a new element with value NULL you have to use "array(NULL)" instead of NULL. You should expect this if you read the explanation carefully (and if you know about typecasting NULL as array), but just as objects are considered as a special case for replacement, NULL should be too. The explanation of replacement better should read: "If replacement is just one element it is not necessary to put array() around it, unless the element is an array itself, an object or NULL." And the note better should be: "If replacement is not an array, it will be typecast to one (i.e. (array) $parameter). This may result in unexpected behavior when using an object or NULL replacement." jmtc -- Edit bug report at http://bugs.php.net/bug.php?id=51453&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=51453&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=51453&r=trysnapshot53 Try a snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=51453&r=trysnapshot60 Fixed in SVN: http://bugs.php.net/fix.php?id=51453&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=51453&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=51453&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=51453&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=51453&r=needscript Try newer version: http://bugs.php.net/fix.php?id=51453&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=51453&r=support Expected behavior: http://bugs.php.net/fix.php?id=51453&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=51453&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=51453&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=51453&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=51453&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=51453&r=dst IIS Stability: http://bugs.php.net/fix.php?id=51453&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=51453&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=51453&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=51453&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=51453&r=mysqlcfg