#32785 [Asn->Csd]: negative limit doesn't work in explode()
| From: | vrana@php.net | Date: | Thu, 21 Apr 2005 10:02:16 +0000 |
| Subject: | #32785 [Asn->Csd]: negative limit doesn't work in explode() | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969367942@lists.php.net to get a copy of this message | ||
ID: 32785
Updated by: vrana@php.net
Reported By: proton@php.net
-Status: Assigned
+Status: Closed
Bug Type: Documentation problem
Operating System: Debian GNU/Linux
PHP Version: 4.3.10
Assigned To: nlopess
New Comment:
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.
Warning added.
I agree with sniper that documenting not-yet-existing features is work
for a work.
Previous Comments:
------------------------------------------------------------------------
[2005-04-21 01:31:37] philip@php.net
The documentation does mention this:
If the limit parameter is negative, all components except the last
limit are returned. This feature was added in PHP 5.1.0.
Sure the 5.1+ example could have a comment specifying this version
requirement but no need to get all crazy! :) When the explode() docs
get converted to the new doc style the change will be much clearer as
each function now has a CHANGELOG.
We document future versions too, it's the way it is. A more appropriate
question is "why not" but anyway it's so people using the manual can
handle/know future changes/additions, and that we don't forget to
document these changes. See also:
http://php.net/manual/en/about.phpversions.php
------------------------------------------------------------------------
[2005-04-21 00:49:40] sniper@php.net
Assigned to Nuno: Thanks for wasting our time.
------------------------------------------------------------------------
[2005-04-21 00:45:31] sniper@php.net
Also: Why the hell do you doc people put something like this in the
manual WHEN THERE IS NO SUCH RELEASE ever made with such
feature(s)???!!!
------------------------------------------------------------------------
[2005-04-21 00:43:54] sniper@php.net
Reclassified as documentation problem: The examples should have BIG
note about the being like that only with PHP 5.1!!!!
------------------------------------------------------------------------
[2005-04-21 00:03:55] proton@php.net
It does the same on current PHP-version also.
nandus% uname -a
FreeBSD nandus.mikrolahti.fi 5.4-STABLE FreeBSD 5.4-STABLE #0: Tue Apr
19 23:27:27 EEST 2005
root@nandus.mikrolahti.fi:/usr/obj/usr/src/sys/NANDUS i386
nandus% cat explode.php
<?php
$str = 'one|two|three|four';
// positive limit
print_r(explode('|', $str, 2));
// negative limit
print_r(explode('|', $str, -1));
?>
nandus% php explode.php
Content-type: text/html
X-Powered-By: PHP/5.0.4
Array
(
[0] => one
[1] => two|three|four
)
Array
(
[0] => one
[1] => two
[2] => three
[3] => four
)
------------------------------------------------------------------------
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/32785
--
Edit this bug report at http://bugs.php.net/?id=32785&edit=1