#23249 [NEW]: contradiction in manual
| From: | prof_moriart at veryfast dot biz | Date: | Thu, 17 Apr 2003 00:02:19 +0000 |
| Subject: | #23249 [NEW]: contradiction in manual | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969352623@lists.php.net to get a copy of this message | ||
From: prof_moriart at veryfast dot biz
Operating system: win 98
PHP version: 4.3.0
PHP Bug Type: Documentation problem
Bug description: contradiction in manual
I believe i've found a contradiction in the manual (this can be found in
the online manual).
This is what it says in the documentation for the require function:
"require() and include() are identical in every way except how they handle
failure."
And Now quoting from:
Appendix b: Migrating from PHP 3 to PHP 4
Sub-section: Parser behavior
"Another thing no longer possible, though rarely seen in PHP 3 code is
returning values from a required file. Returning a value from an included
file is still possible."
There'a fair chance i'm mis-understanding the meaning of 'required' and
'included' files, as refered to in the 'parser behaviour' quote, however
what appears to be the case is that it's saying that it's possible to use
the
return
feature from included files, but not from require files.
After a small amount of testing i can see that both the 'require' and
'include' functions are able to return things to a calling script.
So the 'parser behaviour' section is either inacurate, or unclear.
--
Edit bug report at http://bugs.php.net/?id=23249&edit=1
--
Try a CVS snapshot: http://bugs.php.net/fix.php?id=23249&r=trysnapshot
Fixed in CVS: http://bugs.php.net/fix.php?id=23249&r=fixedcvs
Fixed in release: http://bugs.php.net/fix.php?id=23249&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=23249&r=needtrace
Try newer version: http://bugs.php.net/fix.php?id=23249&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=23249&r=support
Expected behavior: http://bugs.php.net/fix.php?id=23249&r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=23249&r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=23249&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=23249&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=23249&r=php3
Daylight Savings: http://bugs.php.net/fix.php?id=23249&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=23249&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=23249&r=gnused