cvs: phpdoc-nl /reference/array/functions in-array.xml key.xml krsort.xml ksort.xml list.xml natcasesort.xml natsort.xml next.xml prev.xml range.xml reset.xml rsort.xml shuffle.xml sort.xml uasort.xml uksort.xml usort.xml
[email protected] ("Janwillem Borleffs")
| Newsgroups | php.doc.nl |
|---|---|
| Message-ID | <cvsjanwb1143394098@cvsserver> |
janwb Sun Mar 26 17:28:18 2006 UTC
Modified files:
/phpdoc-nl/reference/array/functions in-array.xml key.xml
krsort.xml ksort.xml list.xml
natcasesort.xml natsort.xml
next.xml prev.xml range.xml
reset.xml rsort.xml
shuffle.xml sort.xml
uasort.xml uksort.xml
usort.xml
Log:
initial translation
janwb-20060326172818.txt
(text/plain, 54 KB)
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/in-array.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/in-array.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/in-array.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/in-array.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,150 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.12 Maintainer: janwb Status: ready -->
+ <refentry id="function.in-array">
+ <refnamediv>
+ <refname>in_array</refname>
+ <refpurpose>Controleer of een waarde voorkomt in een array</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>in_array</methodname>
+ <methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
+ <methodparam><type>array</type><parameter>haystack</parameter></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>strict</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Doorzoekt <parameter>haystack</parameter> voor
+ <parameter>needle</parameter> en geeft &true;
+ terug wanneer deze is gevonden en anders &false;.
+ </para>
+ <para>
+ Wanneer de derde <parameter>strict</parameter> parameter &true; is,
+ controleert <function>in_array</function> ook de
+ <link linkend="language.types">types</link> van de
+ <parameter>needle</parameter> in de <parameter>haystack</parameter>.
+ </para>
+ <note>
+ <para>
+ Wanneer <parameter>needle</parameter> een string is, dan wordt de
+ vergelijking hoofdlettergevoelig uitgevoerd.
+ </para>
+ </note>
+ <note>
+ <para>
+ In PHP versies lager dan 4.2.0 kon <parameter>needle</parameter> geen
+ array zijn.
+ </para>
+ </note>
+ <para>
+ <example>
+ <title><function>in_array</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$os = array("Mac", "NT", "Irix", "Linux");
+if (in_array("Irix", $os)) {
+ echo "Got Irix";
+}
+if (in_array("mac", $os)) {
+ echo "Got mac";
+}
+?>
+]]>
+ </programlisting>
+ <para>
+ De tweede conditie faalt omdat <function>in_array</function>
+ hoofdlettergevoelig is, dus het bovenstaande script zal weergeven:
+ </para>
+ <screen>
+<![CDATA[
+Got Irix
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title><function>in_array</function> met <parameter>strict</parameter> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$a = array('1.10', 12.4, 1.13);
+
+if (in_array('12.4', $a, true)) {
+ echo "'12.4' found with strict check\n";
+}
+
+if (in_array(1.13, $a, true)) {
+ echo "1.13 found with strict check\n";
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+1.13 found with strict check
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title><function>in_array</function> met een array als <parameter>needle</parameter></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$a = array(array('p', 'h'), array('p', 'r'), 'o');
+
+if (in_array(array('p', 'h'), $a)) {
+ echo "'ph' was found\n";
+}
+
+if (in_array(array('f', 'i'), $a)) {
+ echo "'fi' was found\n";
+}
+
+if (in_array('o', $a)) {
+ echo "'o' was found\n";
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+ 'ph' was found
+ 'o' was found
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ Zie ook <function>array_search</function>,
+ <function>array_key_exists</function> en
+ <function>isset</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/key.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/key.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/key.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/key.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.9 Maintainer: janwb Status: ready -->
+ <refentry id="function.key">
+ <refnamediv>
+ <refname>key</refname>
+ <refpurpose>Geeft een key terug van een associatieve array</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>mixed</type><methodname>key</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>key</function> geeft het index element van de
+ huidige array positie.
+ </para>
+ <para>
+ <example>
+ <title><function>key</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$array = array(
+ 'fruit1' => 'apple',
+ 'fruit2' => 'orange',
+ 'fruit3' => 'grape',
+ 'fruit4' => 'apple',
+ 'fruit5' => 'apple');
+
+// de volgende loop geeft alle associatieve
+// array keys weer waarvan de waarde gelijk
+// is aan "apple"
+while ($fruit_name = current($array)) {
+ if ($fruit_name == 'apple') {
+ echo key($array).'<br />';
+ }
+ next($array);
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Zie ook <function>current</function> en <function>next</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/krsort.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/krsort.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/krsort.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/krsort.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.12 Maintainer: janwb Status: ready -->
+ <refentry id="function.krsort">
+ <refnamediv>
+ <refname>krsort</refname>
+ <refpurpose>Sorteer een array via de keys in omgekeerde volgorde</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>krsort</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sorteert een array via de keys in omgekeerde volgorde, waarbij de verhouding
+ tussen key en data behouden blijft. Dit is voornamelijk nuttig bij
+ associatieve arrays.
+ </para>
+ <para>
+ &return.success;
+ </para>
+ <para>
+ <example>
+ <title><function>krsort</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$fruits = array("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
+krsort($fruits);
+foreach ($fruits as $key => $val) {
+ echo "$key = $val\n";
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+d = lemon
+c = apple
+b = banana
+a = orange
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ Je kunt de manier van sorteren wijzigen door gebruik te
+ maken van de optionele <parameter>sort_flags</parameter>
+ parameter. Voor details, zie <function>sort</function>.
+ </para>
+ <simpara>
+ Zie ook <function>asort</function>, <function>arsort</function>,
+ <function>ksort</function>, <function>sort</function>,
+ <function>natsort</function> en <function>rsort</function>.
+ </simpara>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/ksort.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/ksort.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/ksort.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/ksort.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.12 Maintainer: janwb Status: ready -->
+ <refentry id="function.ksort">
+ <refnamediv>
+ <refname>ksort</refname>
+ <refpurpose>Sorteer een array via de keys</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>ksort</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sorteert een array via de keys, waarbij de verhouding tussen key en
+ data behouden blijft. Dit is voornamelijk nuttig bij
+ associatieve arrays.
+ </para>
+ <para>
+ &return.success;
+ </para>
+ <para>
+ <example>
+ <title><function>ksort</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$fruits = array("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
+ksort($fruits);
+foreach ($fruits as $key => $val) {
+ echo "$key = $val\n";
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+a = orange
+b = banana
+c = apple
+d = lemon
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ Je kunt de manier van sorteren wijzigen door gebruik te
+ maken van de optionele <parameter>sort_flags</parameter>
+ parameter. Voor details, zie <function>sort</function>.
+ </para>
+ <simpara>
+ Zie ook <function>asort</function>, <function>arsort</function>,
+ <function>krsort</function>, <function>uksort</function>,
+ <function>sort</function>, <function>natsort</function> en
+ <function>rsort</function>.
+ </simpara>
+ <note>
+ <para>
+ De tweede parameter is beschikbaar vanaf PHP 4.
+ </para>
+ </note>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/list.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/list.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/list.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/list.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,154 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.14 Maintainer: janwb Status: ready -->
+ <refentry id="function.list">
+ <refnamediv>
+ <refname>list</refname>
+ <refpurpose>
+ Wijs variabelen toe alsof zij arrays zijn
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>void</type><methodname>list</methodname>
+ <methodparam><type>mixed</type><parameter>varname</parameter></methodparam>
+ <methodparam rep="repeat"><type>mixed</type><parameter>...</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Net als <function>array</function> is dit niet echt een functie,
+ maar een language construct. <function>list</function> wordt gebruikt
+ voor het toewijzen van een lijst van variabelen in een enkele handeling.
+ </para>
+ <note>
+ <para>
+ <function>list</function> werkt alleen op numerieke arrays en neemt
+ aan dat numerieke indices beginnen bij 0.
+ </para>
+ </note>
+ <para>
+ <example>
+ <title><function>list</function> voorbeelden</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+$info = array('coffee', 'brown', 'caffeine');
+
+// Wijs alle variabelen toe
+list($drink, $color, $power) = $info;
+echo "$drink is $color and $power makes it special.\n";
+
+// Wijs enkele variabelen toe
+list($drink, , $power) = $info;
+echo "$drink has $power.\n";
+
+// Wijs alleen de derde variabele toe
+list( , , $power) = $info;
+echo "I need $power!\n";
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Een gebruiksvoorbeeld van <function>list</function></title>
+ <programlisting role="php">
+<![CDATA[
+<table>
+ <tr>
+ <th>Employee name</th>
+ <th>Salary</th>
+ </tr>
+
+<?php
+
+$result = mysql_query("SELECT id, name, salary FROM employees", $conn);
+while (list($id, $name, $salary) = mysql_fetch_row($result)) {
+ echo " <tr>\n" .
+ " <td><a href=\"info.php?id=$id\">$name</a></td>\n" .
+ " <td>$salary</td>\n" .
+ " </tr>\n";
+}
+
+?>
+
+</table>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <warning>
+ <para>
+ <function>list</function> wijst de waarden toe beginnende bij de
+ meest rechtse parameter. Wanneer je normale variabelen gebruikt, hoef
+ je hier geen rekening mee te houden. Echter, wanneer je arrays gebruikt
+ met indices, dan zou je gewoonlijk verwachten dat de volgorde van de
+ indices in de array gelijk is aan de volgorde waarin je het beschreef
+ in <function>list</function> van links naar rechts, wat niet het geval
+ is. De toewijzing gebeurt in omgekeerde volgorde.
+ </para>
+ </warning>
+ <para>
+ <example>
+ <title><function>list</function> gebruiken met array indices</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+$info = array('coffee', 'brown', 'caffeine');
+
+list($a[0], $a[1], $a[2]) = $info;
+
+var_dump($a);
+
+?>
+]]>
+ </programlisting>
+ <para>
+ Geeft het volgende resultaat (let op de volgorde van de elementen in
+ vergelijking tot de volgorde waarin zij waren geschreven in de
+ <function>list</function> syntax):
+ </para>
+ <screen>
+<![CDATA[
+array(3) {
+ [2]=>
+ string(8) "caffeine"
+ [1]=>
+ string(5) "brown"
+ [0]=>
+ string(6) "coffee"
+}
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ Zie ook <function>each</function>, <function>array</function>
+ en <function>extract</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/natcasesort.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/natcasesort.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/natcasesort.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/natcasesort.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.9 Maintainer: janwb Status: ready -->
+ <refentry id="function.natcasesort">
+ <refnamediv>
+ <refname>natcasesort</refname>
+ <refpurpose>
+ Sorteer een array gebruikmakend van een hoofdletterongevoelig "natural order" algoritme
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>natcasesort</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Deze functie implementeert een sorteer algoritme dat alfanumerieke
+ strings sorteert zoals een mens dat zou doen, terwijl de key/waarde
+ associatie behouden blijft. Dit wordt omschreven als "natural ordering".
+ </para>
+ <para>
+ &return.success;
+ </para>
+ <para>
+ <function>natcasesort</function> is een hoofdletterongevoelige
+ versie van <function>natsort</function>.
+ </para>
+ <para>
+ <example>
+ <title><function>natcasesort</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$array1 = $array2 = array('IMG0.png', 'img12.png', 'img10.png', 'img2.png', 'img1.png', 'IMG3.png');
+
+sort($array1);
+echo "Standard sorting\n";
+print_r($array1);
+
+natcasesort($array2);
+echo "\nNatural order sorting (case-insensitive)\n";
+print_r($array2);
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+Standaard sortering
+Array
+(
+ [0] => IMG0.png
+ [1] => IMG3.png
+ [2] => img1.png
+ [3] => img10.png
+ [4] => img12.png
+ [5] => img2.png
+)
+
+Natural order sortering (hoofdletterongevoelig)
+Array
+(
+ [0] => IMG0.png
+ [4] => img1.png
+ [3] => img2.png
+ [5] => IMG3.png
+ [2] => img10.png
+ [1] => img12.png
+)
+]]>
+ </screen>
+ <para>
+ Voor meer informatie, zie: Martin Pool's <ulink
+ url="&url.strnatcmp;">Natural Order String Comparison</ulink>
+ pagina.
+ </para>
+ </example>
+ </para>
+ <para>
+ Zie ook <function>sort</function>,
+ <function>natsort</function>,
+ <function>strnatcmp</function> en
+ <function>strnatcasecmp</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/natsort.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/natsort.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/natsort.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/natsort.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.13 Maintainer: janwb Status: ready -->
+ <refentry id="function.natsort">
+ <refnamediv>
+ <refname>natsort</refname>
+ <refpurpose>
+ Sorteer een array gebruikmakend van een "natural order" algoritme
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>natsort</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Deze functie implementeert een sorteer algoritme dat alfanumerieke
+ strings sorteert zoals een mens dat zou doen, terwijl de key/waarde
+ associatie behouden blijft. Dit wordt omschreven als "natural ordering".
+ Een voorbeeld van het verschil tussen dit algoritme en de reguliere
+ computer string sorteer algoritmes (gebruikt in <function>sort</function>)
+ wordt hieronder getoond:
+ </para>
+ <para>
+ &return.success;
+ </para>
+ <para>
+ <example>
+ <title><function>natsort</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$array1 = $array2 = array("img12.png", "img10.png", "img2.png", "img1.png");
+
+sort($array1);
+echo "Standard sorting\n";
+print_r($array1);
+
+natsort($array2);
+echo "\nNatural order sorting\n";
+print_r($array2);
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+Standard sortering
+Array
+(
+ [0] => img1.png
+ [1] => img10.png
+ [2] => img12.png
+ [3] => img2.png
+)
+
+Natural order sortering
+Array
+(
+ [3] => img1.png
+ [2] => img2.png
+ [1] => img10.png
+ [0] => img12.png
+)
+]]>
+ </screen>
+ <para>
+ Voor meer informatie, zie: Martin Pool's <ulink
+ url="&url.strnatcmp;">Natural Order String Comparison</ulink>
+ pagina.
+ </para>
+ </example>
+ </para>
+ <para>
+ Zie ook <function>natcasesort</function>,
+ <function>strnatcmp</function> en
+ <function>strnatcasecmp</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/next.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/next.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/next.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/next.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.7 Maintainer: janwb Status: ready -->
+ <refentry id="function.next">
+ <refnamediv>
+ <refname>next</refname>
+ <refpurpose>
+ Verplaats de interne array pointer van een array voorwaarts
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>mixed</type><methodname>next</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Geeft een waarde terug uit een array van de volgende positie die
+ wordt aangewezen door de interne array pointer of &false; wanneer
+ er niet meer elementen zijn.
+ </para>
+ <para>
+ <function>next</function> werkt als
+ <function>current</function>, met het volgende verschil. Het
+ verplaatst de interne array pointer een positie voorwaarts voordat
+ de waarde van het element wordt teruggegeven. Dit betekent dat de waarde
+ van het volgende element wordt teruggegeven en dat de interne array pointer
+ een positie voorwaarts wordt verplaatst. Wanneer dit resulteert in
+ het verplaatsen van de pointer voorbij het laatste element van de
+ array, dan zal <function>next</function> &false; teruggeven.
+ <warning>
+ <para>
+ Wanneer de array lege elementen bevat of elementen met 0 als de key
+ waarde, dan zal de functie ook voor deze elementen &false; teruggeven.
+ Om een array die mogelijk lege elementen of elementen met 0 als key
+ waarde bevat op de juiste manier te doorlopen, zie de
+ <function>each</function> functie.
+ </para>
+ </warning>
+ </para>
+ <para>
+ <example>
+ <title>Gebruiksvoorbeelden van <function>next</function> en vergelijkbare functies</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$transport = array('foot', 'bike', 'car', 'plane');
+$mode = current($transport); // $mode = 'foot';
+$mode = next($transport); // $mode = 'bike';
+$mode = next($transport); // $mode = 'car';
+$mode = prev($transport); // $mode = 'bike';
+$mode = end($transport); // $mode = 'plane';
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Zie ook
+ <function>current</function>, <function>end</function>,
+ <function>prev</function> en <function>reset</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/prev.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/prev.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/prev.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/prev.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.7 Maintainer: janwb Status: ready -->
+ <refentry id="function.prev">
+ <refnamediv>
+ <refname>prev</refname>
+ <refpurpose>Verplaats de interne array pointer naar achteren</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>mixed</type><methodname>prev</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Geeft de array waarde uit de voorgaande positie die wordt aangewezen door
+ de interne array pointer of &false; wanneer er niet meer elementen zijn.
+ <warning>
+ <para>
+ Wanneer de array lege elementen bevat, dan zal de functie ook voor
+ deze elementen &false; teruggeven. Om een array die mogelijk lege
+ elementen bevat op de juiste manier te doorlopen, zie de
+ <function>each</function> functie.
+ </para>
+ </warning>
+ </para>
+ <para>
+ <function>prev</function> werkt als
+ <function>next</function>, behalve dat de interne array pointer
+ een positie naar achteren en niet naar voren wordt verplaatst.
+ </para>
+ <para>
+ <example>
+ <title>Gebruiksvoorbeeld van <function>prev</function> en vergelijkbare functies</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$transport = array('foot', 'bike', 'car', 'plane');
+$mode = current($transport); // $mode = 'foot';
+$mode = next($transport); // $mode = 'bike';
+$mode = next($transport); // $mode = 'car';
+$mode = prev($transport); // $mode = 'bike';
+$mode = end($transport); // $mode = 'plane';
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Zie ook <function>current</function>, <function>end</function>,
+ <function>next</function> en <function>reset</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/range.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/range.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/range.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/range.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,111 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.16 Maintainer: janwb Status: ready -->
+ <refentry id="function.range">
+ <refnamediv>
+ <refname>range</refname>
+ <refpurpose>
+ Maak een array met een reeks van elementen
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>array</type><methodname>range</methodname>
+ <methodparam><type>mixed</type><parameter>low</parameter></methodparam>
+ <methodparam><type>mixed</type><parameter>high</parameter></methodparam>
+ <methodparam choice="opt"><type>number</type><parameter>step</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>range</function> geeft een array van elementen van
+ <parameter>low</parameter> naar <parameter>high</parameter>,
+ inclusief. Wanneer low > high, dan zal de reeks lopen van
+ high naar low.
+ </para>
+ <note>
+ <title>Nieuwe parameter</title>
+ <simpara>
+ De optionele <parameter>step</parameter> parameter was toegevoegd in 5.0.0.
+ </simpara>
+ </note>
+ <para>
+ Wanneer een <parameter>step</parameter> waarde is gegeven, zal het worden
+ toegepast als de ophoging tussen elementen in de reeks. <parameter>step</parameter>
+ moet meegegeven worden als een positief nummer. Wanneer niet gespecificeerd,
+ zal <parameter>step</parameter> een standaard waarde van 1 hebben.
+ </para>
+ <para>
+ <example>
+ <title><function>range</function> voorbeelden</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12)
+foreach (range(0, 12) as $number) {
+ echo $number;
+}
+
+// De step parameter was geintroduceerd in 5.0.0
+// array(0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100)
+foreach (range(0, 100, 10) as $number) {
+ echo $number;
+}
+
+// Het gebruik van tekenreeksen was geintroduceerd in 4.1.0
+// array('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i');
+foreach (range('a', 'i') as $letter) {
+ echo $letter;
+}
+// array('c', 'b', 'a');
+foreach (range('c', 'a') as $letter) {
+ echo $letter;
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <note>
+ <para>
+ Voor PHP 4.1.0, genereerde <function>range</function> alleen oplopende
+ arrays bestaande uit integers. Ondersteuning voor tekenreeksen en
+ aflopende arrays was toegevoegd in 4.1.0. Tekenreekswaarden zijn
+ gelimiteerd tot een lengte van een. Wanneer de lengte groter is,
+ zal alleen het eerste teken gebruikt worden.
+ </para>
+ </note>
+ <caution>
+ <para>
+ In PHP versies 4.1.0 t/m 4.3.2, ziet <function>range</function>
+ numerieke strings als strings en niet als integers. In plaats
+ daarvan, zullen ze gebruikt worden als tekenreeksen. Bijvoorbeeld,
+ <literal>"4242"</literal> wordt behandeld als <literal>"4"</literal>.
+ </para>
+ </caution>
+ <para>
+ Zie ook <function>shuffle</function>,
+ <function>array_fill</function> en
+ <link linkend="control-structures.foreach">foreach</link>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/reset.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/reset.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/reset.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/reset.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.14 Maintainer: janwb Status: ready -->
+ <refentry id="function.reset">
+ <refnamediv>
+ <refname>reset</refname>
+ <refpurpose>
+ Verplaats de interne pointer van een array naar het eerste element
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>mixed</type><methodname>reset</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>reset</function> verplaatst de interne pointer van
+ <parameter>array</parameter> naar het eerste element en geeft
+ de waarde ervan terug of &false; wanneer de array leeg is.
+ </para>
+ <para>
+ <example>
+ <title><function>reset</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+$array = array('step one', 'step two', 'step three', 'step four');
+
+// Standaard wijst de pointer naar het eerste element
+echo current($array) . "<br />\n"; // "step one"
+
+// Sla twee stappen over
+next($array);
+next($array);
+echo current($array) . "<br />\n"; // "step three"
+
+// Verplaats de pointer naar het begin en begin weer bij de eerste stap
+reset($array);
+echo current($array) . "<br />\n"; // "step one"
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Zie ook <function>current</function>,
+ <function>each</function>, <function>end</function>,
+ <function>next</function> en <function>prev</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/rsort.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/rsort.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/rsort.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/rsort.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.13 Maintainer: janwb Status: ready -->
+ <refentry id="function.rsort">
+ <refnamediv>
+ <refname>rsort</refname>
+ <refpurpose>Sorteer een array in omgekeerde volgorde</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>rsort</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Deze functie sorteert een array in omgekeerde volgorde (van hoog naar laag).
+ </para>
+ ¬e.no-key-association;
+ <para>
+ &return.success;
+ </para>
+ <para>
+ <example>
+ <title><function>rsort</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$fruits = array("lemon", "orange", "banana", "apple");
+rsort($fruits);
+foreach ($fruits as $key => $val) {
+ echo "$key = $val\n";
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+0 = orange
+1 = lemon
+2 = banana
+3 = apple
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ Het fruit is gesorteerd in omgekeerde alfabetische volgorde.
+ </para>
+ <para>
+ Je kunt de manier van sorteren wijzigen door gebruik te
+ maken van de optionele <parameter>sort_flags</parameter>
+ parameter. Voor details, zie <function>sort</function>.
+ </para>
+ <para>
+ Zie ook <function>arsort</function>,
+ <function>asort</function>, <function>ksort</function>,
+ <function>krsort</function>,
+ <function>sort</function> en <function>usort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/shuffle.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/shuffle.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/shuffle.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/shuffle.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.14 Maintainer: janwb Status: ready -->
+ <refentry id="function.shuffle">
+ <refnamediv>
+ <refname>shuffle</refname>
+ <refpurpose>Rangschik de elementen van een array in een willekeurige volgorde</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>shuffle</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Deze functie rangschikt de elementen van een array in een willekeurige volgorde.
+ </para>
+ ¬e.no-key-association;
+ <para>
+ <example>
+ <title><function>shuffle</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$numbers = range(1, 20);
+srand((float)microtime() * 1000000);
+shuffle($numbers);
+foreach ($numbers as $number) {
+ echo "$number ";
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+
+ ¬e.randomseed;
+
+ <para>
+ Zie ook <function>arsort</function>, <function>asort</function>,
+ <function>ksort</function>, <function>rsort</function>,
+ <function>sort</function> en <function>usort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/sort.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/sort.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/sort.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/sort.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.23 Maintainer: janwb Status: ready -->
+ <refentry id="function.sort">
+ <refnamediv>
+ <refname>sort</refname>
+ <refpurpose>Sorteer een array</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>sort</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Deze functie sorteert een array. Elementen zullen zijn geschikt
+ van laag naar hoog wanneer de functie gereed is.
+ </para>
+ ¬e.no-key-association;
+ <para>
+ &return.success;
+ </para>
+ <para>
+ <example>
+ <title><function>sort</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+$fruits = array("lemon", "orange", "banana", "apple");
+sort($fruits);
+foreach ($fruits as $key => $val) {
+ echo "fruits[" . $key . "] = " . $val . "\n";
+}
+
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+fruits[0] = apple
+fruits[1] = banana
+fruits[2] = lemon
+fruits[3] = orange
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ Het fruit is gesorteerd in alfabetische volgorde.
+ </para>
+ <para>
+ De optionele tweede parameter <parameter>sort_flags</parameter>
+ kan worden gebruikt om de manier van sorteren te wijzigen door
+ gebruik te maken van de volgende waarden:
+ </para>
+ <para>
+ Sorting type flags:
+ <itemizedlist>
+ <listitem>
+ <simpara><constant>SORT_REGULAR</constant> - standaardvergelijking van de items
+ (geen wijziging van de typen)</simpara>
+ </listitem>
+ <listitem>
+ <simpara><constant>SORT_NUMERIC</constant> - vergelijk de items numeriek</simpara>
+ </listitem>
+ <listitem>
+ <simpara><constant>SORT_STRING</constant> - vergelijk de items als strings</simpara>
+ </listitem>
+ <listitem>
+ <simpara><constant>SORT_LOCALE_STRING</constant> - vergelijk de items
+ als strings, gebaseerd op de huidige locale. Toegevoegd in PHP 4.4.0
+ en 5.0.2. Voor PHP 6 wordt de systeem locale gebruikt, die gewijzigd
+ kan worden door gebruik te maken van de <function>setlocale</function>
+ functie. Vanaf PHP 6, moet de <function>i18n_loc_set_default</function>
+ hiervoor worden gebruikt.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <note>
+ <para>
+ De tweede parameter was toegevoegd in PHP 4.
+ </para>
+ </note>
+ <warning>
+ <simpara>
+ Wees voorzichtig bij het sorteren van arrays met gemixte typen,
+ omdat het resultaat van <function>sort</function> onvoorspelbaar
+ kan zijn.
+ </simpara>
+ </warning>
+ <para>
+ Zie ook <function>arsort</function>,
+ <function>asort</function>, <function>ksort</function>,
+ <function>krsort</function>,
+ <function>natsort</function>, <function>natcasesort</function>,
+ <function>rsort</function>, <function>usort</function>,
+ <function>array_multisort</function> en
+ <function>uksort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/uasort.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/uasort.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/uasort.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/uasort.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.8 Maintainer: janwb Status: ready -->
+ <refentry id="function.uasort">
+ <refnamediv>
+ <refname>uasort</refname>
+ <refpurpose>
+ Sorteer een array met een gebruikersfunctie en behoud de index
+ associatie.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>uasort</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Deze functie sorteert een array zodat de array indices hun verhouding
+ tot de array elementen behouden waarmee ze geassocieerd zijn. Dit wordt
+ voornamelijk gebruikt voor het sorteren van associatieve arrays, waarbij
+ de element volgorde van belang is. De vergelijkingsfunctie is door de
+ gebruiker gedefinieerd.
+ </para>
+ <para>
+ &return.success;
+ </para>
+ <note>
+ <para>
+ Zie <function>usort</function> en
+ <function>uksort</function> voor voorbeelden van gebruikersgedefineerde
+ vergelijkingsfuncties.
+ </para>
+ </note>
+ <para>
+ Zie ook <function>usort</function>, <function>uksort</function>,
+ <function>sort</function>, <function>asort</function>,
+ <function>arsort</function>, <function>ksort</function>,
+ en <function>rsort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/uksort.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/uksort.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/uksort.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/uksort.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.16 Maintainer: janwb Status: ready -->
+ <refentry id="function.uksort">
+ <refnamediv>
+ <refname>uksort</refname>
+ <refpurpose>
+ Sorteer een array via de keys met een gebruikersfunctie
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>uksort</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>uksort</function> zal de keys van een array sorteren
+ via een gebruikersgedefineerde vergelijkingsfunctie. Wanneer je
+ een array wil sorteren met enkele belangrijke criteria, dan moet je
+ deze functie gebruiken.
+ </para>
+ <para>
+ De <parameter>cmp_function</parameter> functie moet twee
+ parameters accepteren, die voorzien zullen worden door paren
+ van de <parameter>array</parameter> keys. De vergelijkingsfunctie
+ moet een integer teruggeven die kleiner dan, gelijk aan of groter
+ dan 0 is, wanneer het eerste argument respectievelijk kleiner dan,
+ gelijk aan of groter wordt beschouwd dan het tweede argument.
+ </para>
+ <para>
+ &return.success;
+ </para>
+ <para>
+ <example>
+ <title><function>uksort</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function cmp($a, $b)
+{
+ if ($a == $b) {
+ return 0;
+ }
+ return ($a > $b) ? -1 : 1;
+}
+
+$a = array(4 => "four", 3 => "three", 20 => "twenty", 10 => "ten");
+
+uksort($a, "cmp");
+
+foreach ($a as $key => $value) {
+ echo "$key: $value\n";
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+20: twenty
+10: ten
+4: four
+3: three
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ Zie ook <function>usort</function>, <function>uasort</function>,
+ <function>sort</function>, <function>asort</function>,
+ <function>arsort</function>, <function>ksort</function>,
+ <function>natsort</function> en <function>rsort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
http://cvs.php.net/viewcvs.cgi/phpdoc-nl/reference/array/functions/usort.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-nl/reference/array/functions/usort.xml
diff -u /dev/null phpdoc-nl/reference/array/functions/usort.xml:1.4
--- /dev/null Sun Mar 26 17:28:18 2006
+++ phpdoc-nl/reference/array/functions/usort.xml Sun Mar 26 17:28:18 2006
@@ -0,0 +1,206 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.23 Maintainer: janwb Status: ready -->
+ <refentry id="function.usort">
+ <refnamediv>
+ <refname>usort</refname>
+ <refpurpose>
+ Sorteer een array via de waarden met een gebruikersfunctie
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschrijving</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>usort</methodname>
+ <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
+ <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>uksort</function> zal de waarden van een array sorteren
+ via een gebruikersgedefineerde vergelijkingsfunctie. Wanneer je
+ een array wil sorteren met enkele belangrijke criteria, dan moet je
+ deze functie gebruiken.
+ </para>
+ <para>
+ De vergelijkingsfunctie moet een integer teruggeven die kleiner dan,
+ gelijk aan of groter dan 0 is, wanneer het eerste argument
+ respectievelijk kleiner dan, gelijk aan of groter wordt beschouwd
+ dan het tweede argument.
+ </para>
+ <para>
+ <note>
+ <para>
+ Wanneer twee waarden beschouwd worden als gelijkwaardig, is hun volgorde
+ in de gesorteerde array ongedefinieerd. Tot PHP 4.0.6 behield de gebruikersfunctie
+ de originele volgorde van deze elementen, maar met de introductie van het nieuwe
+ sorteer algoritme in 4.1.0, is dit niet langer het geval en er is geen oplossing
+ om dit te doen op efficiente wijze.
+ </para>
+ </note>
+ </para>
+ ¬e.no-key-association;
+ <para>
+ &return.success;
+ </para>
+ <para>
+ <example>
+ <title><function>usort</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function cmp($a, $b)
+{
+ if ($a == $b) {
+ return 0;
+ }
+ return ($a < $b) ? -1 : 1;
+}
+
+$a = array(3, 2, 5, 6, 1);
+
+usort($a, "cmp");
+
+foreach ($a as $key => $value) {
+ echo "$key: $value\n";
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+0: 1
+1: 2
+2: 3
+3: 5
+4: 6
+]]>
+ </screen>
+ </example>
+ </para>
+ <note>
+ <para>
+ Het spreekt voor zich dat in dit minder kritische geval
+ de <function>sort</function> toepasselijker zou zijn.
+ </para>
+ </note>
+ <para>
+ <example>
+ <title>
+ <function>usort</function> voorbeeld met een multi-dimensionale array
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function cmp($a, $b)
+{
+ return strcmp($a["fruit"], $b["fruit"]);
+}
+
+$fruits[0]["fruit"] = "lemons";
+$fruits[1]["fruit"] = "apples";
+$fruits[2]["fruit"] = "grapes";
+
+usort($fruits, "cmp");
+
+while (list($key, $value) = each($fruits)) {
+ echo "\$fruits[$key]: " . $value["fruit"] . "\n";
+}
+?>
+]]>
+ </programlisting>
+ <para>
+ Bij het sorteren van een multi-dimensionale array, bevatten <varname>$a</varname>
+ en <varname>$b</varname> referenties naar de eerste index van de array.
+ </para>
+ &example.outputs;
+ <screen>
+<![CDATA[
+$fruits[0]: apples
+$fruits[1]: grapes
+$fruits[2]: lemons
+]]>
+ </screen>
+ </example>
+ </para>
+
+ <para>
+ <example>
+ <title>
+ <function>usort</function> voorbeeld gebruikmakend van een functie van een object
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+class TestObj {
+ var $name;
+
+ function TestObj($name)
+ {
+ $this->name = $name;
+ }
+
+ /* Dit is de static vergelijkingsfunctie: */
+ function cmp_obj($a, $b)
+ {
+ $al = strtolower($a->name);
+ $bl = strtolower($b->name);
+ if ($al == $bl) {
+ return 0;
+ }
+ return ($al > $bl) ? +1 : -1;
+ }
+}
+
+$a[] = new TestObj("c");
+$a[] = new TestObj("b");
+$a[] = new TestObj("d");
+
+usort($a, array("TestObj", "cmp_obj"));
+
+foreach ($a as $item) {
+ echo $item->name . "\n";
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+b
+c
+d
+]]>
+ </screen>
+ </example>
+ </para>
+
+ <para>
+ Zie ook <function>uasort</function>,
+ <function>uksort</function>, <function>sort</function>,
+ <function>asort</function>,
+ <function>arsort</function>,<function>ksort</function>,
+ <function>natsort</function> en <function>rsort</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->