Doc #65355 [NEW]: Documented return values for DOMNode::hasChildNodes are incorrect
| From: | kyle at klowell dot com | Date: | Mon, 29 Jul 2013 18:28:52 +0000 |
| Subject: | Doc #65355 [NEW]: Documented return values for DOMNode::hasChildNodes are incorrect | ||
| Groups: | php.doc.bugs | ||
| Request: | Send a blank email to doc-bugs+get-10125@lists.php.net to get a copy of this message | ||
From: kyle at klowell dot com
Operating system:
PHP version: Irrelevant
Package: Documentation problem
Bug Type: Documentation Problem
Bug description:Documented return values for DOMNode::hasChildNodes are incorrect
Description:
------------
---
From manual page: http://www.php.net/domnode.haschildnodes#refsect1-
domnode.haschildnodes-returnvalues
---
Currently the page lists the following:
```
Return Values
Returns TRUE on success or FALSE on failure.
```
This is incorrect, since the method returns TRUE when the node has child
elements, and FALSE when it does not. FALSE may or may not be returned by
an
error state, but the developer is most likely looking for the empty state.
This should probably be changed to:
```
Return Values
Returns TRUE if the node has children or FALSE if not.
```
--
Edit bug report at https://bugs.php.net/bug.php?id=65355&edit=1
--
Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=65355&r=trysnapshot54
Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=65355&r=trysnapshot53
Try a snapshot (trunk): https://bugs.php.net/fix.php?id=65355&r=trysnapshottrunk
Fixed in SVN: https://bugs.php.net/fix.php?id=65355&r=fixed
Fixed in release: https://bugs.php.net/fix.php?id=65355&r=alreadyfixed
Need backtrace: https://bugs.php.net/fix.php?id=65355&r=needtrace
Need Reproduce Script: https://bugs.php.net/fix.php?id=65355&r=needscript
Try newer version: https://bugs.php.net/fix.php?id=65355&r=oldversion
Not developer issue: https://bugs.php.net/fix.php?id=65355&r=support
Expected behavior: https://bugs.php.net/fix.php?id=65355&r=notwrong
Not enough info: https://bugs.php.net/fix.php?id=65355&r=notenoughinfo
Submitted twice: https://bugs.php.net/fix.php?id=65355&r=submittedtwice
register_globals: https://bugs.php.net/fix.php?id=65355&r=globals
PHP 4 support discontinued: https://bugs.php.net/fix.php?id=65355&r=php4
Daylight Savings: https://bugs.php.net/fix.php?id=65355&r=dst
IIS Stability: https://bugs.php.net/fix.php?id=65355&r=isapi
Install GNU Sed: https://bugs.php.net/fix.php?id=65355&r=gnused
Floating point limitations: https://bugs.php.net/fix.php?id=65355&r=float
No Zend Extensions: https://bugs.php.net/fix.php?id=65355&r=nozend
MySQL Configuration Error: https://bugs.php.net/fix.php?id=65355&r=mysqlcfg