php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #78258 stream_bucket_new does not have documentation
Submitted: 2019-07-06 08:18 UTC Modified: 2019-07-09 13:05 UTC
From: carlosv775 at gmail dot com Assigned:
Status: Verified Package: Streams related
PHP Version: Irrelevant OS: Irrelevant
Private report: No CVE-ID: None
View Add Comment Developer Edit
Anyone can comment on a bug. Have a simpler test case? Does it work for you on a different platform? Let us know!
Just going to say 'Me too!'? Don't clutter the database with that please — but make sure to vote on the bug!
Your email address:
MUST BE VALID
Solve the problem:
36 - 18 = ?
Subscribe to this entry?

 
 [2019-07-06 08:18 UTC] carlosv775 at gmail dot com
Description:
------------
---
From manual page: https://php.net/function.stream-bucket-new
---
This page returns FALSE if something goes wrong, for instance, if the stream isn't available. At least the function's signature should be changed to stream_bucket_new ( resource $stream , string $buffer ) : object|bool if no documentation will be written for it.


Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2019-07-06 10:53 UTC] requinix@php.net
-Summary: Besides not having a documentation, stream_bucket_new signature is wrong. +Summary: stream_bucket_new does not have documentation -Package: Documentation problem +Package: Streams related
 [2019-07-06 10:53 UTC] requinix@php.net
Returning false or null in case of error is common, and by convention the return value documented with the signature does not include that. Rather, such behavior gets documented in the Return Values section.
 [2019-07-09 13:05 UTC] cmb@php.net
-Status: Open +Status: Verified
 
PHP Copyright © 2001-2019 The PHP Group
All rights reserved.
Last updated: Sun Sep 22 18:01:26 2019 UTC