cvs: phpdoc-nl /reference/array/functions arsort.xml asort.xml compact.xml count.xml current.xml each.xml end.xml extract.xml
[email protected] ("Dirkjan Ochtman")
| Newsgroups | php.doc.nl |
|---|---|
| Message-ID | <cvsmanuzhai1042995224@cvsserver> |
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.
manuzhai-20030119115344.txt
(text/plain, 27.9 KB)
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
+-->