<?xml version="1.0" encoding="iso-8859-1"?>
<reference id="ref.strings">
  <title>String functions</title>
  <titleabbrev>Strings</titleabbrev>

  <partintro>
   <simpara>
    Al deze functies manipuleren strings op verschillende manieren.
    Meer specifieke functies kunnen worden gevonden in de regular expression
    en URL handling secties.
   </simpara>
   
   <para>
    Voor informatie over hoe strings zich gedragen, vooral met betrekking tot
    het gebruik van single quotes, double quotes en escape sequences, zie de
    <link linkend="language.types.string">Strings</link> entry in de 
    <link linkend="language.types">Types</link> sectie van de manual.
   </para>
  </partintro>
  
  <refentry id="function.addcslashes">
   <refnamediv>
    <refname>AddCSlashes</refname>
    <refpurpose>Quote string met slashes in de C stijl</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>addcslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam><type>string</type><parameter>charlist</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft een string weer met backslashes voor de characters die 
     gegeven zijn in de <parameter>charlist</parameter> parameter.
     Het escaped <literal>\n</literal>, <literal>\r</literal> etc. in
     C-achtige stijl, characters met met ASCII code lager dan 32 en 
     hoger dan 126 worden geconverteerd naar octaal formaat. 
     Wees voorzichtig met het escapen van alfanumerieke characters.
     Je kan in <parameter>charlist</parameter> een bereik specifieren zoals
     &quot;\0..\37&quot, hetgeen alle characters zou escapen met een ASCII code tussen
     0 en 31.
     <example>
      <title><function>addcslashes</function> voorbeeld</title>
      <programlisting role="php">
$escaped = addcslashes ($not_escaped, &quot;\0..\37!@\177..\377&quot;);
      </programlisting>
     </example>
     <note>
      <simpara>
       Toegevoegd in PHP4b3-dev.</simpara>
     </note>
    </para>
    <para>
     Zie ook <function>stripcslashes</function>, 
     <function>stripslashes</function>, 
     <function>htmlspecialchars</function>,
     <function>htmlspecialchars</function>, en 
     <function>quotemeta</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.addslashes">
   <refnamediv>
    <refname>AddSlashes</refname>
    <refpurpose>Quote string met slashes</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>addslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft een string weer met backslashes voor characters die moeten
     worden gequote in database queries etc. Deze characters zijn
     single quote (<literal>'</literal>), double quote
     (<literal>&quot;</literal>), backslash (<literal>\</literal>)
     en NUL (de &null; byte).
    </para>
    <para>
     Zie ook <function>stripslashes</function>, 
     <function>htmlspecialchars</function>, en
     <function>quotemeta</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.bin2hex">
   <refnamediv>
    <refname>bin2hex</refname>
    <refpurpose>
     Converteert binaire data naar hexadecimaal formaat
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>bin2hex</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft een ASCII string weer met daarin het hexadecimale formaat
     van <parameter>str</parameter>. De conversie vindt byte-gewijs plaats
     met de hoge-nibble eerst.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.chop">
   <refnamediv>
    <refname>chop</refname>
    <refpurpose>Verwijdert achteraankomende whitespace</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>chop</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft de argument string zonder achteraankomende whitespace weer,
     inclusief newlines.
     <example>
      <title><function>chop</function> voorbeeld</title>
      <programlisting role="php">
$trimmed = chop ($line);
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      <function>chop</function> verschilt van de Perl
      <parameter>chop()</parameter> functie, die de laatste
      character van de string verwijdert.
     </para>
    </note>
    <para>
     Zie ook <function>trim</function>, <function>ltrim</function>,
     <function>rtrim</function>, en <function>chop</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.chr">
   <refnamediv>
    <refname>chr</refname>
    <refpurpose>Geeft een specific character weer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>chr</methodname>
      <methodparam><type>int</type><parameter>ascii</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft een een-character string met daarin de character
     gespecifieerd in <parameter>ascii</parameter>.
     <example>
      <title><function>chr</function> example</title>
      <programlisting role="php">
$str .= chr (27); /* voeg een escape character toe aan het eind van $str */

/* Meestal is dit wat handiger */

$str = sprintf (&quot;De string eindigt in escape: %c&quot;, 27);
      </programlisting>
     </example>
     Deze functie vult <function>ord</function> aan. Zie ook
     <function>sprintf</function> met een format string van
     <literal>%c</literal>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.chunk-split">
   <refnamediv>
    <refname>chunk_split</refname>
    <refpurpose>Split een string in kleinere stukjes</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>chunk_split</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>chunklen</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>end</parameter></methodparam>
     </methodsynopsis>
    <para>
     Kan gebruikt worden om een string in kleinere stukjes te splitten,
     wat handig kan zijn om bijvoorbeeld 
     <link linkend="function.base64-encode">base64_encode</link> uitvoer 
     overeen te doen komen met RFC 2045 vereisten.
     Deze functie voegt per <parameter>chunklen</parameter> (default is 76)
     aangegeven karakters de middels <parameter>end</parameter> aangegeven
     (default is &quot;\r\n&quot;) string in.
     <example>
      <title><function>chunk_split</function> example</title>
      <programlisting role="php">
# format $data gebruikmakend van RFC 2045 vereisten

$nieuwe_string = chunk_split (base64_encode($data));
      </programlisting>
     </example>
     Deze functie is merkbaar sneller dan
     <function>ereg_replace</function>.
     <note>
      <para>
       Deze functie is toegevoegd in 3.0.6.
      </para>
     </note>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.convert-cyr-string">
   <refnamediv>
    <refname>convert_cyr_string</refname>
    <refpurpose>
     Converteert van de ene Cyrillische karakter set naar de andere.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>convert_cyr_string</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam><type>string</type><parameter>from</parameter></methodparam>
      <methodparam><type>string</type><parameter>to</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie converteert de gegeven string van de ene naar
     de andere Cyrillische karakter-set. De <parameter>from</parameter>
     en <parameter>to</parameter> argumenten zijn enkele karakters
     die staan voor bron- en doel karakterset. De ondersteunde types zijn:
     <itemizedlist>
      <listitem>
       <simpara>
        k - koi8-r
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        w - windows-1251
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        i - iso8859-5
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        a - x-cp866
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        d - x-cp866
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        m - x-mac-cyrillic
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.count-chars">
   <refnamediv>
    <refname>count_chars</refname>
    <refpurpose>
     Geeft informatie over karakters die in een string gebruikt worden
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>mixed</type><methodname>count_chars</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type></type><parameter>
        mode
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Telt hoeveel keer elke byte-waarde (0..255) voorkomt in een 
     <parameter>string</parameter> en geeft het weer op verschillende manieren.
     De optionele parameter <parameter>Mode</parameter> is default 0.
     Afhankelijk van <parameter>mode</parameter> <function>count_chars</function>
     geeft een van de volgende terug:
     <itemizedlist>
      <listitem>
       <simpara>
        0 - een array met de byte-waarde als sleutel en de frequentie
        van elke byte als waarde.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        1 - hetzelfde als 0, maar alleen byte-waarden met een frequentie
        groter dan nul worden terug gegeven.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        2 - hetzelfde als 0, maar alleen byte-waarden met een frequentie
        die gelijk is aan nul worden terug gegeven.  
       </simpara>
      </listitem> 
      <listitem>
       <simpara>
        3 - een string die alle gebruikte byte-waarden bevat wordt terug gegeven.
       </simpara>
      </listitem> 
      <listitem>
       <simpara>
        4 - een string die alle niet gebruikte byte-waarden bevat wordt terug gegeven.
       </simpara>
      </listitem> 
     </itemizedlist>
    </para>
    <note>
     <para>
      Deze functie was toegevoegd in PHP 4.0.
     </para> 
    </note>
   </refsect1>
  </refentry>
  
  <refentry id="function.crc32">
   <refnamediv>
    <refname>crc32</refname>
    <refpurpose>Berekent de crc32 polynoom van een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>crc32</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Genereert de cyclische redundancy checksum polynoom van 32-bit lengtes
     van de <parameter>str</parameter>. Dit wordt doorgaans toegepast
     bij het valideren van de integriteit van verzonden data.
    </para>
    <para>
     Zie ook: <function>md5</function>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.crypt">
   <refnamediv>
    <refname>crypt</refname>
    <refpurpose>DES-encrypt een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>crypt</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>salt</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>crypt</function> encrypteert een string geburikmakend
     vande standaard Unix <abbrev>DES</abbrev> encryptie methode.
     Argumenten zijn de string die gecrypteerd moet worden en een
     optionele twee-karakter salt string om de encryptie op te baseren.
     Zie de Unix man page voor je crypt functie en meer informatie. 
    </para>
    <simpara>
     Als het salt argument niet wordt meegegeven zal de string
     willekeurig gegenereerd worden door PHP.
    </simpara>
    <simpara>
     Sommige operating systems ondersteunen meer dan een type encryptie.
     Soms is zelfs de standaard DES encryptie vervangen door een MD5 
     gebaseerd encryptie algoritme. Het encryptie type wordt getriggerd
     door het salt argument. Op het moment van installeren bepaalt PHP de
     mogelijkheden van de crypt functie en zal salts accepteren voor andere
     encryptie types. Als er geen salt beschikbaar is zal PHP zelf een uit
     2 karakters bestaande DES salt genereren, tenzij het default encryptie
     type op het systeem MD5 is, in dat geval zal een random MD5 compatibele
     salt gegenereerd worden. PHP maakt een constante aan genaamd CRYPT_SALT_LENGTH
     die je vertelt of een regulare 2-karakter salt of dat een 12-karakter MD5
     van toepassing is.
    </simpara>
    <simpara>
     In het geval je de meegegeven salt gebruikt, wees er dan van bewust
     dat de salt 1 keer gegenereerd wordt. Als je de functie recursief
     aanspreekt, kan dit gevolgen hebben voor de appearance en, tot op
     zekere hoogte, de veiligheid.
    </simpara>  
    <simpara>
     De standaard DES encryptie <function>crypt</function> gebruikt de
     salt als de eerste 2 karakters van de output.
    </simpara>
    <simpara>
     Op systemen waar de crypt() functie meerdere encryptie types ondersteunt,
     de volgende constanten zijn gezet op waardes 0 of 1, afhankelijk van het
     feit of het gegeven type beschikbaar is:
    </simpara>
    <itemizedlist>
     <listitem>
      <simpara>
       CRYPT_STD_DES - Standaard DES encryptie met een 2-karakter SALT
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_EXT_DES - Uitgebreide DES encryptie met een 9-karakter SALT
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_MD5 - MD5 encryptie met een 12-karakter SALT beginnend met
       $1$
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_BLOWFISH - Uitgebreide DES encryption met een 16-karakter SALT
       startende met $2$
      </simpara>
     </listitem>
    </itemizedlist>
    <simpara>
     Er is geen decrypt functie, omdat <function>crypt</function>
     gebruikmaakt van een one-way algoritme.
    </simpara>
    <simpara>
     Zie ook: <function>md5</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.echo">
   <refnamediv>
    <refname>echo</refname>
    <refpurpose>Output een of meerdere strings</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <methodname>echo</methodname>
      <methodparam><type>string</type><parameter>arg1</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>argn...</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Output alle parameters.
    </simpara>
    <para>
     <function>echo</function> is eigenlijk geen functie (het is een
     language construct), dus je hoeft geen parantheses te gebruiken.
     <example>
      <title><function>echo</function> voorbeeld</title>
      <programlisting role="php">
echo &quot;Hallo Wereld&quot;;

echo &quot;Dit spant
over meerdere regels. De newlines zullen ook
in de output worden opgenomen&quot;;

echo &quot;Dit spant\nover meerdere regels. The newlines zullen ook in de\noutput worden opgenomen.&quot;;
      </programlisting>
     </example>
    </para> 
    <note>
     <para>
      Nota bene, als je meer dan 1 parameter in de echo wilt gebruiken,
      zullen de parameters niet moeten worden ingesloten met parentheses.
     </para>
    </note>
    <simpara>
     Zie ook:
     <function>print</function>,
     <function>printf</function>, and
     <function>flush</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.explode">
   <refnamediv>
    <refname>explode</refname>
    <refpurpose>Split een string door string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>array</type><methodname>explode</methodname>
      <methodparam><type>string</type><parameter>separator</parameter></methodparam>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>limit</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft een array van strings terug, waar elk element een substring
     van <parameter>string</parameter> is, gevormd door het splitten ervan
     op basis van de string <parameter>delim</parameter>.
     Als <parameter>limit</parameter> meegegeven wordt, zal de teruggegeven array
     een maximum van <parameter>limit</parameter> elementen bevatten waarbij het
     laatste element de rest van <parameter>string</parameter> bevat.
    </para>
    <para>
     <example>
      <title><function>explode</function> voorbeeld</title>
      <programlisting role="php">
$pizza = &quot;stuk1 stuk2 stuk3 stuk4 stuk5 stuk6&quot;;
$stukken = explode (&quot; &quot;, $pizza);
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      Hoewel <function>implode</function> door historische redenen
      zijn parameters in willekeurige volgorde accepteert,
      is dit niet het geval met <function>explode</function>. Je moet
      er zeker van zijn dat de <parameter>seperator</parameter> voor het
      <parameter>string</parameter> argument komt.
     </para>
    </note>
    <para>
     Zie ook <function>split</function> en
     <function>implode</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.get-html-translation-table">
   <refnamediv>
    <refname>get_html_translation_table</refname>
    <refpurpose>
     Geeft een vertalingstabel weer die gebruikt wordt bij
     <function>htmlspecialchars</function> en
     <function>htmlentities</function>
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>get_html_translation_table</methodname>
      <methodparam><type>int</type><parameter>table</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>get_html_translation_table</function> geeft een vertalingstabel
     weer die intern gebruikt wordt voor <function>htmlspecialchars</function> en
     <function>htmlentities</function>. Er zijn twee nieuwe defines
     (<parameter>HTML_ENTITIES</parameter>, <parameter>HTML_SPECIALCHARS</parameter>)
     die het mogelijk maken om te specifieren welke tabel je wilt. En net als bij de
     <function>htmlspecialchars</function> en <function>htmlentities</function> functies
     kan je optioneel de quote_style specifieren die je gebruiken wilt. De default is
     ENT_COMPAT mode. Zie de omschrijving van deze modes in
     <function>htmlspecialchars</function>.
     <example>
      <title>Vertalingstabel Voorbeeld</title>
      <programlisting role="php">
$trans = get_html_translation_table (HTML_ENTITIES);
$str = &quot;Hallo &amp; &lt;Frau> &amp; Kr&auml;mer&quot;;
$encoded = strtr ($str, $trans);
      </programlisting>
     </example>
     De <literal>$encoded</literal> variabele zal nu bevatten: &quot;Hallo
     &amp;<sgmltag>amp</sgmltag>;
     &amp;<sgmltag>lt</sgmltag>;Frau&amp;<sgmltag>gt</sgmltag>;
     &amp;<sgmltag>amp</sgmltag>; Kr&amp;<sgmltag>auml</sgmltag>;mer&quot;.
    </para>
    <para>
     Leuk is het gebruikmaken van <function>array_flip</function> om
     de richting van de vertaling te veranderen.
     <informalexample>
      <programlisting role="php">
$trans = array_flip ($trans);
$original = strtr ($str, $trans);
      </programlisting>
     </informalexample>
      De inhoud van <literal>$original</literal> zou zijn: &quot;Hallo &amp;
      &lt;Frau> &amp; Kr&auml;mer&quot;.
     <note>
      <para>
       Deze functie was toegevoegd in PHP 4.0.
      </para> 
     </note>
    </para>
    <para>
     Zie ook: <function>htmlspecialchars</function>,
     <function>htmlentities</function>, <function>strtr</function>,
     en <function>array_flip</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.get-meta-tags">
   <refnamediv>
    <refname>get_meta_tags</refname>
    <refpurpose>
     Extract alle meta tag content attributen van een bestand en
     geeft een array terug
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>array</type><methodname>get_meta_tags</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam>
     </methodsynopsis>
    <para>
     Opent <parameter>filename</parameter> en parsed het regel voor regel
     voor &lt;meta&gt; tags van de vorm
     <example>
      <title>Meta Tags Voorbeeld</title>
      <programlisting role="html">
&lt;meta name=&quot;author&quot; content=&quot;name&quot;>
&lt;meta name=&quot;tags&quot; content=&quot;php3 documentation&quot;>
&lt;/head> &lt;!-- parsen stopt hier -->
      </programlisting>
     </example>
     (let op de line endings - PHP gebruikt native functies
     om input te parsen, dus een Mac bestand werkt niet op Unix).
    </para>
    <para>
     De waarde van de name property wordt de key, de waarde van de
     content property wordt de waarde van de teruggegeven array, 
     dus je kan gemakkelijk standaard array functies gebruiken om
     waardes in de array te kunnen benaderen. Speciale karakters in de 
     waarde van de name property worden vervangen door '_', de rest wordt
     geconverteerd naar lower case.
    </para>
    <para>
     Het zetten van <parameter>use_include_path</parameter> naar 1 zal resulteren
     in PHP die de file probeert te openen gebaseerd op de standaard include path.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.hebrev">
   <refnamediv>
    <refname>hebrev</refname>
    <refpurpose>
     Converteert logische Hebreeuwse tekst naar visuele tekst
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>hebrev</methodname>
      <methodparam><type>string</type><parameter>hebrew_text</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>max_chars_per_line</parameter></methodparam>
     </methodsynopsis>
    <para>
      De optionele parameter <parameter>max_chars_per_line</parameter>
      geeft het maxium aantal karakters per regel aan die weergegeven worden.
      De functie probeert om het breken van woorden te voorkomen.
    </para>
    <para>
     Zie ook <function>hebrevc</function>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.hebrevc">
   <refnamediv>
    <refname>hebrevc</refname>
    <refpurpose>
     Converteert logische Hebreeuwse tekst naar visuele tekst met newline conversie
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>hebrevc</methodname>
      <methodparam><type>string</type><parameter>hebrew_text</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>max_chars_per_line</parameter></methodparam>
     </methodsynopsis>
    <para>
      Deze functie is gelijk aan <function>hebrev</function> met het verschil
      dat het newlines (\n) converteert naar &quot;&lt;br&gt;\n&quot;.
      De optionele parameter <parameter>max_chars_per_line</parameter>
      geeft het maxium aantal karakters per regel aan die weergegeven worden.
      De functie probeert om het breken van woorden te voorkomen.
    </para>
    <para>
     Zie ook <function>hebrev</function>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.htmlentities">
   <refnamediv>
    <refname>htmlentities</refname>
    <refpurpose>
     Converteert alle van toepassing zijnde karakters naar HTML entities
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>htmlentities</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie is identiek aan <function>htmlspecialchars</function> 
     in alle opzichten, behalve dat alle karakters met HTML karakter entity
     equivalents worden vertaald naar deze entities. Net als 
     <function>htmlspecialchars</function> neemt het een optioneel tweede
     argument die aangeeft wat er gedaan moet worden met enkele en dubbele
     quotes. 
     <constant>ENT_COMPAT</constant> (de default)
     converteert alleen dubbele quotes en laat enkele quotes met rust.
     <constant>ENT_QUOTES</constant> converteert zowel enkele als dubbele
     quotes, en <constant>ENT_NOQUOTES</constant> laat zowel de enkele als
     dubbele quotes ongeconverteerd.
    </para>
    <para>
     Hedendaags wordt de ISO-8859-1 karakter set gebruikt. Let er op dat 
     het optionele tweede argument toegevoegd was in PHP 3.0.17 en PHP 4.0.3.
    </para>
    <para>
     Zie ook <function>htmlspecialchars</function> en
     <function>nl2br</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.htmlspecialchars">
   <refnamediv>
    <refname>htmlspecialchars</refname> 
    <refpurpose>
     Converteert speciala karakters naar HTML entities
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>htmlspecialchars</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bepaalde karakters hebben een speciale betekenis in HTML, en moeten
     daarom weergegeven worden als HTML entities als die hun betekenissen
     moeten behouden. Deze functie geeft een string terug waarin sommige van 
     deze conversies al gemaakt; de conversies die gemaakt worden zijn de
     conversies die het meest gangbaar zijn in het alledaags web programmeren.
     Als je wil dat alle HTML karakter entities geconverteerd worden moet
     hiervoor <function>htmlentities</function> worden gebruikt.
    </para>
    <simpara>
     Deze functie is nuttig om te voorkomen dat gebruiker-ingevoerde
     tekst HTML markup bevat, zoals in gastenboeken of andere applicaties.
     Het optionele tweede argument, quote_style, vertelt de functie wat te
     doen met enkele en dubbele quote karakters. De default mode, ENT_COMPAT,
     is de terugwaards compatibele mode die alleen de dubbele quotes vertaalt,
     en dus niet de enkele quotes. Als ENT_QUOTES is geactiveerd, zullen zowel
     enkele als dubbele quotes worden geconverteerd en als ENT_NOQUOTES is 
     geactiveerd zal de functie beide enkele en dubbele quotes niet converteren.
    </simpara>
    <para>
     De uitgevoerde conversies zijn:
     <itemizedlist>
      <listitem>
       <simpara>
        '&amp;' (ampersand) wordt '&amp;amp;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&quot;' (dubbele quote) wordt '&amp;quot;' wanneer ENT_NOQUOTES niet geactiveerd is.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&#039;' (enkele quote) wordt '&amp;#039;' alleen wanneer ENT_QUOTES geactiveerd is.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&lt;' (kleiner dan) wordt '&amp;lt;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&gt;' (groter dan) wordt '&amp;gt;'
       </simpara>
      </listitem>
     </itemizedlist>
     <example>
      <title><function>htmlspecialchars</function> example</title>
      <programlisting role="php">
$new = htmlspecialchars(&quot;&lt;a href='test'&gt;Test&lt;/a&gt;&quot;, ENT_QUOTES);
      </programlisting>
     </example>
    </para>
    <para>
     Merk op dat deze functie alles wat hierboven niet weergegeven is ook niet
     converteert. Voor conversie van alle entities, zie 
     <function>htmlentities</function>. Let op dat het optionele tweede argument
     toegevoegd is in PHP 3.0.17 en PHP 4.0.3.
    </para>
    <para>
     Zie ook <function>htmlentities</function> en
     <function>nl2br</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.implode">
   <refnamediv>
    <refname>implode</refname>
    <refpurpose>Voeg array elementen samen met een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>implode</methodname>
      <methodparam><type>string</type><parameter>glue</parameter></methodparam>
      <methodparam><type>array</type><parameter>pieces</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft een string terug die de string representatie van alle
     array elementen in dezelfde volgorde, met de glue string tussen
     elk element bevat.
     <example>
      <title><function>implode</function> example</title>
      <programlisting role="php">
$colon_separated = implode (&quot;:&quot;, $array);
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      <function>implode</function> kan, om historische redenen, haar parameters
      in willekeurige volgorde accepteren. Voor consistency met
      <function>explode</function>, echter, zou het minder verwarrend zijn
      als je de gedocumenteerde volgorde van de argumenten vasthoudt.
     </para>
    </note>
    <simpara>
     Zie ook <function>explode</function>, <function>join</function>,
     en <function>split</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.join">
   <refnamediv>
    <refname>join</refname>
    <refpurpose>Voeg array elements samen met een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>join</methodname>
      <methodparam><type>string</type><parameter>glue</parameter></methodparam>
      <methodparam><type>array</type><parameter>pieces</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>join</function> is een alias naar
     <function>implode</function>, en is identiek in ieder opzicht.
    </simpara>
    <simpara>
     Zie ook <function>explode</function>, <function>implode</function>,
     en <function>split</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.levenshtein">
   <refnamediv>
    <refname>levenshtein</refname> 
    <refpurpose>
     Berekent de Levenshtein afstand tussen twee strings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>levenshtein</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
     <methodsynopsis>
      <type>int</type><methodname>levenshtein</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
      <methodparam><type>int</type><parameter>cost_ins</parameter></methodparam>
      <methodparam><type>int</type><parameter>cost_rep</parameter></methodparam>
      <methodparam><type>int</type><parameter>cost_del</parameter></methodparam>
     </methodsynopsis>
     <methodsynopsis>
      <type>int</type><methodname>levenshtein</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
      <methodparam><type>function</type><parameter>cost</parameter></methodparam>
     </methodsynopsis>
    <para>
      Deze functie geeft de Levenshtein-afstand tussen de twee
      argument strings of -1 weer, als een van de argumenten is
      langer dan de grens van 255 karakters (255 zou meer dan genoeg
      moeten zijn voor naam of dictionary vergelijking, en een serieus
      persoon zou geen genetische analyses gaan doen met PHP).
    </para>
    <para>
     De Levenshtein afstand is gedefnieerd als het minimum aantal
     karakters die vervangen, ingevoegd of verwijderd moeten worden
     om <parameter>str1</parameter> naar <parameter>str2</parameter>
     te transformeren. 
     De complexiteit van het algoritme is <literal>O(m*n)</literal>,
     waar <literal>n</literal> en <literal>m</literal> de lengte zijn
     van <parameter>str1</parameter> en <parameter>str2</parameter>
     (vrij goed vergeleken met <function>similar_text</function>, wat
     O(max(n,m)**3) is, maar nog vrij kostbaar).
    </para>
    <para>
     In haar meest simpele vorm neemt de functie alleen de twee
     strings als parameter en zal het alleen het aantal invoeg- vervang- 
     en verwijderbewerkingen berekenen die nodig zijn voor het transformeren
     van <parameter>str1</parameter> in <parameter>str2</parameter>.
    </para>
    <para> 
     Een tweede variant neemt 3 parameters die de kosten van de
     invoeg- vervang- en verwijderbewerkingen definieren.
     Dit is meer algemeen en aanpasbaar dan de eerste variant, maar
     minder efficient.   
    </para>
    <para>
     De derde variant (welke nog niet geimplementeerd is) zal de 
     meest algemene en aanpasbare, maar ook het meest
     trage alternatief worden.
     Deze zal een user-voorziene functie aanspreken die zal bepalen wat 
     de kost zal zijn voor elke mogelijke bewerking.
    </para>
    <para>
     De uservoorziene functie zal worden aangesproken met de volgende
     argumenten:
     <itemizedlist>
      <listitem>
       <simpara>
        uit te voeren bewerking: 'I', 'R' or 'D'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        betreffende karakter in string 1
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        betreffende karakter in string 2
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        positie in string 1
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        positie in string 2
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        overblijvende karakters in string 1
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        overblijvende karakters in string 2
       </simpara>
      </listitem>
     </itemizedlist>
     De user-voorziene functie moet een positieve integer teruggeven,
     die de kost voor deze bewerking beschrijft, maar het mag alleen 
     maar sommige van de meegegeven argumenten gebruiken.
    </para>
    <para> 
     De user-voorziene functie aanpak biedt de mogelijkheid om op te 
     nemen de relevantie van en/of de mogelijkheid tot het opnemen van
     verschil tussen bepaalde symbolen (karakters) of zelfs de context
     waarin deze symbolen verschijnen om de kost van de invoeg- vervang-
     en verwijderbewerkingen te bepalen, maar tegen de kost van het 
     verliezen van alle optimalisatie de gedaan wordt met betrekking
     tot cpu register utilisatie en cache missingen die in de andere
     varianten opgenomen zijn. 
    </para>
    <para>
     Zie ook <function>soundex</function>, 
     <function>similar_text</function>
     en <function>metaphone</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.ltrim">
   <refnamediv>
    <refname>ltrim</refname> 
    <refpurpose>
     Stript whitespace van het begin van een string
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>ltrim</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie stript whitespace van het begin van een string en
     geeft de gestripte string terug. De whitespace karakters die
     momenteel gestript worden zijn: &quot;\n&quot;, &quot;\r&quot;, &quot;\t&quot;, &quot;\v&quot;, &quot;\0&quot;,
     en normale space.
    </para>
    <para>
     Zie ook <function>chop</function>, <function>rtrim</function>, and
     <function>trim</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.md5">
   <refnamediv>
    <refname>md5</refname>
    <refpurpose>Berekent de md5 hash van een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>md5</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Calculeert de MD5 hash van <parameter>str</parameter> gebruik makend
     van het <ulink url="&url.rfc;rfc1321.html">RSA Data Security, Inc. 
     MD5 Message-Digest Algorithm</ulink>.
    </para>
    <para>
     Zie ook: <function>crc32</function>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.metaphone">
   <refnamediv>
    <refname>metaphone</refname>
    <refpurpose>Berekent de metaphone key van een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>metaphone</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Berekent de metaphone key van <parameter>str</parameter>.
    </para>
    <para>
     Net zoals <function>soundex</function> metaphone genereert dezelfde
     sleutel voor gelijk klinkende woorden. Het is preciezer dan
     <function>soundex</function> omdat het de standaard regels 
     van de Engelse uitspraak kent. De door metaphone gegenereerde
     keys zijn van variabele lengte.
    </para>
    <para>
     Metaphone was ontwikkeld door Lawrence Philips
     &lt;lphilips@verity.com>
     Het is beschreven in [&quot;Practical Algorithms for Programmers&quot;, 
     Binstock &amp; Rex, Addison Wesley, 1995].
     <note>
      <para>
       Deze functie was toegevoegd in PHP 4.0.
      </para>
     </note>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.nl2br">
   <refnamediv>
    <refname>nl2br</refname>
    <refpurpose>Converteert newlines naar HTML line breaks</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>nl2br</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft <parameter>string</parameter> met '&lt;BR&gt;' ingevoegd
     voor alle newlines.
    </para>
    <para>
     Zie ook <function>htmlspecialchars</function>,
     <function>htmlentities</function> en
     <function>wordwrap</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.ord">
   <refnamediv>
    <refname>ord</refname>
    <refpurpose>Geeft ASCII waarde van karakter</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>ord</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft ASCII waarde van het eerste karakter in
     <parameter>string</parameter>
     Deze functie vult <function>chr</function> aan.
     <example>
      <title><function>ord</function> example</title>
      <programlisting role="php">
if (ord ($str) == 10) {
    echo &quot;Het eerste karakter van \$str is een line feed.\n&quot;;
}
      </programlisting>
     </example>
    </para>
    <simpara>
     Zie ook <function>chr</function>.
    </simpara> 
   </refsect1>
  </refentry>
  
  <refentry id="function.parse-str">
   <refnamediv>
    <refname>parse_str</refname>
    <refpurpose>Parset de string in variabelen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>void</type><methodname>parse_str</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>arr</parameter></methodparam>
     </methodsynopsis>
    <para>
     Parset <parameter>str</parameter> alsof het een query string is
     die met een URL meegegeven wordt en definieert variabelen in de huidige
     scope. Als de tweede parameter <parameter>arr</parameter> ook meegegeven
     wordt, worden de variabelen opgeslagen als array elementen.
    </para>
    <para>
     <example>
      <title>Het gebruik van <function>parse_str</function></title>
      <programlisting role="php">
$str = &quot;first=waarde&amp;second[]=dit+werkt&amp;second[]=nogeen&quot;;
parse_str($str);
echo $first;     /* print &quot;waarde&quot; */
echo $second[0]; /* print &quot;dit werkt&quot; */
echo $second[1]; /* print &quot;nogeen&quot; */
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.print">
   <refnamediv>
    <refname>print</refname>
    <refpurpose>Output een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <methodname>print</methodname>
      <methodparam><type>string</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Output <parameter>arg</parameter>.
    </simpara>
    <simpara>
     Zie ook: <function>echo</function>, <function>printf</function>,
     en <function>flush</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.printf">
   <refnamediv>
    <refname>printf</refname>
    <refpurpose>Output een geformatteerde string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>printf</methodname>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Produceert output volgens <parameter>format</parameter>, hetgeen is
     beschreven in de documentatie voor <function>sprintf</function>.
    </simpara>
    <simpara>
     Zie ook: <function>print</function>, <function>sprintf</function>, 
     <function>sscanf</function>, <function>fscanf</function>,
     en <function>flush</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.quoted-printable-decode">
   <refnamediv>
    <refname>quoted_printable_decode</refname>
    <refpurpose>
     Converteert een quoted-printable string naar een 8 bit string
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>quoted_printable_decode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Deze functie retourneert een 8-bit binaire string die correspondeert
     met de gedecodeerde quoted printable string. Deze functie is vergelijkbaar
     met <function>imap_qprint</function>, alleen deze functie heeft geen IMAP 
     module nodig om te werken.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.quotemeta">
   <refnamediv>
    <refname>quotemeta</refname>
    <refpurpose>Quote meta characters</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>quotemeta</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft een versie van str met een backslash (<literal>\</literal>)
     voor elk karakter in deze reeks: <screen>. \\ + * ? [ ^ ] ( $ )</screen>
    </para>
    <simpara>
     Zie ook <function>addslashes</function>,
     <function>htmlentities</function>, 
     <function>htmlspecialchars</function>, 
     <function>nl2br</function>, en
     <function>stripslashes</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.rtrim">
   <refnamediv>
    <refname>rtrim</refname>
    <refpurpose>Verwijder nakomende whitespace.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
     <type>string</type><methodname>rtrim</methodname>
     <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft de argument string terug zonder nakomende whitespace, inclusief
     newlines. Deze functie is een alias voor <function>chop</function>.
     <example>
      <title><function>rtrim</function> example</title>
      <programlisting role="php">
$trimmed = rtrim ($line);
      </programlisting>
     </example>
    </para>
    <para>
     Zie ook <function>trim</function>, <function>ltrim</function>, en
     <function>rtrim</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.sscanf">
   <refnamediv>
    <refname>sscanf</refname>
    <refpurpose>Parset input van een string volgens een format</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>mixed</type><methodname>sscanf</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam>
     </methodsynopsis>
    <para>
     De functie <function>sscanf</function> is de input analoog van
     <function>printf</function>. <function>sscanf</function> leest
     van de string <parameter>str</parameter> en interpreteert die volgens
     de gespecificeerde format. Als alleen twee parameters zouden worden
     meegegeven met deze functie, zal de geparste waarde worden teruggeven
     als een array.
     <example>
      <title><function>sscanf</function> Example</title>
      <programlisting role="php">
// ophalen van serial number
$serial = sscanf(&quot;SN/2350001&quot;,&quot;SN/%d&quot;);
// en de datum van productie
$mandate = &quot;January 01 2000&quot;;
list($month, $day, $year) = sscanf($mandate,&quot;%s %d %d&quot;);
echo &quot;Item $serial was gefabriceerd op: $year-&quot;.substr($month,0,3).&quot;-$day\n&quot;;
      </programlisting>
     </example>
     Als optionele parameters worden meegegeven, zal de functie het aantal
     opgegeven waarden terug geven. De optionele parameters moeten worden
     refentieel worden meegegeven.
     <example>
      <title><function>sscanf</function> - using optional parameters</title>
      <programlisting role="php">
// haal auteursinfo op en genereer DocBook entry
$auth = &quot;24\tLewis Carroll&quot;;
$n = sscanf($auth,&quot;%d\t%s %s&quot;, &amp;$id, &amp;$first, &amp;$last);
echo &quot;&lt;author id='$id'&gt;
&lt;firstname&gt;$first&lt;/firstname&gt;
&lt;surname&gt;$last&lt;/surname&gt;
&lt;/author&gt;\n&quot;;
      </programlisting>
     </example>
    </para>
    <para>
     Zie ook: <function>fscanf</function>, <function>printf</function>,
     en <function>sprintf</function>. 
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.setlocale">
   <refnamediv>
    <refname>setlocale</refname>
    <refpurpose>Definieer locale informatie</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>setlocale</methodname>
      <methodparam><type>string</type><parameter>category</parameter></methodparam>
      <methodparam><type>string</type><parameter>locale</parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>Category</parameter> is een string die de categorie
     specifieert van de functies die worden beinvloed worden door 
     de locale setting:
     <itemizedlist>
      <listitem>
       <simpara>
        LC_ALL voor alle onderstaande
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        LC_COLLATE voor string vergelijking - momenteel niet
        ge&iuml;mplementeerd in PHP
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        LC_CTYPE voor karakter classificatie en conversie, 
        bijvoorbeeld <function>strtoupper</function>
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        LC_MONETARY voor localeconv() - momenteel niet ge&iuml;mplementeerd
        in PHP
       </simpara>
      </listitem>
      <listitem>
       <simpara> 
        LC_NUMERIC voor decimal scheidingsteken
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        LC_TIME voor datum en tijd formattering met
        <function>strftime</function>
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Als <parameter>locale</parameter> een lege string is 
     <literal>&quot;&quot;</literal>, de locale namen zullen gedefinieerd
     worden door de waarden van de environment-variables met dezelfde
     namen als bovenstaande categorieen, of door &quot;LANG&quot;.
    </para>
    <para>
     Als locale 0 of <literal>&quot;0&quot;</literal> is, zal de locale setting
     niet aangetast worden, alleen de huidige setting wordt dan teruggegeven.
    </para>
    <para>
     Setlocale retourneert de nieuwe huidige locale, of &false; als de locale
     functionaliteit niet geimplementeerd is op het platform, de gespecifieerde
     locale niet bestaat of als de categorie naam incorrect is.
     Een incorrecte categorie naam zal ook een waarschuwingsboodschap genereren.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.similar-text">
   <refnamediv>
    <refname>similar_text</refname>
    <refpurpose>
     Berekent de overeenkomsten tussen 2 strings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>similar_text</methodname>
      <methodparam><type>string</type><parameter>first</parameter></methodparam>
      <methodparam><type>string</type><parameter>second</parameter></methodparam>
      <methodparam choice="opt"><type>double</type><parameter>percent</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie berekent de overeenkomsten tussen twee strings
     als beschreven in Oliver [1993]. Merk op dat deze implementatie
     geen stack gebruikt als in Oliver's pseudo code, maar recursieve
     functie-aanroepen die de snelheid van het hele proces niet altijd ten
     goede komen. Merk ook op dat de complexiteit van dit algoritme O(N**3)
     is, waar N de lengte van de langste string is.
    </para>
    <para>
     Door een referentie mee te geven als derde argument, 
     zal <function>similar_text</function> de overeenkomstigheid
     berekenen in procenten. Het geeft het aantal overeenkomende karakters
     in de strings weer.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.soundex">
   <refnamediv>
    <refname>soundex</refname>
    <refpurpose>Berekent de soundex key van een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>soundex</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Berekent de sounex key van <parameter>str</parameter>.
    </para>
    <para>
     Soundex keys hebben de eigenschap dat woorden die overeenkomend
     worden uitgesproken dezelfde soundex key hebben, en kunnen daarom
     gebruikt worden om zoekopdrachten in databases simpeler te maken
     waar je weet wat de uitspraak is, en niet de spelling. 
     Deze functie retourneert een string van 4 karakters, beginnend met
     een letter.
    </para>
    <para>
     Deze funtie is er een die beschreven is door Donald Knuth 
     in &quot;The Art Of Computer Programming, vol. 3: Sorting And
     Searching&quot;, Addison-Wesley (1973), pp. 391-392.
    </para>
    <para>
     <example>
      <title>Soundex Voorbeelden</title>
      <programlisting role="php">
soundex (&quot;Euler&quot;) == soundex (&quot;Ellery&quot;) == 'E460';
soundex (&quot;Gauss&quot;) == soundex (&quot;Ghosh&quot;) == 'G200';
soundex (&quot;Hilbert&quot;) == soundex (&quot;Heilbronn&quot;) == 'H416';
soundex (&quot;Knuth&quot;) == soundex (&quot;Kant&quot;) == 'K530';
soundex (&quot;Lloyd&quot;) == soundex (&quot;Ladd&quot;) == 'L300';
soundex (&quot;Lukasiewicz&quot;) == soundex (&quot;Lissajous&quot;) == 'L222';
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.sprintf">
   <refnamediv>
    <refname>sprintf</refname>
    <refpurpose>Geeft een geformatteerde string weer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>sprintf</methodname>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Geeft een string weer die geproduceerd is volgens de formatting string
     <parameter>format</parameter>.
    </simpara>
    <simpara>
     De format string bestaat uit nul of meer directives:
     normale karakters (uitgezonderd <literal>%</literal>) die
     rechtstreeks gekopieerd worden naar het resultaat, en
     <emphasis>conversie specificaties</emphasis>, die elk resulteren
     in het opvangen van zijn eigen parameter. Dit is van toepassing
     op <function>sprintf</function> als wel <function>printf</function>.
    </simpara>
    <para>
     Elke conversie specificatie bestaat uit een procent teken
     (<literal>%</literal>), gevolgd door een of meer van deze 
     elementen, in volgorde:
     <orderedlist>
      <listitem>
       <simpara>
        Een optionele <emphasis>padding specifier</emphasis> die
        bepaalt welk karakter er wordt gebruikt voor het padden
        van de resultaten naar de correcte string lengte.
        Dit kan een space karakter of een <literal>0</literal> (nul 
        karakter) zijn. Een afwisselend padding karakter kan gespecificeerd
        worden door een enkele quote (<literal>'</literal>) mee te geven.
        Zie de voorbeelden hieronder.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Een optionele <emphasis>alignment specifier</emphasis> die vertelt
        of het resultaat links of rechts uitgelijnd moet worden.
        De default is rechts uitgelijnd; een <literal>-</literal> karakter
        kan gebruikt worden voor het links uitlijnen.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Een optioneel nummer, een <emphasis>width specifier</emphasis>
        die vertelt hoeveel karakters (minimaal) in moet resulteren.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Een optionele <emphasis>precision specifier</emphasis> die vertelt
        hoeveel decimale cijfers er moeten weergegeven voor floating-point
        getallen. Deze optie heeft geen effect op andere types dan double.
        (Een andere functie die nuttig is voor het formatteren van nummers
        is <function>number_format</function>.)
       </simpara>
      </listitem>
      <listitem>
       <para>
        Een <emphasis>type specifier</emphasis> die vertelt volgens welk
        type de argument data moet behandeld worden. Mogelijke types:
        <simplelist>
         <member>
          <literal>%</literal> - een literal procent karakter. Geen
          argument nodig.
         </member>
         <member>
          <literal>b</literal> - het argument wordt behandeld als een 
          integer, en gepresenteerd als een binair getal.
         </member>
         <member>
          <literal>c</literal> - het argument wordt behandeld als een
          integer, en gepresenteerd als het karakter met die ASCII waarde.
         </member>
         <member>
          <literal>d</literal> - het argument wordt behandeld als een 
          integer, en gepresenteerd als een decimaal nummer.
         </member>
         <member>
          <literal>f</literal> - het argument wordt behandeld als een double,
          en wordt gepresenteerd als een floating point nummer.
         </member>
         <member>
          <literal>o</literal> - het argument wordt behandeld als een 
          integer, and gepresenteerd als een octaal nummer.
         </member>
         <member>
          <literal>s</literal> - het argument wordt behandeld als en
          gepresenteerd als een string.
         </member>
         <member>
          <literal>x</literal> - het argument wordt behandeld als een integer
          en gepresenteerd als een hexadecimal number (met kleine
          letters).
         </member>
         <member>
          <literal>X</literal> - het argument wordt behandeld als een integer
          en gepresenteerd als een hexadecimaal nummer (met hoofdletters).
         </member>
        </simplelist>
       </para>
      </listitem>
     </orderedlist>
    </para>
    <simpara>
     Zie ook: <function>printf</function>, <function>sscanf</function>,
     <function>fscanf</function>, en <function>number_format</function>.
    </simpara>
   </refsect1>
   <refsect1>
    <title>Voorbeelden</title>
    <para>
     <example>
      <title><function>sprintf</function>: nul-padded integers</title>
      <programlisting role="php">
$isodate = sprintf (&quot;%04d-%02d-%02d&quot;, $year, $month, $day);
      </programlisting>
     </example>
     <example>
      <title><function>sprintf</function>: formatteren van valuta-eenheden</title>
      <programlisting role="php">
$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money zal geven &quot;123.1&quot;;
$formatted = sprintf (&quot;%01.2f&quot;, $money);
// echo $formatted zal geven &quot;123.10&quot;
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strcasecmp">
   <refnamediv>
    <refname>strcasecmp</refname>
    <refpurpose>
     Binary safe hoofdletter ongevoelige string vergelijking
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>strcasecmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retourneert &lt; 0 als <parameter>str1</parameter> minder is 
     dan <parameter>str2</parameter>; &gt; 0 als <parameter>str1</parameter>
     groter is dan <parameter>str2</parameter>, en 0 als deze gelijk zijn.
    <example>
      <title><function>strcasecmp</function> voorbeeld</title>
      <programlisting role="php">
$var1 = &quot;Hallo&quot;;
$var2 = &quot;hallo&quot;;
if (!strcasecmp ($var1, $var2)) {
    echo '$var1 is gelijk aan $var2 in een hoofdletter ongevoelige string vergelijking';
}
      </programlisting>
    </example>
    </para>
    <simpara>
     Zie ook <function>ereg</function>, <function>strcmp</function>,
     <function>substr</function>, <function>stristr</function>, en
     <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.strchr">
   <refnamediv>
    <refname>strchr</refname> 
    <refpurpose>
     Vind de eerst voorkomende positie van een karakter
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>strchr</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie is een alias voor <function>strstr</function> en is
     identiek in alle opzichten.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strcmp">
   <refnamediv>
    <refname>strcmp</refname>
    <refpurpose>Binary safe string vergelijking</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>strcmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Geeft &lt; 0 terug als <parameter>str1</parameter> minder is dan
     <parameter>str2</parameter>; &gt; 0 als <parameter>str1</parameter>
     groter is dan <parameter>str2</parameter>, en 0 als ze gelijk zijn.
    </simpara>
    <simpara>
     Merk op dat deze functie hoofdletter gevoelig is.
    </simpara>
    <simpara>
     Zie ook <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strncmp</function>,
     en <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.strcspn">
   <refnamediv>
    <refname>strcspn</refname>
    <refpurpose>
     Vind de lengte van een initieel segment die niet aan de mask voldoet
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>strcspn</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Geeft de lengte van het initiele segment van <parameter>str1</parameter>
     die <emphasis>geen</emphasis> van de karakters in <parameter>str2</parameter>
     bevat.
    </simpara>
    <simpara>
     Zie ook <function>strspn</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.strip-tags">
   <refnamediv>
    <refname>strip_tags</refname>
    <refpurpose>Strip HTML en PHP tags van een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>strip_tags</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze funtie probeert alle HTML en PHP tags te strippen van de
     gegeven string. Het gebruikt dezelfde tag stripping methodiek
     als <function>fgetss</function> functie.
    </para>
    <para>
     Je kan de optionele tweede parameter gebruiken om tags te specifieren
     die niet gestript moeten worden.
     <note>
      <para>
       <parameter>Allowable_tags</parameter> was toegevoegd in PHP 3.0.13,
       PHP4B3.
      </para> 
     </note>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.stripcslashes">
   <refnamediv>
    <refname>stripcslashes</refname>
    <refpurpose>
     Un-quote een string quoted met <function>addcslashes</function>
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>stripcslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft een string terug met backslashes gestript. Herkent C-achtige
     <literal>\n</literal>, <literal>\r</literal> ..., octale en
     hexadecimale representatie.
     <note>
      <simpara>
       Toegevoegd in PHP4b3-dev.
      </simpara>
     </note>
    </para>
    <simpara>
     Zie ook <function>addcslashes</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.stripslashes">
   <refnamediv>
    <refname>stripslashes</refname>
    <refpurpose>
     Un-quote een string quoted met <function>addslashes</function>
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>stripslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft een string met backslashes gestript. (<literal>\'</literal> wordt
     <literal>'</literal> enzovoort.)
     Dubbele backslashes worden enkele backslashes.
    </para>
    <simpara>
     Zie ook <function>addslashes</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.stristr">
   <refnamediv>
    <refname>stristr</refname>
    <refpurpose>
     Hoofdletter-ongevoelige <function>strstr</function>
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>stristr</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft alle van <parameter>haystack</parameter> van het eerste voorkomen
     van <parameter>needle</parameter> naar het eind.
     <parameter>needle</parameter> en <parameter>haystack</parameter>
     worden behandeld op een hoofdletter-ongevoelige manier.
    </para>
    <para>
     Als <parameter>needle</parameter> niet gevonden wordt, geeft &false;.
    </para>
    <para>
     Als <parameter>needle</parameter> geen string is, wordt die geconverteerd
     naar een integer en toegepast als de ordinale waarde van een karakter.
    </para>
    <para>
     Zie ook <function>strchr</function>,
     <function>strrchr</function>, <function>substr</function>, en
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strlen">
   <refnamediv>
    <refname>strlen</refname>
    <refpurpose>Haal string lengte op</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>strlen</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft de lengte van <parameter>string</parameter>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strnatcmp">
   <refnamediv>
    <refname>strnatcmp</refname>
    <refpurpose>
     String vergelijking gebruikmakend van een "natural order" algoritme
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>strnatcmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie implementeert een vergelijkingsalgoritme die
     alfanumerieke strings sorteert op een manier zoals een mens
     dat zou doen, dit is beschreven als een &quot;natural ordering&quot;.
     Een voorbeeld van het verschil tussen dit algoritme en normale
     computer string sorting algoritmes (gebruikt in <function>strcmp</function>)
     kan je hieronder vinden.
     <informalexample>
      <programlisting>
$arr1 = $arr2 = array (&quot;img12.png&quot;,&quot;img10.png&quot;,&quot;img2.png&quot;,&quot;img1.png&quot;);
echo &quot;Standard string vergelijking\n&quot;;
usort($arr1,&quot;strcmp&quot;);
print_r($arr1);
echo &quot;\nNatural order string vergelijking\n&quot;;
usort($arr2,&quot;strnatcmp&quot;);
print_r($arr2);
      </programlisting>
     </informalexample>
     De code hierboven zal de volgende output genereren:
     <informalexample>
      <programlisting>
Standaard string vergelijking
Array
(
    [0] =&gt; img1.png
    [1] =&gt; img10.png
    [2] =&gt; img12.png
    [3] =&gt; img2.png
)

Natural order string vergelijking
Array
(
    [0] =&gt; img1.png
    [1] =&gt; img2.png
    [2] =&gt; img10.png
    [3] =&gt; img12.png
)
      </programlisting>
     </informalexample>
     Voor meer informatie zie: Martin Pool's <ulink
     url="&url.strnatcmp;">Natural Order String Comparison</ulink>
     page.
    </para>
    <simpara>
     Vergelijkbaar met andere string vergelijking functies, retourneert deze
     functie &lt; 0 als <parameter>str1</parameter> minder is dan
     <parameter>str2</parameter>; &gt; 0 als <parameter>str1</parameter>
     groter is dan <parameter>str2</parameter>, en 0 als deze gelijk zijn.
    </simpara>
    <simpara>
     Merk op dat deze functie hoofdletter gevoelig is.
    </simpara>
    <simpara>
     Zie ook <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strcmp</function>,
     <function>strncmp</function>, <function>strnatcasecmp</function>,
     <function>strstr</function>, <function>natsort</function> en
     <function>natcasesort</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.strnatcasecmp">
   <refnamediv>
    <refname>strnatcasecmp</refname>
    <refpurpose>
     Hoofdletter ongevoelige string vergelijking gebruik makend van een
     &quot;natural order&quot; algoritme
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>strnatcasecmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie implementeert een vergelijkingsalgoritme die 
     alfanumerieke strings sorteert op een manier zoals mensen
     dat zouden doen. Het gedrag van deze functie is vergelijkbaar
     met <function>strnatcmp</function>, behalve dat de vergelijking
     niet hoofdletter gevoelig is. 
     Voor meer informatie zie: Martin Pool's
     <ulink url="&url.strnatcmp;">Natural Order String
     Comparison</ulink> pagina.
    </para>
    <simpara>
     Vergelijkbaar met andere string vergelijking functies, geeft deze
     functie &lt; 0 als <parameter>str1</parameter> kleiner is dan
     <parameter>str2</parameter>; &gt; 0 als <parameter>str1</parameter>
     groter is dan <parameter>str2</parameter>, en 0 als deze gelijk zijn.
    </simpara>
    <simpara>
     Zie ook <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strcmp</function>,
     <function>strncmp</function>, <function>strnatcmp</function>,
     en <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.strncmp">
   <refnamediv>
    <refname>strncmp</refname>
    <refpurpose>
     Binary safe string vergelijking van de eerste n karakters
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>strncmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
      <methodparam><type>int</type><parameter>len</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie is vergelijkbaar met <function>strcmp</function>, met 
     het verschil dat je het aantal karakters (<parameter>len</parameter>)
     kan specifieren van de string die in de vergelijking gebruikt moet worden.
     Als 1 van de strings korter is dan <parameter>len</parameter> dan zal de
     lengte van de string gebruikt worden.
    </para>
    <simpara>
     Geeft &lt; 0 terug als <parameter>str1</parameter> kleiner is dan
     <parameter>str2</parameter>; &gt; 0 als <parameter>str1</parameter>
     groter is dan <parameter>str2</parameter>, en 0 als beide gelijk zijn.
    </simpara>
    <simpara>
     Merk op dat deze vergelijking hoofdletter gevoelig is.
    </simpara>
    <simpara>
     Zie ook <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strcmp</function>,
     en <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.str-pad">
   <refnamediv>
    <refname>str_pad</refname>
    <refpurpose>Pad een string naar een bepaalde lengte met een andere string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>str_pad</methodname>
      <methodparam><type>string</type><parameter>input</parameter></methodparam>
      <methodparam><type>int</type><parameter>pad_length</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>pad_string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>pad_type</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie pad ('vult op') de <parameter>input</parameter> string
     links, rechts of beide kanten op tot de gespecifieerde lengte.
     Als het optionele argument <parameter>pad_string</parameter>
     niet beschikbaar is dan wordt <parameter>input</parameter> gepad
     met spaties, anders wordt de string gepad met karakters van
     <parameter>pad_string</parameter> tot aan het opgegeven maximum.
    </para>

    <para>
     Optioneel argument <parameter>pad_type</parameter> kan zijn
     STR_PAD_RIGHT, STR_PAD_LEFT, of STR_PAD_BOTH.  Als
     <parameter>pad_type</parameter> niet is gegeven, wordt uitgegaan van
     STR_PAD_RIGHT.
    </para>
    
    <para>
     Als de waarde van <parameter>pad_length</parameter> negatief is of
     kleiner dan de lengte van de input string, vindt er geen padding plaats.
    </para>

    <para>
     <example>
      <title><function>str_pad</function> voorbeeld</title>
      <programlisting role="php">
$input = &quot;Alien&quot;;
print str_pad($input, 10);                      // produceert &quot;Alien     &quot;
print str_pad($input, 10, &quot;-=&quot;, STR_PAD_LEFT);  // produceert &quot;-=-=-Alien&quot;
print str_pad($input, 10, &quot;_&quot;, STR_PAD_BOTH);   // produceert &quot;__Alien___&quot;
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strpos">
   <refnamediv>
    <refname>strpos</refname>
    <refpurpose>
     Vindt de positie van het eerste voorkomen van een string
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>strpos</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft de numerieke positie van het eerste voorkmen van
     <parameter>needle</parameter> in <parameter>haystack</parameter>.
     Verschillend van de <function>strrpos</function>, kan deze functie
     een hele string gebruiken als <parameter>needle</parameter> parameter,
     die dan ook in zijn geheel gebruikt zal worden.
    </para>
    <para>
     Als <parameter>needle</parameter> niet wordt gevonden, geeft deze functie &false;.
     <note>
      <para>
       De return waardes &quot;character found at position 0&quot; en &quot;character not found&quot;
       worden nogal eens door elkaar gehaald. Hier is de code om het verschil
       te detecteren:
       <informalexample>
        <programlisting role="php">
// in PHP 4.0b3 en nieuwer:
$pos = strpos ($mystring, &quot;b&quot;);
if ($pos === false) { // opmerking: drie equal signs
    // niet gevonden...
}

// in versies ouder dan 4.0b3:
$pos = strpos ($mystring, &quot;b&quot;);
if (is_string ($pos) &amp;&amp; !$pos) {
    // niet gevonden...
}
        </programlisting>
       </informalexample>
      </para>
     </note>
    </para>
    <para>
     Als <parameter>needle</parameter> geen string is, zal die geconverteerd
     worden naar een integer en toegepast worden als de ordinale waarde van een 
     karakter.
    </para>
    <para>
     De optionele <parameter>offset</parameter> parameter maakt het 
     mogelijk om te specifieren bij welk karakter in <parameter>haystack</parameter>
     begonnen moet worden met zoeken. De positie die teruggegeven wordt is
     nog steeds relatief met het begin van <parameter>haystack</parameter>.
    </para>
    <para>
     Zie ook <function>strrpos</function>,
     <function>strrchr</function>, <function>substr</function>,
     <function>stristr</function>, en <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strrchr">
   <refnamediv>
    <refname>strrchr</refname>
    <refpurpose>
     Vindt de positie van het laatste voorkomen van een string
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>strrchr</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie retourneert het gedeelte van <parameter>haystack</parameter>
     die start met het laatste voorkomen van <parameter>needle</parameter> en
     gaat door tot het eind van <parameter>haystack</parameter>.
    </para>
    <para>
     Geeft &false; als <parameter>needle</parameter> niet gevonden wordt.
    </para>
    <para>
     Als <parameter>needle</parameter> meer dan 1 karakter bevat, wordt
     het eerste karakter gebruikt.
    </para>
    <para>
     Als <parameter>needle</parameter> geen string is, wordt deze 
     geconverteerd naar een integer en toegepast als de ordinale
     waarde van een karakter.
     <example>
      <title><function>strrchr</function> example</title>
      <programlisting role="php">
// vind de laatste directory in $PATH
$dir = substr (strrchr ($PATH, &quot;:&quot;), 1);

// pak alles na de laatste newline
$text = &quot;Line 1\nLine 2\nLine 3&quot;;
$last = substr (strrchr ($text, 10), 1 );
      </programlisting>
     </example>
    </para>
    <para>
     Zie ook <function>substr</function>,
     <function>stristr</function>, en <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.str-repeat">
   <refnamediv>
    <refname>str_repeat</refname>
    <refpurpose>Herhaalt een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>str_repeat</methodname>
      <methodparam><type>string</type><parameter>input</parameter></methodparam>
      <methodparam><type>int</type><parameter>multiplier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft <parameter>multiplier</parameter> herhalingen
     van <parameter>input_str</parameter>.
     <parameter>multiplier</parameter> moet groter zijn dan 0.
    </para>
    <example>
     <title><function>str_repeat</function> voorbeeld</title>
     <programlisting role="php">
echo str_repeat (&quot;-=&quot;, 10);
     </programlisting>
    </example>
    <para>
     Dit geeft &quot;-=-=-=-=-=-=-=-=-=-=&quot;.
    </para>
    <note>
     <para>
      Deze functie was toegevoegd in PHP 4.0.
     </para> 
    </note>
   </refsect1>
  </refentry>
  
  <refentry id="function.strrev">
   <refnamediv>
    <refname>strrev</refname>
    <refpurpose>Draait een string om</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>strrev</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft <parameter>string</parameter> omgekeerd.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strrpos">
   <refnamediv>
    <refname>strrpos</refname>
    <refpurpose>
     Vindt de positie van het laatste voorkomen van een karakter in een string
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>strrpos</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>char</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft de numerieke positie van het laatste voorkomen van
     <parameter>needle</parameter> in de <parameter>haystack</parameter>
     string. Merk op dat needle deze keer alleen een enkel karakter kan
     zijn. Als in plaats daarvan een hele string wordt gegeven als de 
     needle wordt alleen het eerste karakter van die string gebruikt.
    </para>
    <para>
     Als <parameter>needle</parameter> niet wordt gevonden retourneert
     deze functie &false;.
    </para>
    <para>
     Als <parameter>needle</parameter> geen string is, wordt het
     geconverteerd naar een integer en toegepast als de ordinale
     waarde van het karakter.
    </para>
    <para>
     Zie ook <function>strpos</function>,
     <function>strrchr</function>, <function>substr</function>,
     <function>stristr</function>, en <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strspn">
   <refnamediv>
    <refname>strspn</refname>
    <refpurpose>
     Vindt de lengte van een initieel segment invoermasker
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>strspn</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Geeft de lengte van het initieel segment van
     <parameter>str1</parameter> die uitsluitend bestaat uit
     karakters in <parameter>str2</parameter>.
    </simpara>
    <para>         
     <informalexample>
      <programlisting role="php">
strspn (&quot;42 is het antwoord, wat is de vraag ...&quot;, &quot;1234567890&quot;);
      </programlisting>
      <para>
       zal 2 als resultaat geven. 
      </para>
     </informalexample>
    </para>
    <simpara>
     Zie ook <function>strcspn</function>.
    </simpara>
   </refsect1>
  </refentry>
  
  <refentry id="function.strstr">
   <refnamediv>
    <refname>strstr</refname>
    <refpurpose>Vindt eerste voorkomen van een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>strstr</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft alles van <parameter>haystack</parameter> van het
     eerste voorkomen van <parameter>needle</parameter> tot het 
     einde.
    </para>
    <para>
     Als <parameter>needle</parameter> niet gevonden wordt, retourneert
     deze functie &false;.
    </para>
    <para>
     Als <parameter>needle</parameter> geen string is, wordt deze geconverteerd
     naar een integer en toegepast als de ordinale waarde van dat karakter.
    </para>
    <para>
     <note>
      <para>
       Onthoud dat deze functie hoofdletter-gevoelig is. Voor niet hoofdletter-gevoelige
       toepassingsdoeleinden kan je <function>stristr</function> gebruiken.
      </para>
     </note>
    </para>
    <para>
     <example>
      <title><function>strstr</function> voorbeeld</title>
      <programlisting role="php">
$email = 'sterling@designmultimedia.com';
$domain = strstr ($email, '@');
print $domain; // print @designmultimedia.com
      </programlisting>
     </example> 
    </para>
    <para>
     Zie ook <function>stristr</function>,
     <function>strrchr</function>, <function>substr</function>, en 
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strtok">
   <refnamediv>
    <refname>strtok</refname>
    <refpurpose>Verdeelt string in tokens</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>strtok</methodname>
      <methodparam><type>string</type><parameter>arg1</parameter></methodparam>
      <methodparam><type>string</type><parameter>arg2</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>strtok</function> wordt gebruikt om een string in
     tokens te verdelen. Bijvoorbeeld als je een string hebt als
     &quot;Dit is een voorbeeld string&quot; zou je deze kunnen verdelen
     in individuele woorden door de spatie als token te geven.
     <example>
      <title><function>strtok</function> voorbeeld</title>
      <programlisting role="php">
$string = &quot;Dit is een voorbeeld string&quot;;
$tok = strtok ($string,&quot; &quot;);
while ($tok) {
    echo &quot;Word=$tok&lt;br>&quot;;
    $tok = strtok (&quot; &quot;);
}
      </programlisting>
     </example>
    </para>
    <para>
     Merk op dat alleen de eerste aanroep naar strtok het string
     argument gebruikt. Bij elke volgende aanroep heeft strtok
     alleen het token nodig, omdat het bijhoudt waar men gebleven
     is in de string. Om opnieuw te beginnen of om een nieuwe
     string te verdelen in tokens roep je strtok simpelweg aan
     met het string argument om te initialiseren. Ja kan overigens
     meerdere tokens in de token parameter megeven. De string zal
     verdeeld worden wanneer ook maar 1 karakter in het argument
     gevonden is.
    </para>
    <para>
     Wees trouwens voorzichtig met gevallen wanneer je tokens gelijk
     zijn aan &quot;0&quot;. In conditionele expressies zal dit naar &false;
     evalueren.
    </para>
    <para>
     Zie ook <function>split</function> en
     <function>explode</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strtolower">
   <refnamediv>
    <refname>strtolower</refname>
    <refpurpose>Maak een string lowercase</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>strtolower</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft <parameter>string</parameter> met alle alfabetische
     karakters geconverteerd naar lowercase.
    </para>
    <para>
     Weet dat 'alfabetisch' wordt bepaald door de huidige locale. Dit
     betekent bijvoorbeeld dat in de default &quot;C&quot; locale, karakters als
     umlaut-A () niet zullen worden geconverteerd.
    </para>
    <example>
     <title><function>strtolower</function> voorbeeld</title>
     <programlisting role="php">
$str = &quot;Mary Had A Little Lamb and She LOVED It So&quot;;
$str = strtolower($str);
print $str; # Print mary had a little lamb and she loved it so
     </programlisting>
    </example>
    <para>
     Zie ook <function>strtoupper</function>
     en <function>ucfirst</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strtoupper">
   <refnamediv>
    <refname>strtoupper</refname>
    <refpurpose>Maak een string uppercase</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>strtoupper</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Geeft <parameter>string</parameter> met alle alfabetische
     karakters geconverteerd naar uppercase.
    </para>
    <para>
     Weet dat 'alfabetisch' wordt bepaald door de huidige locale. Dit
     betekent bijvoorbeeld dat in de default &quot;C&quot; locale, karakters als
     umlaut-A () niet zullen worden geconverteerd.
    </para>
    <example>
     <title><function>strtoupper</function> voorbeeld</title>
     <programlisting role="php">
$str = &quot;Mary Had A Little Lamb and She LOVED It So&quot;;
$str = strtoupper ($str);
print $str; # Print MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
     </programlisting>
    </example>
    <para>
     Zie ook <function>strtolower</function>
     en <function>ucfirst</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.str-replace">
   <refnamediv>
    <refname>str_replace</refname>
    <refpurpose>
     Vervang alle voorkomens van needle in haystack met str
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>str_replace</methodname>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie vervangt alle voorkomens van <parameter>needle</parameter>
     in <parameter>haystack</parameter> met de gegeven <parameter>str</parameter>.
     Als je geen al te toffe vervangingsregels nodig hebt, wordt aangeraden
     om altijd deze functie te gebruiken in plaats van <function>ereg_replace</function>.
    </para>
    <para>
     <example>
      <title><function>str_replace</function> voorbeeld</title>
      <programlisting role="php">
$bodytag = str_replace (&quot;%body%&quot;, &quot;black&quot;, &quot;&lt;body text=%body%>&quot;);
      </programlisting>
     </example>
    </para>
    <para>
     Deze functie is binary safe.
    </para>
    <note>
     <para>
      <function>str_replace</function> was toegevoegd in PHP 3.0.6, maar
      was buggy tot PHP 3.0.8.
     </para>
    </note>
    <para>
     Zie ook <function>ereg_replace</function> en 
     <function>strtr</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.strtr">
   <refnamediv>
    <refname>strtr</refname>
    <refpurpose>Vertaal bepaalde karaketers</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>strtr</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam><type>string</type><parameter>from</parameter></methodparam>
      <methodparam><type>string</type><parameter>to</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie heeft effect op <parameter>str</parameter>, en vertaalt
     alle voorkomens van elk karakter in <parameter>from</parameter>
     naar het overeenkomende karakter in <parameter>to</parameter> en
     retourneert het resultaat.
    </para>
    <para>
     Als <parameter>from</parameter> en <parameter>to</parameter> van
     verschillende lengte zijn, zullen de extra karakters in de langste
     van de twee genegeerd worden.
     <example>
      <title><function>strtr</function> voorbeeld</title>
      <programlisting role="php">
$addr = strtr($addr, &quot;&quot;, &quot;aao&quot;);
      </programlisting>
     </example>
    </para>
    <para>
     <function>strtr</function> kan aangeroepen worden
     met alleen twee argumenten. Als de functie wordt aangeroepen 
     met twee argumenten, reageert deze op een nieuwe manier:
     <parameter>from</parameter> moet dan een array zijn die 
     string -> string paren bevat die worden vervangen in de source
     string. <function>strtr</function> kijkt altijd eerst voor de langst
     mogelijke match en zal *NIET* proberen om iets te vervangen wat
     al behandeld is.
    </para>
    <para>
     Examples:
     <informalexample>
      <programlisting role="php">
$trans = array (&quot;hello&quot; =&gt; &quot;hi&quot;, &quot;hi&quot; =&gt; &quot;hello&quot;);
echo strtr(&quot;hi all, I said hello&quot;, $trans) . &quot;\n&quot;;
      </programlisting>
     </informalexample>
     Dit geeft weer: &quot;hello all, I said hi&quot;,
    </para>
    <note>
     <simpara>
      Deze feature (twee argumenten) was toegevoegd in PHP 4.0.
     </simpara>
    </note>
    <para>
     Zie ook <function>ereg_replace</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.substr">
   <refnamediv>
    <refname>substr</refname>
    <refpurpose>Geeft gedeelte van een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>substr</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam><type>int</type><parameter>start</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <para>
     Substr geeft een gedeelte van <parameter>string</parameter>
     gespecificeerd door de <parameter>start</parameter>
     en <parameter>length</parameter> parameters.
    </para>
    <para>
     Als <parameter>start</parameter> positief is, begint de terug
     te geven string bij de positie van <parameter>start</parameter>
     in <parameter>string</parameter>, beginnend vanaf nul. 
     Bijvoorbeeld in de string '<literal>abcdef</literal>', het 
     karakter op positie <literal>0</literal> is '<literal>a</literal>',
     het karakter op positie <literal>2</literal> is '<literal>c</literal>',
     enzovoort.
    </para>
    <para>
     Voorbeeld:
     <informalexample>
      <programlisting role="php">
$rest = substr (&quot;abcdef&quot;, 1);    // geeft &quot;bcdef&quot;
$rest = substr (&quot;abcdef&quot;, 1, 3); // geeft &quot;bcd&quot;
      </programlisting>
     </informalexample>
    </para>
    <para>
     Als <parameter>start</parameter> negatief is, zal de terug te
     geven string beginnen op de positie van <parameter>start</parameter>
     vanaf het einde van <parameter>string</parameter>.</para>
    <para>
     Voorbeelden:
     <informalexample>
      <programlisting role="php">
$rest = substr (&quot;abcdef&quot;, -1);    // geeft &quot;f&quot;
$rest = substr (&quot;abcdef&quot;, -2);    // geeft &quot;ef&quot;
$rest = substr (&quot;abcdef&quot;, -3, 1); // geeft &quot;d&quot;
      </programlisting>
     </informalexample>
    </para>
    <para>
     Als <parameter>length</parameter> gegeven is en die positief is,
     zal de terug te geven string eindigen <parameter>length</parameter>
     karakters van <parameter>start</parameter>. Als deze zou resulteren
     in een string met een negatieve lengte (omdat de start na het einde
     van de string is), dan zal de terug te geven string alleen het karakter
     op de positie van <parameter>start</parameter> bevatten.
    </para>
    <para>
     Als <parameter>length</parameter> gegeven is en die negatief is,
     zal de terug te geven string eindigen <parameter>length</parameter>
     karakters vanaf het eind van <parameter>string</parameter>. Als deze
     zou resulteren in een string met een negatieve lengte, dan zal de
     terug te geven string alleen het karakter op de positie van
     <parameter>start</parameter> bevatten.
    </para>
    <para>
     Voorbeelden:
     <informalexample>
      <programlisting role="php">
$rest = substr (&quot;abcdef&quot;, 1, -1); // geeft &quot;bcde&quot;
      </programlisting>
     </informalexample>
    </para>
    <para>
     Zie ook <function>strrchr</function> en
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.substr-count">
   <refnamediv>
    <refname>substr_count</refname>
    <refpurpose>Telt het aantal substrings in een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>int</type><methodname>substr_count</methodname>
      <methodparam><type>string</type><parameter>haystrack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>substr_count</function> geeft het aantal keren dat
     de <parameter>needle</parameter> substring voorkomt in 
     <parameter>haystack</parameter>.
    </para>

    <para>
     <example>
      <title><function>substr_count</function> voorbeeld</title>
      <programlisting>
print substr_count(&quot;This is a test&quot;, &quot;is&quot;); // geeft 2
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.substr-replace">
   <refnamediv>
    <refname>substr_replace</refname>
    <refpurpose>Vervangt tekst in een gedeelte van een string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>substr_replace</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam><type>string</type><parameter>replacement</parameter></methodparam>
      <methodparam><type>int</type><parameter>start</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>substr_replace</function> vervangt een gedeelte van
     <parameter>string</parameter> delimited door
     <parameter>start</parameter> en (optioneel)
     <parameter>length</parameter> parameters met de string gegeven in
     <parameter>replacement</parameter>. Het resultaat wordt weergegeven.
    </para>
    <para>
     Als <parameter>start</parameter> positief is, zal het vervangen
     beginnen bij <parameter>start</parameter> als offset in
     <parameter>string</parameter>.
    </para>
    <para>
     Als <parameter>start</parameter> negatief is, zal het vervangen
     beginnen bij positie <parameter>start</parameter> vanaf het einde
     van de <parameter>string</parameter>.
    </para>
    <para>
     Als <parameter>length</parameter> gegeven is en die positief is,
     representeert het de lengte van het gedeelte van <parameter>string</parameter>
     die vervangen moet worden.  Als <parameter>length</parameter> negatief is,
     representeert het het aantal karakters vanaf het eind van
     <parameter>string</parameter> waar die moet stoppen met vervangen. 
     Wanneer niet gegeven, dan zal dat resulteren in de default 
     strlen(<parameter>string</parameter>); dus stoppen met vervangen
     aan het einde van <parameter>string</parameter>.
    </para>
    <para>
     <example>
      <title><function>substr_replace</function> voorbeeld</title>
      <programlisting role="php">
&lt;?php
$var = 'ABCDEFGH:/MNRPQR/';
echo &quot;Original: $var&lt;hr&gt;\n&quot;;

/* Deze twee voorbeelden vervangen alles van $var with 'bob'. */
echo substr_replace ($var, 'bob', 0) . &quot;&lt;br&gt;\n&quot;;
echo substr_replace ($var, 'bob', 0, strlen ($var)) . &quot;&lt;br&gt;\n&quot;;

/* Voegt 'bob' aan het begin van $var. */
echo substr_replace ($var, 'bob', 0, 0) . &quot;&lt;br&gt;\n&quot;;

/* Deze volgende twee vervangen 'MNRPQR' in $var met 'bob'. */
echo substr_replace ($var, 'bob', 10, -1) . &quot;&lt;br&gt;\n&quot;;
echo substr_replace ($var, 'bob', -7, -1) . &quot;&lt;br&gt;\n&quot;;

/* Verwijder 'MNRPQR' van $var. */
echo substr_replace ($var, '', 10, -1) . &quot;&lt;br&gt;\n&quot;;
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Zie ook <function>str_replace</function> en
     <function>substr</function>.
    </para>
    <note>
     <simpara>
      <function>substr_replace</function> was toegevoegd in PHP 4.0.
     </simpara>
    </note>
   </refsect1>
  </refentry>
  
  <refentry id="function.trim">
   <refnamediv>
    <refname>trim</refname> 
    <refpurpose>
     Stript whitespace van het begin en eind van een string
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>trim</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deze functie stript whitespace van het begin en einde van een
     string en geeft de gestripte string terug. De whitespace karakters
     die het stript zijn: &quot;\n&quot;, &quot;\r&quot;, &quot;\t&quot;, &quot;\v&quot;, &quot;\0&quot;, en een normale
     space.
    </para>
    <para>
     Zie ook <function>chop</function>, <function>rtrim</function> en
     <function>ltrim</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.ucfirst">
   <refnamediv>
    <refname>ucfirst</refname> 
    <refpurpose>Maakt het eerste karakter van een string uppercase</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>ucfirst</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Maakt van het eerste karaketer van <parameter>str</parameter>
     een hoofdletter als die alfabetisch is.
    </para>
    <para>
     Merk op dat 'alfabetisch' wordt bepaald door de huidige locale.
     Bijvoorbeeld, in de normale &quot;C&quot; locale karakters worden karakters
     als umlaut-a () niet geconverteerd.
     <example>
      <title><function>ucfirst</function> example</title>
      <programlisting role="php">    
$text = 'mary had a little lamb and she loved it so.';
$text = ucfirst ($text); // $text is nu Mary had a little lamb 
                         // and she loved it so.
      </programlisting>
     </example>
    </para>
    <para>
     Zie ook <function>strtoupper</function> en
     <function>strtolower</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.ucwords">
   <refnamediv>
    <refname>ucwords</refname> 
    <refpurpose>
     Maakt van het eerste karakter van elk woord in een string een uppercase
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>ucwords</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Maakt van het eerste karakter van elk woord in 
     <parameter>str</parameter> als dit karakter alfabetisch
     is.
     <example>
      <title><function>ucwords</function> voorbeeld</title>
      <programlisting role="php">
$text = &quot;mary had a little lamb and she loved it so.&quot;;
$text = ucwords($text); // $text is now: Mary Had A Little 
                        // Lamb And She Loved It So.
      </programlisting>
     </example>
    </para>
    <para>
     Zie ook <function>strtoupper</function>,
     <function>strtolower</function> en <function>ucfirst</function>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.wordwrap">
   <refnamediv>
    <refname>wordwrap</refname>
    <refpurpose>
     Wrapt een string tot een gegeven aantal karakters gebruikmakend van een string
     break karakter.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Omschrijving</title>
     <methodsynopsis>
      <type>string</type><methodname>wordwrap</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>width</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>break</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>cut</parameter></methodparam>
     </methodsynopsis>
    <para>
     Wrapt de string <parameter>str</parameter> op basis van
     het column nummer gespecificeerd door de (optionele) <parameter>width</parameter>.
     De regel wordt gebroken gebruikmakend van de (optionele) <parameter>break</parameter>
     parameter.
    </para>
    <para>
     <function>wordwrap</function> zal automatisch wrappen op column
     75 en breken gebruik makend van '\n' (newline) als <parameter>width</parameter>
     of <parameter>break</parameter> niet zijn gegeven.
    </para>
    <para>
     Als <parameter>cut</parameter> 1 is, wordt de string altijd 
     gewrapt naar de gegeven width. Dus als je een woord hebt dat langer
     is dan de gegeven width, wordt die gebroken (zie tweede voorbeeld).
    </para>
    <para>
     <example>
      <title><function>wordwrap</function> voorbeeld</title>
      <programlisting role="php">
$text = &quot;The quick brown fox jumped over the lazy dog.&quot;;
$newtext = wordwrap( $text, 20 );

echo &quot;$newtext\n&quot;;
      </programlisting>
     </example>
    </para>
    <para>
     Dit voorbeeld zou geven:
    </para>
    <para>
     <informalexample>
      <programlisting>
The quick brown fox
jumped over the lazy dog.
      </programlisting>
     </informalexample>
    </para>
    <para>
     <example>
      <title><function>wordwrap</function> example</title>
      <programlisting role="php">
$text = &quot;Een heel lang woooooooooooord.&quot;;
$newtext = wordwrap( $text, 8, &quot;\n&quot;, 1);

echo &quot;$newtext\n&quot;;
      </programlisting>
     </example>
    </para>
    <para>
     Dit voorbeeld zou geven:
    </para>
    <para>
     <informalexample>
      <programlisting>
Een heel
lang
wooooooo
ooooord.
      </programlisting>
     </informalexample>
    </para>
    <para>
     Zie ook <function>nl2br</function>.
    </para>
   </refsect1>
  </refentry>
 </reference>

<!-- 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:
-->