cvs: phpdoc-nl /reference/array/functions arsort.xml asort.xml compact.xml count.xml current.xml each.xml end.xml extract.xml
| From: | Dirkjan Ochtman | Date: | Sun, 19 Jan 2003 16:53:44 +0000 |
| Subject: | cvs: phpdoc-nl /reference/array/functions arsort.xml asort.xml compact.xml count.xml current.xml each.xml end.xml extract.xml | ||
| Groups: | php.doc.nl | ||
| Request: | Send a blank email to doc-nl+get-234@lists.php.net to get a copy of this message | ||
manuzhai Sun Jan 19 11:53:44 2003 EDT
Modified files:
/phpdoc-nl/reference/array/functions arsort.xml asort.xml
compact.xml count.xml
current.xml each.xml end.xml
extract.xml
Log:
Translated from EN.
Index: phpdoc-nl/reference/array/functions/arsort.xml diff -u /dev/null phpdoc-nl/reference/array/functions/arsort.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/arsort.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready --> + <refentry id="function.arsort"> + <refnamediv> + <refname>arsort</refname> + <refpurpose> + Sorteer een array in omgekeerde volgorde en bewaar index associatie + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>void</type><methodname>arsort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> + </methodsynopsis> + <para> + Deze functie sorteert een array zodat de array indices gerelateerd + blijven met de array elementen waarmee ze geassocieerd zijn. Hij wordt + over het algemeen gebruikt bij het sorteren van associatieve arrays + als de eigenlijke volgorde van de elementen belangrijk is. + </para> + <example> + <title><function>arsort</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); +arsort ($fruits); +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { + echo "$key = $val\n"; +} +]]> + </programlisting> + <para> + De output van bovenstaand programma ziet er zo uit: + <screen> +<![CDATA[ +a = orange +d = lemon +b = banana +c = apple +]]> + </screen> + </para> + </example> + <para> + De vruchten zijn gesorteerd in omgekeerde alfabetische volgorde, + en de index die gekoppeld was aan elk element is bewaard. + </para> + <para> + Het gedrag van het sorteren kan worden veranderd met de + optionele parameter <parameter>sort_flags</parameter>, voor meer + details zie <function>sort</function>. + </para> + <para> + Zie ook <function>asort</function>, <function>rsort</function>, + <function>ksort</function> en <function>sort</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 +--> Index: phpdoc-nl/reference/array/functions/asort.xml diff -u /dev/null phpdoc-nl/reference/array/functions/asort.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/asort.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready --> + <refentry id="function.asort"> + <refnamediv> + <refname>asort</refname> + <refpurpose>Sorteer een array en bewaar de index associatie</refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>void</type><methodname>asort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> + </methodsynopsis> + <para> + Deze functie sorteert een array zo dat de array indices gekoppeld + blijven met de elementen waar ze bij horen. Dit wordt vooral gebruikt + bij het sorteren van associatieve arrays waarbij de eigenlijke + volgorde van de elementen belangrijk is. + </para> + <example> + <title><function>asort</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); +asort ($fruits); +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { + echo "$key = $val\n"; +} +]]> + </programlisting> + <para> + De output van bovenstaand programma ziet er zo uit: + <screen> +<![CDATA[ +c = apple +b = banana +d = lemon +a = orange +]]> + </screen> + </para> + </example> + <para> + De vruchten zijn gesorteerd in alfabetische volgorde, + en de index die gekoppeld was aan elk element is bewaard. + </para> + <para> + Het gedrag van het sorteren kan worden veranderd met de + optionele parameter <parameter>sort_flags</parameter>, voor meer + details zie <function>sort</function>. + </para> + <para> + Zie ook <function>arsort</function>, <function>rsort</function>, + <function>ksort</function> en <function>sort</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 +--> Index: phpdoc-nl/reference/array/functions/compact.xml diff -u /dev/null phpdoc-nl/reference/array/functions/compact.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/compact.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,89 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready --> + <refentry id="function.compact"> + <refnamediv> + <refname>compact</refname> + <refpurpose> + Maak een array met daarin variabelen en hun waarden + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>array</type><methodname>compact</methodname> + <methodparam><type>mixed</type><parameter>varname</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <para> + <function>compact</function> ontvangt een variabel aantal + parameters. Elke parameter kan een string zijn met daarin de + naam van een variabele of een array met namen van variabelen. De array + kan andere arrays met namen van variabelen erin bevatten; + <function>compact</function> gaat er recursief mee om. + </para> + <para> + Voor elk van deze zoekt <function>compact</function> een variabele + met die naam in de huidige symbol table en voegt deze toe aan de + output array zodat de naam van de variabele de key wordt en de + inhoud van de variabele de waarde voor die key wordt. Kortom, + deze functie doet het tegengestelde van <function>extract</function>. + Hij geeft de output array terug met alle variabelen er aan toegevoegd. + </para> + <para> + Strings die geen waarde hebben zullen worden overgeslagen. + </para> + <para> + <example> + <title><function>compact</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +$city = "San Francisco"; +$state = "CA"; +$event = "SIGGRAPH"; + +$location_vars = array ("city", "state"); + +$result = compact ("event", "nothing_here", $location_vars); +]]> + </programlisting> + <para> + Hierna zal <varname>$result</varname> de volgende waarde hebben: + <screen role="php"> +<![CDATA[ +Array +( + [event] => SIGGRAPH + [city] => San Francisco + [state] => CA +) +]]> + </screen> + </para> + </example> + </para> + <para> + Zie ook <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 +--> Index: phpdoc-nl/reference/array/functions/count.xml diff -u /dev/null phpdoc-nl/reference/array/functions/count.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/count.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,92 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready --> + <refentry id="function.count"> + <refnamediv> + <refname>count</refname> + <refpurpose>Telt de elementen in een array</refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>int</type><methodname>count</methodname> + <methodparam><type>mixed</type><parameter>var</parameter></methodparam> + </methodsynopsis> + <para> + Geeft het aantal elementen in <parameter>var</parameter> terug, hetgeen + over het algemeen een <type>array</type> is (omdat iets anders altijd + een element heeft). + </para> + <para> + Als <parameter>var</parameter> geen array is, wordt <literal>1</literal> + teruggegeven (uitzondering: <literal>count(&null;)</literal> is gelijk aan + <literal>0</literal>). + </para> + <warning> + <para> + <function>count</function> kan 0 teruggeven voor een variabele + die nog geen waarde heeft gekregen, maar hij kan ook 0 teruggeven + voor een variabele die als lege array is geinitialiseerd. Gebruik + <function>isset</function> om te kijken of een variabele een waarde + heeft. + </para> + </warning> + <para> + In de <link linkend="language.types.array">Arrays</link> + sectie van de manual wordt een uitgebreide uitleg gegeven van hoe + arrays worden geimplementeerd en gebruikt in PHP. + </para> + <para> + <example> + <title><function>count</function> voorbeeld</title> + <programlisting role="php"> + <!-- TODO: examples about count(null), count(false), count(object).. --> +<![CDATA[ +$a[0] = 1; +$a[1] = 3; +$a[2] = 5; +$result = count ($a); +// $result == 3 + +$b[0] = 7; +$b[5] = 9; +$b[10] = 11; +$result = count ($b); +// $result == 3; +]]> + </programlisting> + </example> + </para> + <note> + <para> + De <function>sizeof</function> function is een + <link linkend="aliases">alias</link> voor <function>count</function>. + </para> + </note> + <para> + Zie ook <function>is_array</function>, + <function>isset</function> en + <function>strlen</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 +--> Index: phpdoc-nl/reference/array/functions/current.xml diff -u /dev/null phpdoc-nl/reference/array/functions/current.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/current.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready --> + <refentry id="function.current"> + <refnamediv> + <refname>current</refname> + <refpurpose>Geeft het huidige element in een array terug</refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>mixed</type><methodname>current</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> + <para> + Elke array heeft een interne pointer naar zijn "current" element, + die wordt geinitialiseerd naar het eerste element toegevoegd + aan de array. + </para> + <para> + <function>current</function> geeft het array element terug + waarnaar op dat moment wordt gewezen door de interne + pointer. De pointer wordt niet veranderd. Als de pointer + voorbij het einde van de lijst wijst geeft + <function>current</function> &false; terug. + <warning> + <para> + Als de array lege elementen bevat (0 or "", de lege string) + zal deze functie ook voor die elementen &false; teruggeven. + Het is hierdoor onmogelijk om met deze functie uit te vinden of het + einde van de lijst echt bereikt is. Om op een goede manier + door een array heen te lopen waar lege elementen in kunnen zitten + kan <function>each</function> gebruikt worden. + </para> + </warning> + </para> + <para> + Zie ook <function>end</function>, <function>next</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 +--> Index: phpdoc-nl/reference/array/functions/each.xml diff -u /dev/null phpdoc-nl/reference/array/functions/each.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/each.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,122 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.7 Maintainer: manuzhai Status: ready --> + <refentry id="function.each"> + <refnamediv> + <refname>each</refname> + <refpurpose> + Geef het huidige key-waarde paar terug uit een array en + verplaats de array cursor een stap naar voren + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>array</type><methodname>each</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> + <para> + Geeft het huidige key-waarde paar terug uit de + <parameter>array</parameter> en verplaatst de array cursor + een stap naar voren. Dit paar wordt teruggegeven in een + array met vier elementen, met de keys + <emphasis>0</emphasis>, <emphasis>1</emphasis>, + <emphasis>key</emphasis>, en + <emphasis>value</emphasis>. De elementen <emphasis>0</emphasis> en + <emphasis>key</emphasis> bevatten de key van het array element en + <emphasis>1</emphasis> en <emphasis>value</emphasis> bevatten de waarde. + </para> + <para> + Als de interne pointer voor de array voorbij het einde van de array + wijst, geeft <function>each</function> &false; terug. + </para> + <para> + <example> + <title><function>each</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +$foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese"); +$bar = each($foo); +]]> + </programlisting> + <para> + <varname>$bar</varname> bevat nu de volgende key-waarde paren: + <itemizedlist spacing="compact"> + <listitem><simpara>0 => 0</simpara></listitem> + <listitem><simpara>1 => 'bob'</simpara></listitem> + <listitem><simpara>key => 0</simpara></listitem> + <listitem><simpara>value => 'bob'</simpara></listitem> + </itemizedlist> + <programlisting role="php"> +<![CDATA[ +$foo = array ("Robert" => "Bob", "Seppo" => "Sepi"); +$bar = each ($foo); +]]> + </programlisting> + </para> + <para> + <varname>$bar</varname> bevat nu de volgende key-waarde paren: + <itemizedlist spacing="compact"> + <listitem><simpara>0 => 'Robert'</simpara></listitem> + <listitem><simpara>1 => 'Bob'</simpara></listitem> + <listitem><simpara>key => 'Robert'</simpara></listitem> + <listitem><simpara>value => 'Bob'</simpara></listitem> + </itemizedlist> + </para> + </example> + </para> + <para> + <function>each</function> wordt gewoonlijk gebruikt met + <function>list</function> om door een array heen te lopen; + bijvoorbeeld <varname>$_POST</varname>: + <example> + <title> + Door <varname>$_POST</varname> heen lopen met + <function>each</function> + </title> + <programlisting role="php"> +<![CDATA[ +echo "Waarden binnengekomen via POST:<br />\n"; +reset ($_POST); +while (list ($key, $val) = each ($_POST)) { + echo "$key => $val<br />\n"; +} +]]> + </programlisting> + </example> + </para> + <para> + Nadata <function>each</function> is uitgevoerd zal de array cursor + wijzen naar het volgende element in de array, of naar het laatste + element als de functie het einde van de array tegenkomt. + <function>reset</function> moet gebruikt worden wanneer de array + nogmaals doorlopen moet worden. + </para> + <para> + Zie ook <function>key</function>, <function>list</function>, + <function>current</function>, <function>reset</function>, + <function>next</function>, <function>prev</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 +--> Index: phpdoc-nl/reference/array/functions/end.xml diff -u /dev/null phpdoc-nl/reference/array/functions/end.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/end.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.5 Maintainer: manuzhai Status: ready --> + <refentry id="function.end"> + <refnamediv> + <refname>end</refname> + <refpurpose> + Zet de interne pointer van een array op zijn laatste element + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>mixed</type><methodname>end</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> + <para> + <function>end</function> zet <parameter>array</parameter>'s + interne pointer vooruit naar het laatste element en geeft dat element + terug. + </para> + <para> + <example> + <title>Een simpel <function>end</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +<?php + + $fruits = array('apple','banana','cranberry'); + + print end($fruits); // cranberry + +?> +]]> + </programlisting> + </example> + </para> + <para> + Zie ook <function>current</function>, + <function>each</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 +--> Index: phpdoc-nl/reference/array/functions/extract.xml diff -u /dev/null phpdoc-nl/reference/array/functions/extract.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/extract.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,227 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.6 Maintainer: manuzhai Status: ready --> + <refentry id="function.extract"> + <refnamediv> + <refname>extract</refname> + <refpurpose> + Importeer variabelen naar de current symbol table vanuit een array + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>int</type><methodname>extract</methodname> + <methodparam><type>array</type><parameter>var_array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>extract_type</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>prefix</parameter></methodparam> + </methodsynopsis> + <para> + Deze functie wordt gebruikt om variabelen te importeren uit een array + naar de huidige symbol table. Er wordt een associatieve array + <parameter>var_array</parameter> meegegeven, en de keys daarvan + worden als namen en de waarden als waarden voor de variabele gebruikt + worden. Voor elk key/waarde paar zal de functie een variabele creeeren + in de huidige symbol table, waarbij rekening wordt gehouden met de + <parameter>extract_type</parameter> en + <parameter>prefix</parameter> parameters. + </para> + <note> + <para> + Vanaf versie 4.0.5 geeft deze functie het aantal variabelen + dat werd geimporteerd terug. + </para> + </note> + <note> + <para> + EXTR_IF_EXISTS en EXTR_PREFIX_IF_EXISTS werden toegevoegd in versie 4.2.0. + </para> + </note> + <note> + <para> + EXTR_REFS werd toegevoegd in versie 4.3.0. + </para> + </note> + <para> + <function>extract</function> kijkt bij elke key of het een + valide naam voor een variabele is. Ook wordt er gecheckt op + botsingen met bestaande variabelen in de symbol table. Ongeldige/numerieke + keys en botsingen worden volgens <parameter>extract_type</parameter>. + Deze kan een van de volgende waarden hebben: + <variablelist> + <varlistentry> + <term>EXTR_OVERWRITE</term> + <listitem> + <simpara> + Als er een botsing is moet de bestaande variabele overschreven + worden. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_SKIP</term> + <listitem> + <simpara> + Als er een botsing is moet de bestaande variabele intact gelaten + worden. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_PREFIX_SAME</term> + <listitem> + <simpara>Als er een botsing is, zet dan <parameter>prefix</parameter> + voor de naam van de variabele. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_PREFIX_ALL</term> + <listitem> + <simpara> + Zet <parameter>prefix</parameter> voor de namen van alle variabelen. + Vanaf PHP 4.0.5 geldt dit ook voor numerieke variabelen. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_PREFIX_INVALID</term> + <listitem> + <simpara> + Zet alleen een <parameter>prefix</parameter> voor ongeldige + en numerieke namen van variabelen. Deze flag werd toegevoegd + in PHP 4.0.5. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_IF_EXISTS</term> + <listitem> + <simpara> + Overschrijf de variabele alleen als deze al bestaat in + de huidige symbol table, en doe anders niets. Dit is bruikbaar + om een lijst van geldige variabelen te genereren en vervolgens + alleen deze variabelen te extraheren uit $_REQUEST, bijvoorbeeld. + Deze flag werd toegevoegd in PHP 4.2.0. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_PREFIX_IF_EXISTS</term> + <listitem> + <simpara> + Maak alleen variabelen als de variant van de variabele zonder + prefix al bestaat in de huidige symbol table. Deze flag + werd toegevoegd in PHP 4.2.0. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_REFS</term> + <listitem> + <simpara> + Importeer variabelen als referenties. Dit betekent effectief dat de + waarden van de geimporteerde variabelen nog steeds aan de waarden van + de <parameter>var_array</parameter> parameter refereren. Deze flag kan + alleen gebruikt worden of worden gecombineerd met een van de andere + flags door hem via OR toe te voegen aan + <parameter>extract_type</parameter>. Deze flag werd toegevoegd in + PHP 4.3.0. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Als <parameter>extract_type</parameter> niet is gegeven wordt aangenomen + dat EXTR_OVERWRITE werd bedoeld. + </para> + <para> + Let erop dat <parameter>prefix</parameter> alleen hoeft te worden + gegeven als <parameter>extract_type</parameter> de waarde + EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID of + EXTR_PREFIX_IF_EXISTS heeft. Als het resultaat met de toevoeging geen + geldige naam voor een variabele is wordt deze niet toegevoegd + aan de symbol table. + </para> + <para> + <function>extract</function> geeft het aantal succesvol + geimporteerde variabelen terug. + </para> + <para> + <function>extract</function> kan gebruikt worden om + variabelen in de symbol table te importeren die werden + teruggegeven door <function>wddx_deserialize</function>. + </para> + <para> + <example> + <title><function>extract</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +<?php + +/* Stel dat $var_array een array is die werd teruggegeven door + wddx_deserialize() */ + +$size = "large"; +$var_array = array ("color" => "blue", + "size" => "medium", + "shape" => "sphere"); +extract ($var_array, EXTR_PREFIX_SAME, "wddx"); + +print "$color, $size, $shape, $wddx_size\n"; + +?> +]]> + </programlisting> + </example> + </para> + <para> + De output van het bovenstaande programma ziet er zo uit: + <programlisting> +<![CDATA[ +blue, large, sphere, medium +]]> + </programlisting> + </para> + <para> + <varname>$size</varname> werd niet overschreven omdat + EXTR_PREFIX_SAME was gespecificeerd, die ervoor zorgde dat + <varname>$wddx_size</varname> werd aangemaakt. Als EXTR_SKIP was + gegeven zou $wddx_size niet eens worden aangemaakt. + EXTR_OVERWRITE zou ervoor gezorgd hebben dat <varname>$size</varname> + de waarde "medium" zou hebben, en EXTR_PREFIX_ALL zou hebben gezorgd + dat de nieuwe variabelen <varname>$wddx_color</varname>, + <varname>$wddx_size</varname>, en + <varname>$wddx_shape</varname> hadden geheten. + </para> + <para> + Er moet een associatieve array gebruikt worden. Een numeriek geindexeerde + array zal geen resultaten produceren tenzij + EXTR_PREFIX_ALL of EXTR_PREFIX_INVALID gebruikt wordt. + </para> + <para> + Zie ook <function>compact</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 +-->
Index: phpdoc-nl/reference/array/functions/arsort.xml diff -u /dev/null phpdoc-nl/reference/array/functions/arsort.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/arsort.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready --> + <refentry id="function.arsort"> + <refnamediv> + <refname>arsort</refname> + <refpurpose> + Sorteer een array in omgekeerde volgorde en bewaar index associatie + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>void</type><methodname>arsort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> + </methodsynopsis> + <para> + Deze functie sorteert een array zodat de array indices gerelateerd + blijven met de array elementen waarmee ze geassocieerd zijn. Hij wordt + over het algemeen gebruikt bij het sorteren van associatieve arrays + als de eigenlijke volgorde van de elementen belangrijk is. + </para> + <example> + <title><function>arsort</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); +arsort ($fruits); +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { + echo "$key = $val\n"; +} +]]> + </programlisting> + <para> + De output van bovenstaand programma ziet er zo uit: + <screen> +<![CDATA[ +a = orange +d = lemon +b = banana +c = apple +]]> + </screen> + </para> + </example> + <para> + De vruchten zijn gesorteerd in omgekeerde alfabetische volgorde, + en de index die gekoppeld was aan elk element is bewaard. + </para> + <para> + Het gedrag van het sorteren kan worden veranderd met de + optionele parameter <parameter>sort_flags</parameter>, voor meer + details zie <function>sort</function>. + </para> + <para> + Zie ook <function>asort</function>, <function>rsort</function>, + <function>ksort</function> en <function>sort</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 +--> Index: phpdoc-nl/reference/array/functions/asort.xml diff -u /dev/null phpdoc-nl/reference/array/functions/asort.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/asort.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready --> + <refentry id="function.asort"> + <refnamediv> + <refname>asort</refname> + <refpurpose>Sorteer een array en bewaar de index associatie</refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>void</type><methodname>asort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter></methodparam> + </methodsynopsis> + <para> + Deze functie sorteert een array zo dat de array indices gekoppeld + blijven met de elementen waar ze bij horen. Dit wordt vooral gebruikt + bij het sorteren van associatieve arrays waarbij de eigenlijke + volgorde van de elementen belangrijk is. + </para> + <example> + <title><function>asort</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +$fruits = array ("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple"); +asort ($fruits); +reset ($fruits); +while (list ($key, $val) = each ($fruits)) { + echo "$key = $val\n"; +} +]]> + </programlisting> + <para> + De output van bovenstaand programma ziet er zo uit: + <screen> +<![CDATA[ +c = apple +b = banana +d = lemon +a = orange +]]> + </screen> + </para> + </example> + <para> + De vruchten zijn gesorteerd in alfabetische volgorde, + en de index die gekoppeld was aan elk element is bewaard. + </para> + <para> + Het gedrag van het sorteren kan worden veranderd met de + optionele parameter <parameter>sort_flags</parameter>, voor meer + details zie <function>sort</function>. + </para> + <para> + Zie ook <function>arsort</function>, <function>rsort</function>, + <function>ksort</function> en <function>sort</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 +--> Index: phpdoc-nl/reference/array/functions/compact.xml diff -u /dev/null phpdoc-nl/reference/array/functions/compact.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/compact.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,89 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready --> + <refentry id="function.compact"> + <refnamediv> + <refname>compact</refname> + <refpurpose> + Maak een array met daarin variabelen en hun waarden + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>array</type><methodname>compact</methodname> + <methodparam><type>mixed</type><parameter>varname</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <para> + <function>compact</function> ontvangt een variabel aantal + parameters. Elke parameter kan een string zijn met daarin de + naam van een variabele of een array met namen van variabelen. De array + kan andere arrays met namen van variabelen erin bevatten; + <function>compact</function> gaat er recursief mee om. + </para> + <para> + Voor elk van deze zoekt <function>compact</function> een variabele + met die naam in de huidige symbol table en voegt deze toe aan de + output array zodat de naam van de variabele de key wordt en de + inhoud van de variabele de waarde voor die key wordt. Kortom, + deze functie doet het tegengestelde van <function>extract</function>. + Hij geeft de output array terug met alle variabelen er aan toegevoegd. + </para> + <para> + Strings die geen waarde hebben zullen worden overgeslagen. + </para> + <para> + <example> + <title><function>compact</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +$city = "San Francisco"; +$state = "CA"; +$event = "SIGGRAPH"; + +$location_vars = array ("city", "state"); + +$result = compact ("event", "nothing_here", $location_vars); +]]> + </programlisting> + <para> + Hierna zal <varname>$result</varname> de volgende waarde hebben: + <screen role="php"> +<![CDATA[ +Array +( + [event] => SIGGRAPH + [city] => San Francisco + [state] => CA +) +]]> + </screen> + </para> + </example> + </para> + <para> + Zie ook <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 +--> Index: phpdoc-nl/reference/array/functions/count.xml diff -u /dev/null phpdoc-nl/reference/array/functions/count.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/count.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,92 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready --> + <refentry id="function.count"> + <refnamediv> + <refname>count</refname> + <refpurpose>Telt de elementen in een array</refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>int</type><methodname>count</methodname> + <methodparam><type>mixed</type><parameter>var</parameter></methodparam> + </methodsynopsis> + <para> + Geeft het aantal elementen in <parameter>var</parameter> terug, hetgeen + over het algemeen een <type>array</type> is (omdat iets anders altijd + een element heeft). + </para> + <para> + Als <parameter>var</parameter> geen array is, wordt <literal>1</literal> + teruggegeven (uitzondering: <literal>count(&null;)</literal> is gelijk aan + <literal>0</literal>). + </para> + <warning> + <para> + <function>count</function> kan 0 teruggeven voor een variabele + die nog geen waarde heeft gekregen, maar hij kan ook 0 teruggeven + voor een variabele die als lege array is geinitialiseerd. Gebruik + <function>isset</function> om te kijken of een variabele een waarde + heeft. + </para> + </warning> + <para> + In de <link linkend="language.types.array">Arrays</link> + sectie van de manual wordt een uitgebreide uitleg gegeven van hoe + arrays worden geimplementeerd en gebruikt in PHP. + </para> + <para> + <example> + <title><function>count</function> voorbeeld</title> + <programlisting role="php"> + <!-- TODO: examples about count(null), count(false), count(object).. --> +<![CDATA[ +$a[0] = 1; +$a[1] = 3; +$a[2] = 5; +$result = count ($a); +// $result == 3 + +$b[0] = 7; +$b[5] = 9; +$b[10] = 11; +$result = count ($b); +// $result == 3; +]]> + </programlisting> + </example> + </para> + <note> + <para> + De <function>sizeof</function> function is een + <link linkend="aliases">alias</link> voor <function>count</function>. + </para> + </note> + <para> + Zie ook <function>is_array</function>, + <function>isset</function> en + <function>strlen</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 +--> Index: phpdoc-nl/reference/array/functions/current.xml diff -u /dev/null phpdoc-nl/reference/array/functions/current.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/current.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.4 Maintainer: manuzhai Status: ready --> + <refentry id="function.current"> + <refnamediv> + <refname>current</refname> + <refpurpose>Geeft het huidige element in een array terug</refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>mixed</type><methodname>current</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> + <para> + Elke array heeft een interne pointer naar zijn "current" element, + die wordt geinitialiseerd naar het eerste element toegevoegd + aan de array. + </para> + <para> + <function>current</function> geeft het array element terug + waarnaar op dat moment wordt gewezen door de interne + pointer. De pointer wordt niet veranderd. Als de pointer + voorbij het einde van de lijst wijst geeft + <function>current</function> &false; terug. + <warning> + <para> + Als de array lege elementen bevat (0 or "", de lege string) + zal deze functie ook voor die elementen &false; teruggeven. + Het is hierdoor onmogelijk om met deze functie uit te vinden of het + einde van de lijst echt bereikt is. Om op een goede manier + door een array heen te lopen waar lege elementen in kunnen zitten + kan <function>each</function> gebruikt worden. + </para> + </warning> + </para> + <para> + Zie ook <function>end</function>, <function>next</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 +--> Index: phpdoc-nl/reference/array/functions/each.xml diff -u /dev/null phpdoc-nl/reference/array/functions/each.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/each.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,122 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.7 Maintainer: manuzhai Status: ready --> + <refentry id="function.each"> + <refnamediv> + <refname>each</refname> + <refpurpose> + Geef het huidige key-waarde paar terug uit een array en + verplaats de array cursor een stap naar voren + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>array</type><methodname>each</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> + <para> + Geeft het huidige key-waarde paar terug uit de + <parameter>array</parameter> en verplaatst de array cursor + een stap naar voren. Dit paar wordt teruggegeven in een + array met vier elementen, met de keys + <emphasis>0</emphasis>, <emphasis>1</emphasis>, + <emphasis>key</emphasis>, en + <emphasis>value</emphasis>. De elementen <emphasis>0</emphasis> en + <emphasis>key</emphasis> bevatten de key van het array element en + <emphasis>1</emphasis> en <emphasis>value</emphasis> bevatten de waarde. + </para> + <para> + Als de interne pointer voor de array voorbij het einde van de array + wijst, geeft <function>each</function> &false; terug. + </para> + <para> + <example> + <title><function>each</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +$foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese"); +$bar = each($foo); +]]> + </programlisting> + <para> + <varname>$bar</varname> bevat nu de volgende key-waarde paren: + <itemizedlist spacing="compact"> + <listitem><simpara>0 => 0</simpara></listitem> + <listitem><simpara>1 => 'bob'</simpara></listitem> + <listitem><simpara>key => 0</simpara></listitem> + <listitem><simpara>value => 'bob'</simpara></listitem> + </itemizedlist> + <programlisting role="php"> +<![CDATA[ +$foo = array ("Robert" => "Bob", "Seppo" => "Sepi"); +$bar = each ($foo); +]]> + </programlisting> + </para> + <para> + <varname>$bar</varname> bevat nu de volgende key-waarde paren: + <itemizedlist spacing="compact"> + <listitem><simpara>0 => 'Robert'</simpara></listitem> + <listitem><simpara>1 => 'Bob'</simpara></listitem> + <listitem><simpara>key => 'Robert'</simpara></listitem> + <listitem><simpara>value => 'Bob'</simpara></listitem> + </itemizedlist> + </para> + </example> + </para> + <para> + <function>each</function> wordt gewoonlijk gebruikt met + <function>list</function> om door een array heen te lopen; + bijvoorbeeld <varname>$_POST</varname>: + <example> + <title> + Door <varname>$_POST</varname> heen lopen met + <function>each</function> + </title> + <programlisting role="php"> +<![CDATA[ +echo "Waarden binnengekomen via POST:<br />\n"; +reset ($_POST); +while (list ($key, $val) = each ($_POST)) { + echo "$key => $val<br />\n"; +} +]]> + </programlisting> + </example> + </para> + <para> + Nadata <function>each</function> is uitgevoerd zal de array cursor + wijzen naar het volgende element in de array, of naar het laatste + element als de functie het einde van de array tegenkomt. + <function>reset</function> moet gebruikt worden wanneer de array + nogmaals doorlopen moet worden. + </para> + <para> + Zie ook <function>key</function>, <function>list</function>, + <function>current</function>, <function>reset</function>, + <function>next</function>, <function>prev</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 +--> Index: phpdoc-nl/reference/array/functions/end.xml diff -u /dev/null phpdoc-nl/reference/array/functions/end.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/end.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.5 Maintainer: manuzhai Status: ready --> + <refentry id="function.end"> + <refnamediv> + <refname>end</refname> + <refpurpose> + Zet de interne pointer van een array op zijn laatste element + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>mixed</type><methodname>end</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> + <para> + <function>end</function> zet <parameter>array</parameter>'s + interne pointer vooruit naar het laatste element en geeft dat element + terug. + </para> + <para> + <example> + <title>Een simpel <function>end</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +<?php + + $fruits = array('apple','banana','cranberry'); + + print end($fruits); // cranberry + +?> +]]> + </programlisting> + </example> + </para> + <para> + Zie ook <function>current</function>, + <function>each</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 +--> Index: phpdoc-nl/reference/array/functions/extract.xml diff -u /dev/null phpdoc-nl/reference/array/functions/extract.xml:1.4 --- /dev/null Sun Jan 19 11:53:44 2003 +++ phpdoc-nl/reference/array/functions/extract.xml Sun Jan 19 11:53:44 2003 @@ -0,0 +1,227 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.6 Maintainer: manuzhai Status: ready --> + <refentry id="function.extract"> + <refnamediv> + <refname>extract</refname> + <refpurpose> + Importeer variabelen naar de current symbol table vanuit een array + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschrijving</title> + <methodsynopsis> + <type>int</type><methodname>extract</methodname> + <methodparam><type>array</type><parameter>var_array</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>extract_type</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>prefix</parameter></methodparam> + </methodsynopsis> + <para> + Deze functie wordt gebruikt om variabelen te importeren uit een array + naar de huidige symbol table. Er wordt een associatieve array + <parameter>var_array</parameter> meegegeven, en de keys daarvan + worden als namen en de waarden als waarden voor de variabele gebruikt + worden. Voor elk key/waarde paar zal de functie een variabele creeeren + in de huidige symbol table, waarbij rekening wordt gehouden met de + <parameter>extract_type</parameter> en + <parameter>prefix</parameter> parameters. + </para> + <note> + <para> + Vanaf versie 4.0.5 geeft deze functie het aantal variabelen + dat werd geimporteerd terug. + </para> + </note> + <note> + <para> + EXTR_IF_EXISTS en EXTR_PREFIX_IF_EXISTS werden toegevoegd in versie 4.2.0. + </para> + </note> + <note> + <para> + EXTR_REFS werd toegevoegd in versie 4.3.0. + </para> + </note> + <para> + <function>extract</function> kijkt bij elke key of het een + valide naam voor een variabele is. Ook wordt er gecheckt op + botsingen met bestaande variabelen in de symbol table. Ongeldige/numerieke + keys en botsingen worden volgens <parameter>extract_type</parameter>. + Deze kan een van de volgende waarden hebben: + <variablelist> + <varlistentry> + <term>EXTR_OVERWRITE</term> + <listitem> + <simpara> + Als er een botsing is moet de bestaande variabele overschreven + worden. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_SKIP</term> + <listitem> + <simpara> + Als er een botsing is moet de bestaande variabele intact gelaten + worden. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_PREFIX_SAME</term> + <listitem> + <simpara>Als er een botsing is, zet dan <parameter>prefix</parameter> + voor de naam van de variabele. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_PREFIX_ALL</term> + <listitem> + <simpara> + Zet <parameter>prefix</parameter> voor de namen van alle variabelen. + Vanaf PHP 4.0.5 geldt dit ook voor numerieke variabelen. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_PREFIX_INVALID</term> + <listitem> + <simpara> + Zet alleen een <parameter>prefix</parameter> voor ongeldige + en numerieke namen van variabelen. Deze flag werd toegevoegd + in PHP 4.0.5. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_IF_EXISTS</term> + <listitem> + <simpara> + Overschrijf de variabele alleen als deze al bestaat in + de huidige symbol table, en doe anders niets. Dit is bruikbaar + om een lijst van geldige variabelen te genereren en vervolgens + alleen deze variabelen te extraheren uit $_REQUEST, bijvoorbeeld. + Deze flag werd toegevoegd in PHP 4.2.0. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_PREFIX_IF_EXISTS</term> + <listitem> + <simpara> + Maak alleen variabelen als de variant van de variabele zonder + prefix al bestaat in de huidige symbol table. Deze flag + werd toegevoegd in PHP 4.2.0. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>EXTR_REFS</term> + <listitem> + <simpara> + Importeer variabelen als referenties. Dit betekent effectief dat de + waarden van de geimporteerde variabelen nog steeds aan de waarden van + de <parameter>var_array</parameter> parameter refereren. Deze flag kan + alleen gebruikt worden of worden gecombineerd met een van de andere + flags door hem via OR toe te voegen aan + <parameter>extract_type</parameter>. Deze flag werd toegevoegd in + PHP 4.3.0. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Als <parameter>extract_type</parameter> niet is gegeven wordt aangenomen + dat EXTR_OVERWRITE werd bedoeld. + </para> + <para> + Let erop dat <parameter>prefix</parameter> alleen hoeft te worden + gegeven als <parameter>extract_type</parameter> de waarde + EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID of + EXTR_PREFIX_IF_EXISTS heeft. Als het resultaat met de toevoeging geen + geldige naam voor een variabele is wordt deze niet toegevoegd + aan de symbol table. + </para> + <para> + <function>extract</function> geeft het aantal succesvol + geimporteerde variabelen terug. + </para> + <para> + <function>extract</function> kan gebruikt worden om + variabelen in de symbol table te importeren die werden + teruggegeven door <function>wddx_deserialize</function>. + </para> + <para> + <example> + <title><function>extract</function> voorbeeld</title> + <programlisting role="php"> +<![CDATA[ +<?php + +/* Stel dat $var_array een array is die werd teruggegeven door + wddx_deserialize() */ + +$size = "large"; +$var_array = array ("color" => "blue", + "size" => "medium", + "shape" => "sphere"); +extract ($var_array, EXTR_PREFIX_SAME, "wddx"); + +print "$color, $size, $shape, $wddx_size\n"; + +?> +]]> + </programlisting> + </example> + </para> + <para> + De output van het bovenstaande programma ziet er zo uit: + <programlisting> +<![CDATA[ +blue, large, sphere, medium +]]> + </programlisting> + </para> + <para> + <varname>$size</varname> werd niet overschreven omdat + EXTR_PREFIX_SAME was gespecificeerd, die ervoor zorgde dat + <varname>$wddx_size</varname> werd aangemaakt. Als EXTR_SKIP was + gegeven zou $wddx_size niet eens worden aangemaakt. + EXTR_OVERWRITE zou ervoor gezorgd hebben dat <varname>$size</varname> + de waarde "medium" zou hebben, en EXTR_PREFIX_ALL zou hebben gezorgd + dat de nieuwe variabelen <varname>$wddx_color</varname>, + <varname>$wddx_size</varname>, en + <varname>$wddx_shape</varname> hadden geheten. + </para> + <para> + Er moet een associatieve array gebruikt worden. Een numeriek geindexeerde + array zal geen resultaten produceren tenzij + EXTR_PREFIX_ALL of EXTR_PREFIX_INVALID gebruikt wordt. + </para> + <para> + Zie ook <function>compact</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 +-->