Doc #74024 [Com]: Nullable types aren't documented, except in the migration guide
| From: | mat at zerifas dot com | Date: | Sat, 07 Oct 2017 12:56:39 +0000 |
| Subject: | Doc #74024 [Com]: Nullable types aren't documented, except in the migration guide | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-15043@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=74024&edit=1
ID: 74024
Comment by: mat at zerifas dot com
Reported by: mat at zerifas dot com
Summary: Nullable types aren't documented, except in the
migration guide
Status: Verified
Type: Documentation Problem
Package: Scripting Engine problem
Operating System: N/A
PHP Version: 7.1.1
Block user comment: N
Private report: N
New Comment:
-Package: Documentation problem
+Package: Scripting Engine problem
This seems an odd choice â what's the reasoning?
Previous Comments:
------------------------------------------------------------------------
[2017-10-05 10:24:09] requinix@php.net
*bug #75312
------------------------------------------------------------------------
[2017-10-05 10:23:08] requinix@php.net
Related To: Bug #74024
------------------------------------------------------------------------
[2017-10-05 10:23:07] requinix@php.net
This is particularly important for the arguments page as a nullable type is the only way to get a
null value into a typed variadic list - see doc bug #74024.
------------------------------------------------------------------------
[2017-01-31 15:55:10] mat at zerifas dot com
Description:
------------
First I looked here php.net/manual/en/language.oop5.typehinting.php which links to here
php.net/manual/en/functions.arguments.php#functions.arguments.type-declaration
The only mention of nullable is using the old syntax:
php.net/manual/en/functions.arguments.php#example-140
There's nothing on the return types page either:
php.net/manual/en/functions.returning-values.php
Finally, I looked at the Types page, but nothing there either php.net/manual/en/language.types.php
I eventually found what I was looking for in the new features part of the migration guide, but feel
it should be in the main docs too: php.net/manual/en/migration71.new-features.php
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=74024&edit=1