jeroen Fri Sep 14 19:14:49 2001 EDT
Modified files:
/phpdoc/en/functions array.xml
Log:
Clarify array_unique & array_diff comparisation.
FIXME: when exactly were these broken?
This should fix some docbugs
Index: phpdoc/en/functions/array.xml
diff -u phpdoc/en/functions/array.xml:1.92 phpdoc/en/functions/array.xml:1.93
--- phpdoc/en/functions/array.xml:1.92 Sun Sep 2 16:58:47 2001
+++ phpdoc/en/functions/array.xml Fri Sep 14 19:14:49 2001
@@ -1,5 +1,5 @@
<?xml encoding="iso-8859-1"?>
-<!-- $Revision: 1.92 $ -->
+<!-- $Revision: 1.93 $ -->
<reference id="ref.array">
<title>Array Functions</title>
<titleabbrev>Arrays</titleabbrev>
@@ -202,6 +202,20 @@
<literal>array ("blue");</literal>. Multiple occurences in
$array1 are all treated the same way.
</para>
+ <note>
+ <simpara>
+ Two elements are considered equal if and only if
+ <literal>(string) $elem1 === (string) $elem2</literal>. In words:
+ when the string representation is the same.
+ <!-- TODO: example of it... -->
+ </simpara>
+ </note>
+ <warning>
+ <simpara>
+ This was broken in PHP 4.0.4!
+ <!-- TODO: when exactly was this broken?... -->
+ </simpara>
+ </warning>
<para>
See also <function>array_intersect</function>.
</para>
@@ -1386,6 +1400,23 @@
keep the first key encountered for every value, and ignore all
following keys.
</para>
+ <note>
+ <simpara>
+ Two elements are considered equal if and only if
+ <literal>(string) $elem1 === (string) $elem2</literal>. In words:
+ when the string representation is the same.
+ <!-- TODO: example of it... -->
+ </simpara>
+ <simpara>
+ The first element will be used.
+ </simpara>
+ </note>
+ <warning>
+ <simpara>
+ This was broken in PHP 4.0.4!
+ <!-- TODO: when exactly was this broken?... -->
+ </simpara>
+ </warning>
<para>
<example>
<title><function>array_unique</function> example</title>
@@ -1404,26 +1435,21 @@
</example>
</para>
<para>
- Note that <function>array_unique</function> take into account
- value's type. This is usually of no matter, except when it
- comes to compare numbers, which can be of several types.
- This may lead to confusing results.
- </para>
- <para>
<example>
<title><function>array_unique</function> and types</title>
<programlisting role="php">
-$input = array (4,"3",3,"4",4,4);
+$input = array (4,"4","3",4,3,"3");
$result = array_unique ($input);
-print_r($result);
-// this will output :
-//Array
-//(
-// [0] => 3
-// [1] => 3
-// [2] => 4
-// [3] => 4
-//)
+var_dump($result);
+
+/* output:
+array(2) {
+ [0]=>
+ int(4)
+ [1]=>
+ string(1) "3"
+}
+*/
</programlisting>
</example>
</para>
