php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #61034 Return values incorrectly specified.
Submitted: 2012-02-09 23:54 UTC Modified: 2013-10-23 07:54 UTC
From: dewi at dewimorgan dot com Assigned: krakjoe (profile)
Status: Closed Package: Documentation problem
PHP Version: 5.3.10 OS: Linux
Private report: No CVE-ID: None
View Developer Edit
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: dewi at dewimorgan dot com
New email:
PHP Version: OS:

 

 [2012-02-09 23:54 UTC] dewi at dewimorgan dot com 
Description:
------------
---
From manual page: http://www.php.net/function.feof#refsect1-function.feof-returnvalues
---
Documentation should specify that it also returns false on an invalid filehandle, even though that is an "Error". (It does mention this below, in a warning section, but that's different).

This insane behavior is not considered to be a bug, per:
https://bugs.php.net/bug.php?id=34652

Therefore, it should at least be documented properly, so that people checking out the return values aren't reading a complete lie.


Documentation should also specify that it returns NULL in older PHP versions, if no arg was specified. (Reproduced in 5.2.13, not in 5.3.3).

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2013-10-23 07:54 UTC] krakjoe@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: krakjoe
 [2013-10-23 07:54 UTC] krakjoe@php.net 
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.

This was fixed previously, warning and example are provided, so closing the bug.
 
PHP Copyright © 2001-2026 The PHP Group
All rights reserved. 		Last updated: Wed Oct 07 11:00:02 2026 UTC