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

From: Date: Sun, 26 Mar 2006 17:28:18 +0000
Subject: 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
Groups: php.doc.nl 
Request: Send a blank email to doc-nl+get-420@lists.php.net to get a copy of this message
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

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 &gt; 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> + &note.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> + &note.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> + + &note.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> + &note.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> + &note.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 +-->
« previous php.doc.nl (#420) next »