Doc #78104 [Opn]: Return section for readgzfile informs about @ operator
| From: | girgias@php.net | Date: | Tue, 04 Jun 2019 15:12:42 +0000 |
| Subject: | Doc #78104 [Opn]: Return section for readgzfile informs about @ operator | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-16701@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=78104&edit=1
ID: 78104
Updated by: girgias@php.net
Reported by: girgias@php.net
Summary: Return section for readgzfile informs about @
operator
Status: Open
Type: Documentation Problem
Package: Zlib related
PHP Version: Irrelevant
Block user comment: N
Private report: N
New Comment:
Huh, indeed it is mentioned in fopen, maybe @salathe could chime in as the Editor?
Will just need to figure out what kind of error readgzfile produces before being able to update its
doc page.
Previous Comments:
------------------------------------------------------------------------
[2019-06-04 14:58:11] daverandom@php.net
The information about the fact that the function may emit an error should be moved to an
Errors/Exceptions section (like e.g. https://www.php.net/manual/en/function.fopen.php)
The mention of the error suppression operator seems a little odd to me, however it is mentioned on
the fopen() page linked above so I'm not actually sure there.
------------------------------------------------------------------------
[2019-06-04 14:53:06] girgias@php.net
Description:
------------
---
From manual page: https://php.net/function.readgzfile
---
The Return value sections say this:
"If an error occurs, FALSE is returned and unless the function was called as @readgzfile, an
error message is printed."
Which seems odd to describe the behavior of the error suppression operator.
Should it be removed/rewritten?
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=78104&edit=1