cvs: phpdoc /en/functions array.xml

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>