This is a docu problem, fails to mention that the that the function emits a warning

BTW.. it does return NULL, there is no problem with that.

If you use the array_pop command in a loop like this:

<?
$Objects[] = 'foo';
$Objects[] = 'bar';
$Objects[] = 'foobar';

while($Object = array_pop($Objects)){
	# ...
}
?>

It wouldn't emit a warning message. The difference between an "empty array" and an array which doesn't exist is so minimal. In my opinion there is no good reason why the first case shouldn't emit a warning while the second does.

But yes, it's true. The loop actually stops because when the warning is emited NULL is beeing returned. It shouldn't be that php usually is set to generate a warning message and the user has to throw away the warning message again (@array_pop).

It should bring a warning message if the parameter is a variable but not an array and not an unset array (like the $DoesntExist parameter).

>It should bring a warning message if the parameter is a variable but >not
>an array and not an unset array (like the $DoesntExist parameter).

No, if $DoesntExist is not declared then it is NULL, PHP does NOT enforce variable declaration. and array_pop(NULL) obviously has to emit a warning because NULL ==! array  ;-)

[quote]

If you use the array_pop command in a loop like this:

<?
$Objects[] = 'foo';
$Objects[] = 'bar';
$Objects[] = 'foobar';

while($Object = array_pop($Objects)){
	# ...
}
?>
[quote]

of course that code wont emit a warning at all, and that is expected.

when you do

$Objects[] = 'foo';

$Objects is being initialized and one element, with key '0' and value 'foo' is added, nothing surprising at all...

This is only a documentation problem

I see. If I am right the each() function does also emit a warning message if you pass the "$DoesntExist" as the parameter. So even if I am not happy with that it is at least uniform in php.

This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation
better.