dams Wed May 16 01:36:09 2001 EDT
Modified files:
/phpdoc/en/functions array.xml
Log:
Added Thomas's contribution, plus more details on array_flip.
Index: phpdoc/en/functions/array.xml
diff -u phpdoc/en/functions/array.xml:1.67 phpdoc/en/functions/array.xml:1.68
--- phpdoc/en/functions/array.xml:1.67 Mon Apr 23 02:03:32 2001
+++ phpdoc/en/functions/array.xml Wed May 16 01:36:08 2001
@@ -270,9 +270,22 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>Array_flip</function> returns an array in flip order.
+ <function>array_flip</function> returns an array in flip order,
+ i.e. keys from <parameter>trans</parameter> become values and
+ <parameter>trans</parameter>'s values become keys.
+ Note that <function>array_flip</function> works only with string
+ and integer values, and it will display an alert if it detects
+ invalid key or value (array, double, object, boolean).
</para>
<para>
+ If a value has several occurences, the latest key will be
+ used as its values, and all others will be lost.
+ </para>
+ <para>
+ <function>array_flip</function> returns <literal>FALSE</literal>
+ if it fails.
+ </para>
+ <para>
<example>
<title><function>Array_flip</function> example</title>
<programlisting role="php">
@@ -281,6 +294,16 @@
</programlisting>
</example>
</para>
+ <para>
+ <example>
+ <title><function>Array_flip</function> example : collision</title>
+ <programlisting role="php">
+$trans = array ("a" => 1, "b" => 1, "c" => 2);
+$trans = array_flip ($trans);
+// now $trans is : array(1 => "b", 2 => "c");
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
@@ -1011,9 +1034,9 @@
</example>
</para>
<para>
- This makes <varname>$result</varname> have <literal>array
- (array ("green", "red"), 4.0, "php")</literal>. But
- <varname>$result2[0]</varname> is still
+ This makes both <varname>$result</varname> and <varname>$result_keyed</varname>
+ be <literal>array(array ("green", "red"), 4.0, "php")</literal>. But
+ <varname>$result_keyed[0]</varname> is still
<literal>"php"</literal>.
</para>
<note>
