From 63f0c045f92e4199499013621745b4ebcbe8e83e Mon Sep 17 00:00:00 2001
From: Nikita Popov <nikic@php.net>
Date: Fri, 2 Mar 2012 00:34:47 +0000
Subject: [PATCH] Add array dereferencing to array docs

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@323755 c90b9560-bf6c-de11-be94-00142212c4b1
---
 language/types/array.xml | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/language/types/array.xml b/language/types/array.xml
index 2e25d9fb7e..f80b6019d6 100644
--- a/language/types/array.xml
+++ b/language/types/array.xml
@@ -296,6 +296,34 @@ string(3) "foo"
     </screen>
    </example>
    
+   <para>
+    As of PHP 5.4 it is possible to array dereference the result of a function or method
+    call directly. Before it was only possible using a temporary variable.
+   </para>
+   
+   <example>
+    <title>Array dereferencing</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+function getArray() {
+    return array(1, 2, 3);
+}
+
+// on PHP 5.4
+$secondElement = getArray()[1];
+
+// previously
+$tmp = getArray();
+$secondElement = $tmp[1];
+
+// or
+list(, $secondElement) = getArray();
+?>
+]]>
+    </programlisting>
+   </example>
+   
    <note>
     <para>
       Attempting to access an array key which has not been defined is