Doc #78104 [Com]: Return section for readgzfile informs about @ operator
| From: | daverandom@php.net | Date: | Tue, 04 Jun 2019 14:58:11 +0000 |
| Subject: | Doc #78104 [Com]: Return section for readgzfile informs about @ operator | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-16699@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
Comment by: daverandom@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:
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.
Previous Comments:
------------------------------------------------------------------------
[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