note 10154 deleted from function.array-splice by jimw

For those of you who are not familiar with PERL or other languages that have Splice commands, this was not fully explained in the doc's explaination.. array_splice() will return the section of the array that was removed, if any. So for instance $a = array_shift($array); Will pop the first element out of array and place it in $a, so will list($a) = array_splice($array, 0, 1); And for my purposes, there are many times when I like to go list($a, $b) = array_splice($array, 0, 2); popping multiple values at once ;)