Doc #60900 [Opn->Csd]: Remove the warning in gettype()'s documentation
| From: | frozenfire@php.net | Date: | Sat, 28 Jan 2012 00:12:15 +0000 |
| Subject: | Doc #60900 [Opn->Csd]: Remove the warning in gettype()'s documentation | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-7879@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=60900&edit=1
ID: 60900
Updated by: frozenfire@php.net
Reported by: nicolas dot grekas+php at gmail dot com
Summary: Remove the warning in gettype()'s documentation
-Status: Open
+Status: Closed
Type: Documentation Problem
Package: Documentation problem
PHP Version: Irrelevant
-Assigned To:
+Assigned To: frozenfire
Block user comment: N
Private report: N
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.
Previous Comments:
------------------------------------------------------------------------
[2012-01-28 00:12:01] frozenfire@php.net
Automatic comment from SVN on behalf of frozenfire
Revision: http://svn.php.net/viewvc/?view=revision&revision=322892
Log: Removed big, obtrusive warning, and replaced it with a short note about using is_* functions
for type-checking. Closes bug #60900.
------------------------------------------------------------------------
[2012-01-27 10:18:12] nicolas dot grekas+php at gmail dot com
Description:
------------
The documentation page for gettype() contains a big warning saying
"the returned string may be subject to change in a future version".
See http://php.net/gettype
But since the release process RFC is now approved, shouldn't this waring be removed a
gettype()'s current behavior be marked as stable, for the shake of strict backward
compatibility ?
See https://wiki.php.net/rfc/releaseprocess
Also, the doc says that using is_*() functions is faster than using gettype() because of the string
comparison. But a switch(gettype($var)) is way faster than a if (is_*()) ... else if (is_*()) ...
Thus, this speed notice is misleading I think.
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=60900&edit=1