From 233b7b98035d7f5e018fa61ce691f185d8731f8f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gustavo=20Andr=C3=A9=20dos=20Santos=20Lopes?= Date: Fri, 11 May 2012 20:42:17 +0000 Subject: [PATCH] - Updated docs for call_user_func_array() in light of PHP 5.4 developments. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@325660 c90b9560-bf6c-de11-be94-00142212c4b1 --- .../functions/call-user-func-array.xml | 22 +++++++++++-------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/reference/funchand/functions/call-user-func-array.xml b/reference/funchand/functions/call-user-func-array.xml index 83b9f350ad..b66ff09009 100644 --- a/reference/funchand/functions/call-user-func-array.xml +++ b/reference/funchand/functions/call-user-func-array.xml @@ -172,16 +172,20 @@ int(8) &reftitle.notes; - Referenced variables in param_arr are passed to the - function by reference, regardless of whether the function expects the - respective parameter to be passed by reference. This form of call-time - pass by reference does not emit a deprecation notice, but it is nonetheless - deprecated, and will most likely be removed in the next version of PHP. + Before PHP 5.4, referenced variables in param_arr + are passed to the function by reference, regardless of whether the function + expects the respective parameter to be passed by reference. This form of + call-time pass by reference does not emit a deprecation notice, but it is + nonetheless deprecated, and has been removied in PHP 5.4. Furthermore, this does not apply to internal functions, for which - the function signature is honored. Passing by value when the function expects - a parameter by reference results in a warning and having - call_user_func return &false; (does not apply if the - passed value has a reference count = 1). + the function signature is honored. Passing by value when the function + expects a parameter by reference results in a warning and having + call_user_func return &false; (there is, however, an + exception for passed values with reference count = 1, such as in literals, + as these can be turned into references without ill effects — but also + without writes to that value having any effect —; do not rely + in this behavior, though, as the reference count is an implementation + detail and the soundness of this behavior is questionable). ¬e.func-callback-exceptions;