<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.strings">
  <title>String-Funktionen</title>
  <titleabbrev>Strings</titleabbrev>
<!-- Anmerkung des bersetzers:
     entspricht /en/functions/strings.xml 1.58 -->

  <partintro>
   <simpara>
    Mit diesen Funktionen werden Strings (Zeichenketten) auf
    verschiedene Arten verndert. Spezielle Anwendungen knnen in
    den Abschnitten zu regulren Ausdrcken (regular expression)
    und der URL-Handhabung gefunden werden.
   </simpara>
   <para>
    Informationen zum Funktionsweise von Strings (insbesondere beim
    Gebrauch von einfachen bzw. doppelten Anfhrungszeichen und
    Escape-Sequenzen) erhalten Sie unter dem
    <link linkend="language.types.string">Strings</link>-Eintrag
    unter <link linkend="language.types">Typen</link> des Manuals.
   </para>

  </partintro>

  <refentry id="function.addcslashes">
   <refnamediv>
    <refname>AddCSlashes</refname>
    <refpurpose>
     Stellt Zeichen eines Strings ein "\" voran (wie in C)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Es wird ein String zurck gegeben, in dem jedem Zeichen, das in
     <parameter>charlist</parameter> steht, ein "\" voran gestellt
     wurde. Teile wie <literal>\n</literal>, <literal>\r</literal>
     etc. werden wie in C bergangen, ASCII-Zeichen kleiner als 32
     und grsser als 126 werden in ihren oktal-Wert umgesetzt. Seien
     Sie bei der Umsetzung von alphanumerischen Zeichen vorsichtig.
     Sie knnen in <parameter>charlist</parameter> einen Bereich wie
     "\0..\37" angeben. Dadurch wird allen ASCII-Zeichen von 0 bis
     31 ein "\" voran gestellt.
     <example>
      <title><function>addcslashes</function> Beispiel:</title>
      <programlisting role="php">
$escaped = addcslashes ($not_escaped, "\0..\37!@\177..\377");
      </programlisting>
     </example>
     <note>
      <simpara>
       Diese Funktion ist ab Version PHP4b3-dev verfgbar.</simpara>
     </note>
    </para>
    <para>
     Siehe auch <function>stripcslashes</function>, 
     <function>stripslashes</function>, 
     <function>htmlspecialchars</function>,
     <function>htmlspecialchars</function> und 
     <function>quotemeta</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.addslashes">
   <refnamediv>
    <refname>AddSlashes</refname>
    <refpurpose>
     Stellt bestimmten Zeichen eines Strings einen Backslash "\"
     (Rckstrich) voran
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>addslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt einen String (Zeichenkette) zurck, in dem bestimmten
     Zeichen ein Backslash "\" voran gestellt wurde. Diese Funktion
     ist z.B. fr Datenbankabfragen wichtig. Die behandelten Zeichen
     sind der einfache und der doppelte Anfhrungsstrich
     (<literal>'</literal> und <literal>"</literal>), der Rckstrich
     (<literal>\</literal>) selbst sowie NUL (das Null-Byte).
    </para>
    <para>
     Siehe auch <function>stripslashes</function>, 
     <function>htmlspecialchars</function> und
     <function>quotemeta</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.bin2hex">
   <refnamediv>
    <refname>bin2hex</refname>
    <refpurpose>
     Wandelt Binr-Daten in ihre hexadezimale Entsprechung um
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>bin2hex</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Es wird ein ASCII-String mit der hexadezimalen Wiedergabe des
     Parameters <parameter>str</parameter> zurck gegeben. Die 
     Umwandlung geschieht byteweise mit dem hchsten Anteil (4 Bit,
     "high-nibble") zuerst.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.chop">
   <refnamediv>
    <refname>chop</refname>
    <refpurpose>Entfernt Leerzeichen, Tabulatoren und Zeilenvorschbe am String-Ende</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>chop</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die in <parameter>str</parameter> enthaltene Zeichenkette
     ohne evtl. vorhandene Leerzeichen, Tabulatoren
     oder Zeilenvorschbe am String-Ende zurck.
     <example>
      <title><function>chop</function>-Beispiel:</title>
      <programlisting role="php">
$string = "10 Leerzeichen am String-Ende          ";
echo chop($string)."?";

// Die Ausgabe lautet:
10 Leerzeichen am String-Ende?
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      <function>chop</function> unterscheidet sich von der 
      Perl-Funktion <parameter>chop()</parameter>, die das letzte
      Zeichen eines Strings entfernt.
     </para>
    </note>
    <para>
     Siehe auch <function>trim</function>, <function>ltrim</function>
     und <function>rtrim</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.chr">
   <refnamediv>
    <refname>chr</refname>
    <refpurpose>Gibt ein einzelnes Zeichen zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>chr</methodname>
      <methodparam><type>int</type><parameter>ascii</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt einen 1-Zeichen-String zurck, der dem mit
     <parameter>ascii</parameter> angegebenem Zeichen entspricht.
     <example>
      <title><function>chr</function> Beispiel:</title>
      <programlisting role="php">
$str .= chr (27); /* fgt an das Ende von $str ein Escape-Zeichen an */

/* Oft wird diese Funktionalitt gebraucht */

$str = sprintf ("Dieser String endet mit einem Escape: %c", 27);
      </programlisting>
     </example>
     Diese Funktion ergnzt <function>ord</function>. Siehe auch
     <function>sprintf</function> mit dem Formatierungs-String
     <literal>%c</literal>.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.chunk-split">
   <refnamediv>
    <refname>chunk_split</refname>
    <refpurpose>Zerlegt einen String in Teile gleicher Lnge</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Kann fr die Aufteilung eines Strings in kleinere Stcke verwendet
     werden. Dies ist z.B. hilfreich bei der Umwandlung von <link
     linkend="function.base64-encode">base64_encode</link>-Ausgaben, die
     der RFC 2045 entsprechen mssen. Diese Funktion fgt nach per
     <parameter>chunklen</parameter> angegebene Zeichen (Vorgabe: alle
     76 Zeichen) den mittels <parameter>end</parameter> angegebenen
     String (Vorgabe ist hierfr "\r\n") ein. Die Funktion gibt den
     neuen String zurck. Die Original-Zeichenkette bleibt unverndert.
     <example>
      <title><function>chunk_split</function> Beispiel:</title>
      <programlisting role="php">
# Formatiere den String $daten in die RFC 2045 Schreibweise

$neuer_string = chunk_split (base64_encode($daten));
      </programlisting>
     </example>
     Diese Funktion arbeitet wesentlich schneller als
     <function>ereg_replace</function>.
     <note>
      <para>
       <function>chunk_split</function> ist ab Version 3.0.6 vorhanden.
      </para>
     </note>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.convert-cyr-string">
   <refnamediv>
    <refname>convert_cyr_string</refname>
    <refpurpose>
     Setzt Strings von einem kyrillischen Zeichensatz in einen anderen
     um
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion konvertiert den angegebenen String von einem
     kyrillischen Zeichensatz in einen anderen. Die Argumente
     <parameter>from</parameter> und <parameter>to</parameter>
     sind einzelne Zeichen die den Ausgangs- und Zielzeichensatz
     definieren. Die untersttzten Zeichenstze sind:
     <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>
     Gibt Informationen ber die in einem String enthaltenen Zeichen
     zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Zhlt die Hufigkeit des Vorkommens jedes einzelnen Byte-Wertes
     (0..255) in <parameter>string</parameter> und gibt sie auf 
     verschiedene Arten zurck. Der optionale Parameter
     <parameter>mode</parameter> ist voreingestellt auf 0.
     In Abhngigkeit des <parameter>mode</parameter>-Wertes gibt
     <function>count_chars</function> das folgende zurck:
     <itemizedlist>
      <listitem>
       <simpara>
	0 - ein Array mit Byte-Werten fr die Hufigkeit (auch 0-Vorkommen)
  jedes Zeichens.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	1 - wie 0, aber nur Hufigkeiten grsser 0.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	2 - wie 0, aber nur Hufigkeiten gleich 0.
       </simpara>
      </listitem> 
      <listitem>
       <simpara> 
	3 - ein String der berhaupt vorkommenden Zeichen enthlt.
       </simpara>
      </listitem> 
      <listitem>
       <simpara> 
	4 - ein String der alle nicht vorkommenden Zeichen enthlt.
       </simpara>
      </listitem> 
     </itemizedlist>
    </para>
    <note>
     <para>
      Diese Funktion existiert ab PHP 4.0.
     </para> 
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.crc32">
   <refnamediv>
    <refname>crc32</refname>
    <refpurpose>
     Berechnet den polynomischen CRC32-Wert eines Strings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>crc32</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Berechnet die zyklisch redundante polynomische Prfsumme mit einer
     Lnge von 32-Bit fr <parameter>str</parameter>. Dies wird regulr
     fr die Integrittsprfung bermittelter Daten verwendet.
    </para>
    <para>
     Siehe auch: <function>md5</function>.
    </para>
   </refsect1>
  </refentry>
 
  <refentry id="function.crypt">
   <refnamediv>
    <refname>crypt</refname>
    <refpurpose>DES-Verschlsselung eines Strings</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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> verschlsselt einen String unter
     Verwendung der Standard-<abbrev>DES</abbrev>-Verschlsselungs-Methode
     von Unix. Die zu bergebenden Argumente sind der zu verschlsselnde
     String und optional ein 2-Zeichen-Salt-String, der die Schlsselbasis
     bildet. Lesen Sie die Man-Pages ihres Unix-Systems fr mehr
     Informationen zu den Crypt-Funktionen.
    </para>
    <simpara>
     Ist kein Salt-Argument angegeben, wird es von PHP nach dem
     Zufalls-Prinzip erzeugt.
    </simpara>
    <simpara>
     Einige Betriebssystem untersttzen mehr als eine Methode zur
     Verschlsselung. So wird manchmal der DES- durch einen
     MD5-Algorithmus ersetzt. Der verwendete Schlssel wird durch das
     Salt-Argument bestimmt. Zur Installations-Zeit untersucht PHP die
     vorhandenen Mglichkeiten und wird, abhngig vom Ergebnis dieser
     Prfung, auch andere Schlssel-Typen zulassen. Wird kein Salt
     untersttzt, erzeugt PHP per Voreinstellung einen 2-Zeichen
     DES-Salt, es sei denn auf ihrem System existiert MD5. Dann wird PHP
     einen zuflligen MD5-Salt generieren. PHP erzeugt eine Konstante
     namens CRYPT_SALT_LENGTH. Diese besagt, ob ihr System ein regulres
     2-Zeichen Salt oder das lngere 12-Zeichen MD5-Salt untersttzt.
    </simpara>
    <simpara>
     Wenn Sie das gegebene Salt benutzen, sollten Sie beachten, dass
     dieser Wert nur einmal bestimmt wird. Rufen Sie diese Funktion nun
     rekursiv auf, beeinflusst das nicht nur das Ergebnis, sondern
     unter Umstnden auch die Sicherheit.
    </simpara>  
    <simpara>
     Die Standard-DES-Verschlsselung <function>crypt</function>
     enthlt das Salt als erste 2 Zeichen der Ausgabe.
    </simpara>
    <simpara>
     Auf Systemen, wo die crypt()-Funktion meherere Verschlsselungen
     untersttzt, werden die folgenden Konstanten auf 0 oder 1
     gesetzt, je nachdem, ob der entsprechende Typ verfgbar ist:
    </simpara>
    <itemizedlist>
     <listitem>
      <simpara>
       CRYPT_STD_DES - Standard DES-Schlssel mit 2-Zeichen Salt
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_EXT_DES - Erweiterter DES-Schlssel mit einem 9-Zeichen Salt
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_MD5 - MD5-Schlssel mit 12-Zeichen Salt, beginnend mit $1$
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_BLOWFISH - Erweiterter DES-Schlssel, 16-Zeichen Salt,
       beginnend mit $2$
      </simpara>
     </listitem>
    </itemizedlist>
    <simpara>
     Der veschlsselte String kann nicht entschlsselt werden, da
     <function>crypt</function> eine Einweg-Verschlsselung ist.
    </simpara>
    <simpara>
     Siehe auch: <function>md5</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.echo">
   <refnamediv>
    <refname>echo</refname>
    <refpurpose>Gibt einen oder mehrere Strings aus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Gibt alle als Parameter angegebenen Strings aus.
    </simpara>
    <para>
     <function>echo</function> ist keine Funktion, sonder ein
     Sprach-Konstrukt. Deshalb brauchen Sie keine Klammern zu
     verwenden.
     <example>
      <title><function>echo</function>-Beispiel:</title>
      <programlisting role="php">
echo "Hallo Welt";

echo "Dieses
Beispiel
umfasst
mehrere
Zeilen.";
      </programlisting>
     </example>
    </para>	 
    <note>
     <para>
      Falls Sie mehr als einen auszugebenden Parameter angeben,
      drfen Sie diese nicht in Klammern setzen.
     </para>
    </note>
    <simpara>
     Siehe auch:
     <function>print</function>,
     <function>printf</function> und
     <function>flush</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.explode">
   <refnamediv>
    <refname>explode</refname>
    <refpurpose>
     Zerteilt einen String anhand eines Trennzeichens
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Gibt ein Array aus Strings zurck. Jeder String ist ein Teil von
     <parameter>string</parameter>. Die Trennung erfolgt an der mit
     <parameter>separator</parameter> angegebenen Zeichenkette (ein
     oder mehrere Zeichen). Ist der Parameter <parameter>limit
     </parameter>angegeben, werden maximal <parameter>limit</parameter>
     Teile zurck gegeben. Das letzte Element enthlt dann den ganzen
     Rest von <parameter>string</parameter>.
    </para>
    <para>
     <example>
      <title><function>explode</function>-Beispiel:</title>
      <programlisting role="php">
$pizza = "Teil1 Teil2 Teil3 Teil4 Teil5 Teil6";
$pieces = explode (" ", $pizza);
      </programlisting>
     </example>
    </para>
    <para>
     Siehe auch <function>split</function> und
     <function>implode</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.get-html-translation-table">
   <refnamediv>
    <refname>get_html_translation_table</refname>
    <refpurpose>
     Gibt die bersetzungs-Tabelle zurck, die von
     <function>htmlspecialchars</function> und
     <function>htmlentities</function> benutzt wird
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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> ermittelt die
     intern benutzte bersetzungs-Tabelle, die von den Funktionen
     <function>htmlspecialchars</function> und<function>
     htmlentities</function> benutzt wird. Es gibt zwei neue 
     Parameter (<parameter>HTML_ENTITIES</parameter> und
     <parameter>HTML_SPECIALCHARS</parameter>), die es ihnen
     ermglichen, die gewnschte Tabelle auszuwhlen und wie bei den
     <function>htmlspecialchars</function> bzw.
     <function>htmlentities</function>-Funktionen knnen Sie optional
     den Quote-Stil, mit dem Sie arbeiten, angeben. Voreingestellt ist
     der ENT_COMPAT-Modus. Vergleichen Sie dazu die Modus-Beschreibung
     unter <function>htmlspecialchars</function>.
     <example>
      <title>Beispiel zur bersetzungs-Tabelle</title>
      <programlisting role="php">
$trans = get_html_translation_table (HTML_ENTITIES);
$str = "Hallo &amp; &lt;Frau> &amp; Krmer";
$encoded = strtr ($str, $trans);
      </programlisting>
     </example>
     Die <literal>$encoded</literal>-Variable wird jetzt "Hallo
     &amp;<sgmltag>amp</sgmltag>;
     &amp;<sgmltag>lt</sgmltag>;Frau&amp;<sgmltag>gt</sgmltag>;
     &amp;<sgmltag>amp</sgmltag>; Kr&amp;<sgmltag>auml</sgmltag>;mer".
     enthalten.
    </para>
    <para>
     Mittels <function>array_flip</function> knnen Sie die 
     Richtung der bersetzung umkehren.
     <informalexample>
      <programlisting role="php">
$trans = array_flip ($trans);
$original = strtr ($str, $trans);
      </programlisting>
     </informalexample>
      Der Inhalt von <literal>$original</literal> wird "Hallo &amp;
      &lt;Frau> &amp; Krmer" sein.
     <note>
      <para>
       Diese Funktion wurde in PHP 4.0 neu hinzu gefgt.
      </para> 
     </note>
    </para>
    <para>
     Siehe auch <function>htmlspecialchars</function>,
     <function>htmlentities</function>, <function>strtr</function>
     und <function>array_flip</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.get-meta-tags">
   <refnamediv>
    <refname>get_meta_tags</refname>
    <refpurpose>
     Liest die Attribut-Inhalte aller Meta-Tags aus und gibt diese
     als Array zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     ffnet <parameter>filename</parameter> und untersucht diese Zeile
     fr Zeile auf das Vorkommen von &lt;meta>-Tags der Form
     <example>
      <title>Meta-Tags Beispiel:</title>
      <programlisting role="html">
&lt;meta name="author" content="Name">
&lt;meta name="tags" content="PHP3-Dokumentation">
&lt;/head> &lt;!-- Ende der Untersuchung -->
      </programlisting>
     </example>
     (Eine auf einem MAC erzeugte Datei kann nicht unter UNIX auf
     Meta-Tags untersucht werden, da die Zeilenenden anders sind.)
    </para>
    <para> 
     Der Wert der name-Eigenschaft wird Schlssel, der Wert der
     content-Eigenschaft wird Wert des zurck gegebenen Arrays. Dadurch
     knnen Sie gewhnliche Array-Funktionen nutzen, dieses zu
     durchlaufen oder einzelne Werte anzusprechen. Sonderzeichen
     innerhalb der name-Eigenschaft werden durch _ ersetzt, der Rest
     wird in Kleinbuchstaben umgewandelt.
    </para>
    <para>
     Ist <parameter>use_include_path</parameter> auf 1 gesetzt, wird
     PHP versuchen, die Datei anhand des Standard-Include-Pfades zu
     ffnen.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.hebrev">
   <refnamediv>
    <refname>hebrev</refname>
    <refpurpose>
     Konvertiert (natrlichen) hebrischen Text in sichtbaren Text
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Der optionale Parameter <parameter>max_chars_per_line</parameter>
     entspricht der Zeichenzahl pro Ausgabe-Zeile. Wortbrche werden,
     soweit mglich, vermieden.
    </para>
    <para>
     Siehe auch: <function>hebrevc</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.hebrevc">
   <refnamediv>
    <refname>hebrevc</refname>
    <refpurpose>
     Konvertiert (natrlichen) hebrischen Text in sichtbaren Text
     incl. Anpassung von Zeilenumbrchen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion ist gleich <function>hebrev</function>, mit dem
     Unterschied, dass Zeilenumbrche (\n) zu "&lt;br&gt;\n"
     umgewandelt werden. Der optionale Parameter 
     <parameter>max_chars_per_line</parameter> entspricht der
     Zeichenzahl pro Ausgabe-Zeile. Wortbrche werden, soweit mglich,
     vermieden.
    </para>
    <para>
     Siehe auch: <function>hebrev</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.htmlentities">
   <refnamediv>
    <refname>htmlentities</refname>
    <refpurpose>
     Wandelt alle Sonderzeichen in entsprechende HTML-Codes um
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion ist vllig identisch zu 
     <function>htmlspecialchars</function>, ausser dass alle Zeichen,
     die HTML-Code-Entsprechungen haben, in diese Codes umgewandelt
     werden. Wie bei htmlspecialchars() gibt es ein optionales zweites
     Argument, das die Behandlung von einfachen bzw. den doppelten
     Anfhrungszeichen beeinflusst. Im Modus ENT_COMPAT (default)
     werden nur die doppelten, im Modus ENT_QUOTES beide Arten und im
     Modus ENT_NOQUOTES keine Anfhrungszeichen umgewandelt.
    </para>
    <para>
     Gegenwrtig wird der ISO-8859-1-Zeichensatz verwendet. Beachten
     Sie, dass das optionale 2. Argument erst ab PHP 3.0.17 bzw. PHP
     4.0.3. verfgbar ist.
    </para>
    <para>
     Siehe auch <function>htmlspecialchars</function> und
     <function>nl2br</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.htmlspecialchars">
   <refnamediv>
    <refname>htmlspecialchars</refname> 
    <refpurpose>
     Diese Funktion wandelt Sonderzeichen in HTML-Codes um
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Bestimmte Zeichen haben eine spezielle Bedeutung in HTML und
     sollten in HTML-Code dargestellt werden, um ihre Bedeutung zu
     behalten. Diese Funktion liefert einen String zurck, in dem 
     diese Darstellung / Umsetzung teilweise durchgefhrt wird. Die
     hier vorgenommenen Umsetzungen sind ntzlich fr die alltgliche
     Web-Programmierung. Sofern Sie eine vollstndige Umsetzung der
     HTML-Zeichen bentigen, sollten Sie statt dessen
     <function>htmlentities</function> verwenden.
    </para>
    <simpara>
     Sinnvoll beim Schutz von benutzerabhngigen Texteingaben (z.B. in
     Gstebuch-Formularen). Das optionale 2. Argument (Quote-Stil) 
     beeinflusst die Behandlung der einfachen und doppelten
     Anfhrungsstriche. Der Modus ENT_COMPAT (default) ist
     abwrtskompatibel und behandelt nur die doppelten, nicht aber die
     einfachen Anfhrungsstriche. ENT_QUOTES behandelt beide und
     ENT_NOQUOTES keine Art(en) von Anfhrungszeichen.
    </simpara>
    <para>
     Folgende Umsetzungen werden vorgenommen:
     <itemizedlist>
      <listitem>
       <simpara>
        '&amp;' (kaufmnnisches und) wird zu '&amp;amp;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&quot;' (doppelte Anfhrungszeichen) wird zu '&amp;quot;',
                 wenn ENT_NOQUOTES nicht gesetzt ist
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&#039;' (einfaches Anfhrungszeichen) wird zu '&amp;#039;',
                 wenn ENT_QUOTES gesetzt ist
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&lt;' (kleiner als) wird zu '&amp;lt;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&gt;' (grsser als) wird zu '&amp;gt;'
       </simpara>
      </listitem>
     </itemizedlist>
     <example>
      <title><function>htmlspecialchars</function>-Beispiel:</title>
      <programlisting role="php">
$neu = htmlspecialchars("&lt;a href='test'&gt;Test&lt;/a&gt;", ENT_QUOTES);
      </programlisting>
     </example>
    </para>
    <para>
     Beachten Sie, dass diese Funktion nur die o.a. Umwandlungen
     durchfhrt. Zur vollstndigen Code-Umwandlung siehe
     <function>htmlentities</function>. Beachten Sie auch, dass das
     optionale 2. Argument erst ab PHP 3.0.17 bzw. PHP 4.0.3. verfgbar
     ist.
    </para>
    <para>
     Siehe auch <function>htmlentities</function> und
     <function>nl2br</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.implode">
   <refnamediv>
    <refname>implode</refname>
    <refpurpose>Verbindet Array-Elemente zu einem String</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Gibt einen String zurck, dessen Inhalt allen Array-Elementen
     in der fortlaufenden Reihenfolge ihres Vorkommens im Array
     entspricht. Die Stringteile sind durch den im Parameter glue
     enthaltenen String verbunden.
     <example>
      <title><function>implode</function>-Beispiel:</title>
      <programlisting role="php">
$Trennung_durch_Doppelpunkt = implode (":", $array);
      </programlisting>
     </example>
    </para>
    <simpara>
     Siehe auch <function>explode</function>, <function>join</function>
     und <function>split</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.join">
   <refnamediv>
    <refname>join</refname>
    <refpurpose>Join verbindet Array-Elemente zu einem String</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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> ist ein Alias von
     <function>implode</function> (die Funktionalitt ist also
     vollkommen identisch).
    </simpara>
    <simpara>
     Siehe auch <function>explode</function>, <function>implode</function>
     und <function>split</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.levenshtein">
   <refnamediv>
    <refname>levenshtein</refname> 
    <refpurpose>
		 Berechnet den Levenshtein-Unterschied zweier Strings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion errechnet die Differenz zwischen den als Argumente
     bergebenen zwei Strings. Ist einer der Strings lnger als die
     zulssigen 255 Zeichen, wird -1 zurck gegeben.
    </para>
    <para>
     Die Levenshtein-Differenz ist definiert als die minimale Anzahl
     an Zeichen, die ersetzt, eingefgt oder gelscht werden mssen um
     den <parameter>str1</parameter> nach <parameter>str2</parameter>
     umzusetzen.
     Die Komplexitt des Algorithmus ist <literal>O(m*n)</literal>,
     wobei <literal>n</literal> und <literal>m</literal> der Lnge der
     Strings <parameter>str1</parameter> und
     <parameter>str2</parameter> (viel besser als bei der Funktion
     <function>similar_text</function>, wo sie O(max(n,m)**3) betrgt).
    </para>
    <para>
     Siehe auch <function>soundex</function>, 
     <function>similar_text</function> und 
     <function>metaphone</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ltrim">
   <refnamediv>
    <refname>ltrim</refname> 
    <refpurpose>
     Entfernt fhrende Leerraum eines Strings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>ltrim</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Es wird Leerraum ab Stringanfang entfernt und der um diesen
     gekrzte String zurck gegeben. Als Leerraum gelten die Zeichen
     "\n", "\r", "\t", "\v", "\0" und das Leerzeichen.
    </para>
    <para>
     Siehe auch <function>chop</function>, <function>rtrim</function>
     und <function>trim</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.md5">
   <refnamediv>
    <refname>md5</refname>
    <refpurpose>Errechnet den MD5-Code eines Strings</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>md5</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Berechnet den MD5-Code von <parameter>str</parameter> unter 
     Verwendung des <ulink url="&url.rfc;rfc1321.html">RSA Data
     Security, Inc. MD5 Message-Digest Algorithmus</ulink>.
    </para>
    <para>
     Siehe auch: <function>crc32</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.metaphone">
   <refnamediv>
    <refname>metaphone</refname>
    <refpurpose>
     Berechnet den metaphone-Schlssel eines Strings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>metaphone</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Errechnet den metaphone-Schlssel von <parameter>str</parameter>.
    </para>
    <para>
     Genau wie <function>soundex</function> berechnet metaphone den
     gleichen Schlssel fr hnlich klingende Wrter. Die
     Metaphone-Funktion arbeitet genauer als
     <function>soundex</function>, da sie die Grundregeln der
     englischen Aussprache kennt. Die durch metaphone erzeugten
     Schlsel sind von variabler Lnge.
    </para>
    <para>
     Der Metaphone-Algorithmus wurde entwickelt von Lawrence Philips
     &lt;lphilips@verity.com> und ist beschrieben in ["Practical
     Algorithms for Programmers", Binstock &amp; Rex, Addison Wesley,
     1995].
     <note>
      <para>
       Diese Funktion ist ab PHP 4.0 verfgbar.
      </para>
     </note>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.nl2br">
   <refnamediv>
    <refname>nl2br</refname>
    <refpurpose>
     Fgt HTML-Zeilen-Umbrche vor Zeilenumbrche in Strings ein
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>nl2br</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt den <parameter>string</parameter> mit einem eingefgten
     '&lt;br /&gt;' vor dem Neue-Zeile-Zeichen zurck.
    </para>
    <para>
     Siehe auch <function>htmlspecialchars</function> und
     <function>htmlentities</function> and
     <function>wordwrap</function>.
    </para>
   </refsect1>
  </refentry>
 
  <refentry id="function.ord">
   <refnamediv>
    <refname>ord</refname>
    <refpurpose>Gibt den ASCII-Wert eines Zeichens zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ord</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Es wird der ASCII-Wert des ersten Zeichens von
     <parameter>string</parameter> zurck gegeben. Diese Funktion
     steht in Zusammenhang mit <function>chr</function>.
     <example>
      <title><function>ord</function>-Beispiel:</title>
      <programlisting role="php">
if (ord ($str) == 10) {
    echo "Das erste Zeichen von \$str ist ein Zeilenvorschub.\n";
}
      </programlisting>
     </example>
    </para>
    <simpara>
     Siehe auch <function>chr</function>.
    </simpara> 
   </refsect1>
  </refentry>

  <refentry id="function.parse-str">
   <refnamediv>
    <refname>parse_str</refname>
    <refpurpose>bertrgt einen String in Variable</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Durchsucht <parameter>str</parameter> als ob er der Query-String
     einer URL-bergabe via GET wre und gibt die Werte 
     Variableninhalte zurck. Ist der zweite Parameter 
     <parameter>arr</parameter> gegeben, werden die Variablen-Werte in
     diesem Array als dessen Elemente gespeichert.
    </para>
    <note>
     <para>
      Der optionale zweite Parameter wurde in PHP 4.0.3 hinzugef&uuml;gt.
     </para>
    </note>
	
    <para>
     <example>
      <title>Der Gebrauch von <function>parse_str:</function></title>
      <programlisting role="php">
$str = "erster=nichts&amp;zweiter[]=etwas&amp;zweiter[]=nochwas";
parse_str($str);
echo $erster;     /* gibt "nichts" aus */
echo $zweiter[0]; /* gibt "etwas" aus */
echo $zweiter[1]; /* gibt "nochwas" aus */
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.print">
   <refnamediv>
    <refname>print</refname>
    <refpurpose>Ausgabe eines Strings</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <methodname>print</methodname>
      <methodparam><type>string</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Gibt <parameter>arg</parameter> aus.
    </simpara>
    <simpara>
     Siehe auch <function>echo</function>, <function>printf</function>
     und <function>flush</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.printf">
   <refnamediv>
    <refname>printf</refname>
    <refpurpose>Gibt einen formatierten String aus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Erzeugt eine Ausgabe abhngig von <parameter>format</parameter>.
     <parameter>Format</parameter> wird in der Dokumentation zu
     <function>sprintf</function> nher beschrieben.
    </simpara>
    <simpara>
     Siehe auch <function>print</function>,
     <function>sprintf</function>, <function>sscanf</function>,
     <function>fscanf</function> und <function>flush</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.quoted-printable-decode">
   <refnamediv>
    <refname>quoted_printable_decode</refname>
    <refpurpose>
     Konvertiert einen "quoted-printable"-String in einen 8-Bit-String
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>quoted_printable_decode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Diese Funktion gibt einen 8-Bit-String zurck, der der Konvertierung
     aus einem "quoted-printable"-String entspricht. Diese Funktion ist
     hnlich wie <function>imap_qprint</function> bis auf die Tatsache,
     dass sie kein IMAP-Module erfordert.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.quotemeta">
   <refnamediv>
    <refname>QuoteMeta</refname>
    <refpurpose>Quoten von Meta-Zeichen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>quotemeta</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Der Inhalt von <parameter>str</parameter> wird mit einem
     Rckstrich ("Backslash", <literal>\</literal>) vor jedem Vorkommen
     von <screen>. \\ + * ? [ ^ ] ( $ )</screen> versehen ("quoten")und
     zurck gegeben.
    </para>
    <simpara>
     Siehe auch <function>addslashes</function>,
     <function>htmlentities</function>, 
     <function>htmlspecialchars</function>, 
     <function>nl2br</function> und 
     <function>stripslashes</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.rtrim">
   <refnamediv>
    <refname>rtrim</refname>
    <refpurpose>Entfernt Leerzeichen am String-Ende</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>rtrim</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt den als Argument bergebenen String ohne abschlieende
     Leerzeichen (auch "Neue-Zeile-"Steuerzeichen werden entfernt).
     Dies ist ein Alias zu <function>chop</function>.
     <example>
      <title><function>rtrim</function>-Beispiel:</title>
      <programlisting role="php">
$getrimmt = rtrim ($line);
      </programlisting>
     </example>
    </para>
    <para>
     Siehe auch <function>chop</function>, <function>ltrim</function>
     und <function>trim</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.sscanf">
   <refnamediv>
    <refname>sscanf</refname>
    <refpurpose>
     bertragt die Eingaben eines Strings in ein angegebenes Format
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Die Funktion <function>sscanf</function> ist die Eingabe analog zu
     <function>printf</function>. <function>sscanf</function> liest den
     <parameter>str</parameter>-String und interpretiert ihn Anlehnung 
     an die angegebenen <parameter>format</parameter> Parameter. Werden
     nur 2 Parameter angegeben, werden die analysierten Werte als Array
     zurck gegeben.
     <example>
      <title><function>sscanf</function>-Beispiel:</title>
      <programlisting role="php">
// Ermittlung der Serien-Nr.
$serial = sscanf("SN/2350001","SN/%d");
// und des Herstellungsdatums
$mandate = "Januar 01 2000";
list($monat, $tag, $jahr) = sscanf($mandate,"%s %d %d");
echo "Das Teil $serial wurde hergestellt am: $jahr-".substr($monat,0,3)."-$tag\n";
      </programlisting>
     </example>
     Werden optionale Parameter bergeben, gibt die Funktion die Anzahl
     der ermittelten Werte zurck. Die optionalen Parameter mssen
     refenziert bergeben werden.
     <example>
      <title>
       <function>sscanf</function> - Gebrauch optionaler Parameter
      </title>
      <programlisting role="php">
// Ermittlung der Autoren-Info und Erzeugung eines DocBook-Eintrages
$auth = "24\tLewis Carroll";
$n = sscanf($auth,"%d\t%s %s", &amp;$id, &amp;$first, &amp;$last);
echo "&lt;author id='$id'&gt;
      &lt;firstname&gt;$first&lt;/firstname&gt;
      &lt;surname&gt;$last&lt;/surname&gt;
      &lt;/author&gt;\n";
      </programlisting>
     </example>
    </para>
    <para>
     Siehe auch: <function>fscanf</function>,
     <function>printf</function> und <function>sprintf</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.setlocale">
   <refnamediv>
    <refname>setlocale</refname>
    <refpurpose>Setzt lokale Informationen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Der String <parameter>category</parameter> enthlt die Kategorie
     der zu ndernden Lokalitts-Informationen:
     <itemizedlist>
      <listitem>
       <simpara>
	LC_ALL - alle folgenden Werte
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	LC_COLLATE - fr String-Vergleiche - z.Zt. noch nicht in PHP
  implementiert
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	LC_CTYPE - betrifft Klassifizierungen und Umwandlung, z.B. bei
  <function>strtoupper</function>
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	LC_MONETARY - betrifft localeconv() - z.Zt. noch nicht in PHP
  implementiert
       </simpara>
      </listitem>
      <listitem>
       <simpara> 
	LC_NUMERIC - fr das Dezimal-Trennzeichen
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	LC_TIME - betrifft Zeit und Datums-Formatierungen durch
	<function>strftime</function>
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Ist <parameter>locale</parameter> als Leer-String definiert, also
     <literal>""</literal>, werden die Werte an Hand der entsprechenden
     Umgebungs-Variablen gleichen Namens oder von "LANG" bestimmt.
    </para>
    <para>
     Ist <parameter>locale</parameter> &null; oder <literal>"0"</literal>,
     werden keine Einstellungen verndert sondern als Ergebnis zurck
     gegeben.
    </para>
    <para>
     <function>setlocale</function> gibt die neue Einstellung oder
     &false; (wenn die locale-Funktionalitt auf der System-Plattform
     nicht untersttzt wird oder der Kategorie-Wert ungltig ist)
     zurck. Ein ungltiger Kategorie-Name erzeugt auch noch eine
     Warnmeldung.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.similar-text">
   <refnamediv>
    <refname>similar_text</refname>
    <refpurpose>
     Berechnet die hnlichkeit zweier Zeichenketten
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Die Berechnung der hnlichkeit zweier Strings erfolgt nach der in
     "Oliver" [1993] beschreibenen Methode. Beachten Sie, dass diese
     Implementierung keinen Stack verwendet wie in Olivers Pseude-Code,
     dafr aber rekursive Aufrufe, die die Performance erhhen knnen
     (aber nicht mssen). Beachten Sie auch, dass die Komplexitt
     dieses Algorithmus O(N**3) betrgt, wobei N die Lnge der lngsten
     Zeichenkette ist.
    </para>
    <para>
     Falls Sie als Referenz ein drittes Argument angeben, wird
     <function>similar_text</function> ihnen die hnlichkeit als
     Prozentwert errechnen. Es wird die Anzahl der in beiden Strings
     bereinstimmenden Zeichen zurck gegeben.
    </para>
   </refsect1>
  </refentry>
    
  <refentry id="function.soundex">
   <refnamediv>
    <refname>soundex</refname>
    <refpurpose>
     Berechnet die Laut-hnlichkeit eines Strings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>soundex</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Errechnet den Wert der Laut-hnlichkeit von
     <parameter>str</parameter>.
    </para>
    <para>
     Soundex-Werte haben die Eigenschaft, dass hnlich ausgesprochene
     Wrter den gleichen Soundex-Wert erzeugen. Dies kann zur Suche in
     Datenbanken verwendet werden, wenn Sie zwar die Aussprache aber
     nicht die genaue Schreibweise kennen. <function>soundex</function>
     liefert einen String aus 4 Zeichen, beginnend mit einem Buchstaben
     zurck.
    </para>
    <para>
     Diese besondere <function>soundex</function>-Funktion ist u.a.
     beschrieben in "The Art Of Computer Programming, vol. 3: Sorting
     And Searching", von Donald Knuth, Addison-Wesley-Verlag (1973),
     Seiten 391 bis 392.
    </para>
    <para>
     <example>
      <title>Soundex-Beispiel:</title>
      <programlisting role="php">
soundex ("Euler") == soundex ("Ellery") == 'E460';
soundex ("Gauss") == soundex ("Ghosh") == 'G200';
soundex ("Knuth") == soundex ("Kant") == 'H416';
soundex ("Lloyd") == soundex ("Ladd") == 'L300';
soundex ("Lukasiewicz") == soundex ("Lissajous") == 'L222';
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.sprintf">
   <refnamediv>
    <refname>sprintf</refname>
    <refpurpose>Gibt einen formatierten String zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Gibt einen an Hand des Formatierungs-Strings
     <parameter>format</parameter> gebildeten String zurck.
    </simpara>
    <simpara>
     Der Formatierungs-String wird aus keiner oder mehreren Anweisungen
     gebildet: Gewhnliche Zeichen (ausser <literal>%</literal>), die
     direkt in das Ergebnis bertragen werden und 
     <emphasis>Umsetzungs-Anweisungen</emphasis>. Jede dieser
     Anweisungen resultiert ihre eigene Auswirkung. Diese Anweisungen
     gelten sowohl fr die <function>sprintf</function>- als auch fr
     die <function>printf</function>-Funktion.
    </simpara>
    <para>
     Jede der Formatierugs-Anweisungen besteht aus einem 
     Prozent-Zeichen gefolgt von einem oder mehrereren der folgenden
     Elemente (in alphabetischer Reihenfolge):
     <orderedlist>
      <listitem>
       <simpara>
        Einem optionalen <emphasis>Fll-Zeichen</emphasis>, das den
        String bis rechts auffllt. Dies kann ein Leerzeichen oder eine
        <literal>0</literal> (das Null-Zeichen) sein. Als Fllzeichen
        voreingestellt ist das Leerzeichen. Andere Fllzeichen knnen
        durch Voranstellung eines einfachen Anfhrungszeichens
        (<literal>'</literal>) definiert werden. Beachten Sie die
        folgenden Beispiele.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Einer optionalen Angabe der <emphasis>Ausrichtung</emphasis>,
        ob die Ausgabe also nach links oder nach rechts (default)
        ausgerichtet werden soll. Um den Text links auszurichten mssen
        Sie das Zeichen <literal>-</literal> angeben.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Optional einem Wert fr die <emphasis>Lngen-Angabe</emphasis>,
        also der Wert fr die mindestenst zurckzugebenden Zeichen.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Optional einem Wert fr die Anzahl der auszugebenden
        <emphasis>Nachkomma-Stellen</emphasis>. Dieser Wert hat nur
        Einfluss auf Werte vom Typ "double" (eine weitere hilfreiche
        Funktion fr die Formatierung von Zahlen ist
        <function>number_format</function>).
       </simpara>
      </listitem>
      <listitem>
       <para>
        Einer <emphasis>Typ-Angabe</emphasis> welche den Typ enthlt,
        als der das Argument angesehen werden soll. Mgliche Angaben
        sind:
        <simplelist>
         <member>
          <literal>%</literal> - ein Prozent-Zeichen ("%"). Es ist kein
          Argument erforderlich.
         </member>
         <member>
          <literal>b</literal> - das Argument wird als Integer
          angesehen und als Binr-Wert ausgegeben.
         </member>
         <member>
          <literal>c</literal> - das Argument wird als Integer
          angesehen und das entsprechende ASCII-Zeichen wird
          ausgegeben.
         </member>
         <member>
          <literal>d</literal> - das Argument wird als Integer
          angesehen und ein Dezimalwert ausgegeben.
         </member>
         <member>
          <literal>f</literal> - das Argument wird als "double"
          angesehen und eine Fliekomma-Zahl ausgegeben.
         </member>
         <member>
          <literal>o</literal> - das Argument wird als Integer
          angesehen und und als Oktalwert ausgegeben.
         </member>
         <member>
          <literal>s</literal> - das Argument wird als String angesehen
          und als solcher ausgegeben.
         </member>
         <member>
          <literal>x</literal> - das Argument wird als Integer
          angesehen und als Hexadezimal-Wert ausgegeben (mit
          Kleinbuchstaben).
         </member>
         <member>
          <literal>X</literal> - das Argument wird als Integer
          angesehen und als Hexadezimal-Wert ausgegeben (mit
          Grobuchstaben).
         </member>
        </simplelist>
       </para>
      </listitem>
     </orderedlist>
    </para>
    <simpara>
     Siehe auch: <function>printf</function>,
     <function>sscanf</function>, <function>fscanf</function> und
     <function>number_format</function>.
    </simpara>
   </refsect1>
   <refsect1>
    <title>Beispiele:</title>
    <para>
     <example>
      <title>
       <function>sprintf</function>: Null-gefllte Integer-Werte
      </title>
      <programlisting role="php">
$isodatum = sprintf ("%04d-%02d-%02d", $jahr, $monat, $tag);
      </programlisting>
     </example>
     <example>
      <title>
       <function>sprintf</function>: Integer- zu Binrwert
      </title>
      <programlisting role="php">
$wert = 155;
$binaer = sprintf ("%b", $wert);
echo ("&lt;br> $binaer &lt;br>");
// gibt 10011011 aus
      </programlisting>
     </example>
     <example>
      <title><function>sprintf</function>: Whrungsformatierung</title>
      <programlisting role="php">
$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money wird "123.1" ausgeben
$formatiert = sprintf ("%01.2f", $money);
// echo $formatiert wird "123.10" ausgeben
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strcasecmp">
   <refnamediv>
    <refname>strcasecmp</refname>
    <refpurpose>Binrer Vergleich von Zeichenketten</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Ist <parameter>str1</parameter> kleiner als
     <parameter>str2</parameter> wird &lt; 0, ist
     <parameter>str1</parameter> grsser als
     <parameter>str2</parameter> wird &gt; 0 und bei Gleichheit wird 0
     zurck gegeben.
    <example>
      <title><function>strcasecmp</function>-Beispiel:</title>
      <programlisting role="php">
$var1 = "Hallo";
$var2 = "hallo";
if (!strcasecmp($var1, $var2) ) {
    echo '$var1 ist wie $var2 bei schreibweise-unabhngigem Vergleich';
}
      </programlisting>
    </example>
    </para>
    <simpara>
     Beachten Sie, dass nicht zwischen Gro- und Kleinschreibung
     unterschieden wird.
    </simpara>
    <simpara>
     Siehe auch <function>ereg</function>, <function>strcmp</function>,
     <function>substr</function>, <function>stristr</function> und
     <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strchr">
   <refnamediv>
    <refname>strchr</refname> 
    <refpurpose>
     Findet das erste Vorkommen eines Zeichens
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion ist ein Alias zu <function>strstr</function> und
     funktioniert genau wie dort beschrieben.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strcmp">
   <refnamediv>
    <refname>strcmp</refname>
    <refpurpose>Binrer Vergleich zweier Strings</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Ist <parameter>str1</parameter> kleiner als
     <parameter>str2</parameter> wird &lt; 0, ist
     <parameter>str1</parameter> grsser als
     <parameter>str2</parameter> wird &gt; 0 und bei Gleichheit wird 0
     zurck gegeben.
    </simpara>
    <simpara>
     Beachten Sie, dass zwischen Gro- und Kleinschreibung
     unterschieden wird.
    </simpara>
    <simpara>
     Siehe auch <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strncmp</function> und
     <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strcspn">
   <refnamediv>
    <refname>strcspn</refname>
    <refpurpose>
     Ermittelt die Anzahl der nicht bereinstimmenden Zeichen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Die Lnge des Strings <parameter>str1</parameter> bis zum ersten
     Erscheinen eines Buchstabens (aus <parameter>str1</parameter>) in
     <parameter>str2</parameter> wird zurck gegeben.
    </simpara>
    <example>
     <title><function>strcspn</function>-Beispiel:</title>
      <programlisting role="php">
$s1 = "dasrktuvs";
$s2 = "iklp";                  // "k" ist der "Kasus-Knacktus"
$wert = strcspn ($s1, $s2);
echo "&lt;br> $wert &lt;br>";  // gibt also 4 zurck
      </programlisting>
     </example>
    <simpara>
     Siehe auch <function>strspn</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strip-tags">
   <refnamediv>
    <refname>strip_tags</refname>
    <refpurpose>
     Entfernt HTML- und PHP-Tags aus einem String
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion versucht, alle HTML- und PHP-Tags aus
     <parameter>str</parameter> zu entfernen. Bei unvollstndigen oder
     sinnlosen Tags werden Fehler ausgegeben. Es wird die gleiche Art
     der Tag-Engine wie bei der <function>fgetss</function>-Funktion
     benutzt.
    </para>
    <para>
     Sie knnen den optionalen Parameter
     <parameter>allowable_tags</parameter>
     benutzen, um nicht zu entfernende Tags zu definieren.
     <note>
      <para>
       <parameter>Allowable_tags</parameter> steht ab PHP 3.0.13 bzw.
       PHP4B3 zur Verfgung.
      </para> 
     </note>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.stripcslashes">
   <refnamediv>
    <refname>StripCSlashes</refname>
    <refpurpose>Umkehrung / Gegenstck zu addcslashes</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>stripcslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt einen String ohne "\" zurck. Wie in C werden
     <literal>\n</literal>, <literal>\r</literal> ..., oktal-
     und hexadezimal-Vorkommen erkannt.
     <note>
      <simpara>
       Verfgbar seit PHP4b3-dev.
      </simpara>
     </note>
    </para>
    <simpara>
     Siehe auch <function>addcslashes</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.stripslashes">
   <refnamediv>
    <refname>StripSlashes</refname>
    <refpurpose>Umkehrung / Gegenstck zu addslashes</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>stripslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt einen String ohne evtl. vorhandene "\" (Backslash)
     zurck (<literal>\'</literal> wird zu <literal>'</literal> usw.).
     Doppelte Rckstriche ("\\") werden zu "\" umgesetzt.
    </para>
    <simpara>
     Siehe auch <function>addslashes</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.stristr">
   <refnamediv>
    <refname>stristr</refname>
    <refpurpose>
     Wie <function>strstr</function> ohne Rcksicht auf Gro- bzw.
     Kleinschreibung
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Findet alle Vorkommen von <parameter>needle</parameter> innerhalb
     von <parameter>haystack</parameter> vom Anfang bis zum Ende (ohne
     Rcksicht auf die Schreibweise beider Parameter).
    </para>
    <para>
     Wird <parameter>needle</parameter> nicht gefunden, wird &false;
     zurck gegeben.
    </para>
    <para>
     Ist <parameter>needle</parameter> kein String, wird er in einen
     Integer-Wert umgesetzt. Dies ASCII-Entsprechung dieses Wertes
     wird dann als zu suchendes Zeichen angesehen.
    </para>
    <para>
     Siehe auch <function>strchr</function>,
     <function>strrchr</function>, <function>substr</function> und
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strlen">
   <refnamediv>
    <refname>strlen</refname>
    <refpurpose>Ermitteln der String-Lnge</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>strlen</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die Lnge der Zeichenkette <parameter>string</parameter>
     zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strnatcmp">
   <refnamediv>
    <refname>strnatcmp</refname>
    <refpurpose>
     String-Vergleich unter Verwendung einer "natrlichen Ordnung"
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion implemetiert einen Vergleich, der alphanumerische
     Zeichen "menschlich" einordnet (auch "natrliche Ordnung"
     genannt). Der Unterschied zwischen dieser und der regulren
     String-Sortierung eines Computer (unter Verwendung von
     <function>strcmp</function>) wird in dem folgenden Beispiel
     gezeigt:
     <informalexample>
      <programlisting>
$arr1 = $arr2 = array ("img12.png","img10.png","img2.png","img1.png");
echo "Normaler String-Vergleich\n";
usort($arr1,"strcmp");
print_r($arr1);
echo "\nVergleich mittels natrlicher Ordnung\n";
usort($arr2,"strnatcmp");
print_r($arr2);
      </programlisting>
     </informalexample>
     Der o.a. Code erzeugt die folgende Ausgabe:
     <informalexample>
      <programlisting>
Normaler String-Vergleich
Array
(
    [0] =&gt; img1.png
    [1] =&gt; img10.png
    [2] =&gt; img12.png
    [3] =&gt; img2.png
)

Vergleich mittels natrlicher Ordnung
Array
(
    [0] =&gt; img1.png
    [1] =&gt; img2.png
    [2] =&gt; img10.png
    [3] =&gt; img12.png
)
      </programlisting>
     </informalexample>
     Fr weitere Infos siehe Martin Pool's <ulink
     url="&url.strnatcmp;">Natural Order String Comparison</ulink>
     Seite.
    </para>
    <simpara>
     hnlich anderen String-Vergleichs-Funktionen gibt diese &lt; 0
     zurck, wenn <parameter>str1</parameter> kleiner ist als
     <parameter>str2</parameter> bzw. &gt; 0, wenn
     <parameter>str1</parameter> grer ist als
     <parameter>str2</parameter> oder 0, wenn sie gleich sind.
    </simpara>
    <simpara>
     Dieser Vergleich unterscheidet Gro- und Kleinschreibung.
    </simpara>
    <simpara>
     Siehe auch <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> und
     <function>natcasesort</function> .
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strnatcasecmp">
   <refnamediv>
    <refname>strnatcasecmp</refname>
    <refpurpose>
     String-Vergleich "natrlicher Ordnung" ohne Unterscheidung der
     Schreibweise
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion implementiert einen String-Vergleich wie unter
     <function>strnatcmp</function> mit dem Unterschied, dass hier
     nicht zwischen Gro- und Kleinschreibung unterschieden wird.
     Fr weitere Infos siehe Martin Pool's <ulink
     url="&url.strnatcmp;">Natural Order String Comparison</ulink>
     Seite.
    </para>
    <simpara>
     hnlich anderen String-Vergleichs-Funktionen gibt diese &lt; 0
     zurck, wenn <parameter>str1</parameter> kleiner ist als
     <parameter>str2</parameter> bzw. &gt; 0, wenn
     <parameter>str1</parameter> grer ist als
     <parameter>str2</parameter> oder 0, wenn sie gleich sind.
    </simpara>
    <simpara>
     Siehe auch <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strcmp</function>,
     <function>strncmp</function>, <function>strnatcmp</function>
     und <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>
 
  <refentry id="function.strncmp">
   <refnamediv>
    <refname>strncmp</refname>
    <refpurpose>
     Binary safe string comparison of the first n characters
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion ist hnlich <function>strcmp</function> nur mit dem
     Unterschied, dass sie den maximalen Wert der Zeichen
     (<parameter>len</parameter>) angeben knnen, der verglichen werden
     soll. Ist einer der Strings krzer als
     (<parameter>len</parameter>) wird dessen Lnge fr den Vergleich
     angewendet.
    </para>
    <simpara>
     Gibt &lt; 0 zurck, wenn <parameter>str1</parameter> kleiner ist
     als <parameter>str2</parameter> bzw. &gt; 0, wenn
     <parameter>str1</parameter> grer ist als
     <parameter>str2</parameter> oder 0, wenn sie gleich sind.
    </simpara>
    <simpara>
     Dieser Vergleich unterscheidet Klein- und Groschreibung.
    </simpara>
    <simpara>
     Siehe auch <function>ereg</function>,
     <function>strcasecmp</function>, <function>substr</function>,
     <function>stristr</function>, <function>strcmp</function>
     und <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.str-pad">
   <refnamediv>
    <refname>str_pad</refname>
    <refpurpose>
     Erweitert einen String auf eine bestimmte Lnge unter Verwendung
     eines anderen Strings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Mit dieser Funktion erweitern Sie den String
     <parameter>input</parameter> auf der linken, rechten oder beiden
     Seiten auf die mit dem optionalen Parameter
     <parameter>pad_type</parameter> angegebene Lnge. Wird das
     optionale Argument <parameter>pad_string</parameter> nicht
     angegeben, erfolgt die Erweiterung mit Leerzeichen, ansonsten wird
     hierzu der Inhalt von <parameter>pad_string</parameter> verwendet.
    </para>
    <para>
     Das optionale Argument <parameter>pad_type</parameter> kann
     STR_PAD_RIGHT, STR_PAD_LEFT oder STR_PAD_BOTH sein. Wird
     <parameter>pad_type</parameter> nicht angegeben, so wird per
     default von STR_PAD_RIGHT ausgegangen.
    </para>
    <para>
     Ist der Wert von <parameter>pad_length</parameter> negativ oder
     kleiner als die Lnge des Input-Strings, wird keine Erweiterung
     vorgenommen.
    </para>
    <para>
     <example>
      <title><function>str_pad</function>-Beispiel:</title>
      <programlisting role="php">
$input = "Alien";
print str_pad ($input, 10);                     // Ergebnis "Alien     "
print str_pad ($input, 10, "-=", STR_PAD_LEFT); // Ergebnis "-=-=-Alien"
print str_pad ($input, 10, "_", STR_PAD_BOTH);  // Ergebnis "__Alien___"
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strpos">
   <refnamediv>
    <refname>strpos</refname>
    <refpurpose>
     Ermitteln des ersten Vorkommens innerhalb eines Strings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Gibt als numerischen Wert die Position des ersten Vorkommens
     von <parameter>needle</parameter> innerhalb der Zeichenkette
     <parameter>haystack</parameter> zurck. Anders als bei
     <function>strrpos</function> kann diese Funktion eine komplette
     Zeichenkette untersttzen.
    </para>
    <para>
     Wurde <parameter>needle</parameter> nicht gefunden, wird &false;
     zurck gegeben.
     <note>
      <para>
       Die Meldungen "Zeichen bei Position 0 gefunden (character found
       at position 0)" und "Zeichen nicht gefunden (character not
       found)" werden oft falsch ausgelegt. Hier die Unterscheidung:
       <informalexample>
	<programlisting role="php">
// in PHP 4.0b3 und danach:
$pos = strpos ($mystring, "b");
if ($pos === false) { // Achtung: 3 Gleichheits-Zeichen
    // nicht gefunden...
}

// in Versionen vor 4.0b3:
$pos = strpos ($mystring, "b");
if (is_string ($pos) &amp;&amp; !$pos) {
    // nicht gefunden...
}
	</programlisting>
       </informalexample>
      </para>
     </note>
    </para>
    <para>
     Ist <parameter>needle</parameter> kein String, wird er zu einem
     Integer-Wert umgesetzt und als das diesem Wert entsprechende 
     ASCII-Zeichen angesehen.
    </para>
    <para>
     Der optionale Parameter <parameter>offset</parameter> ermglicht
     es, den Startwert fr die Suche nach <parameter>needle</parameter>
     innerhalb von <parameter>haystack</parameter> anzugeben. Die 
     zurck gegebene Positions-Angabe ist dann relativ zum Anfang von haystack.
    </para>
    <para>
     Siehe auch <function>strrpos</function>,
     <function>strrchr</function>, <function>substr</function>,
     <function>stristr</function> und <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strrchr">
   <refnamediv>
    <refname>strrchr</refname>
    <refpurpose>
     Findet das letzte Vorkommen eines Zeichens innerhalb einer
     Zeichenkette
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion gibt den letzten Teil des Strings
     <parameter>haystack</parameter> zurck, der ab dem letzten
     Vorkommen von <parameter>needle</parameter> steht (bis zum Ende).
    </para>
    <para>
     Wird <parameter>needle</parameter> nicht gefunden, wird &false;
     zurck gegeben.
    </para>
    <para>
     Enthlt <parameter>needle</parameter> mehr als ein Zeichen, wird
     nur das erste Zeichen genommen.
    </para>
    <para>
     Ist <parameter>needle</parameter> kein String, wird er zu einem
     Integer-Wert umgesetzt und als das diesem Wert entsprechende 
     ASCII-Zeichen angesehen.
     <example>
      <title><function>strrchr</function>-Beispiel:</title>
      <programlisting role="php">
// hole das letzte Verzeichnis aus $PATH
$dir = substr (strrchr ($PATH, ":"), 1);

// hole alles nach dem letzten "Neue-Zeile"
$text = "Zeile 1\nZeile 2\nZeile 3";
$last = substr (strrchr ($text, 10), 1 );
      </programlisting>
     </example>
    </para>
    <para>
     Siehe auch <function>substr</function>,
     <function>stristr</function> und <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.str-repeat">
   <refnamediv>
    <refname>str_repeat</refname>
    <refpurpose>Wiederholung eine String-Ausgabe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Die Ausgabe von <parameter>input_str</parameter> wird
     <parameter>multiplier</parameter> mal wiederholt.
     <parameter>Multiplier</parameter> muss grsser als 0 sein.
    </para>
    <example>
     <title><function>str_repeat</function>-Beispiel:</title>
     <programlisting role="php">
echo str_repeat ("-=", 10);
     </programlisting>
    </example>
    <para>
     Es wird "-=-=-=-=-=-=-=-=-=-=" ausgegeben.
    </para>
    <note>
     <para>
      Verfgbar ab PHP 4.0.
     </para> 
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.strrev">
   <refnamediv>
    <refname>strrev</refname>
    <refpurpose>Umdrehen eines Strings</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>strrev</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dreht die Schreibweise von <parameter>string</parameter> um.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strrpos">
   <refnamediv>
    <refname>strrpos</refname>
    <refpurpose>
     Findet letztes Vorkommen eines Zeichens in einem String
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Der Wert des letzen Vorkommens von <parameter>needle</parameter>
     im String <parameter>haystack</parameter> wird ermittelt.
     <parameter>Needle</parameter> darf nur ein einzelnes Zeichen sein.
     Wird als <parameter>needle</parameter> eine Zeichenkette
     bergeben, wird nur dessen erster Buchstabe ausgewertet.
    </para>
    <para>
     Wurde <parameter>needle</parameter> nicht gefunden, wird &false;
     zurck gegeben.
    </para>
    <para>
     Ist <parameter>needle</parameter> kein String, wird er zu einem
     Integer-Wert umgesetzt und als das diesem Wert entsprechende 
     ASCII-Zeichen angesehen.
    </para>
    <para>
     Siehe auch <function>strpos</function>,
     <function>strrchr</function>, <function>substr</function>,
     <function>stristr</function> und <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strspn">
   <refnamediv>
    <refname>strspn</refname>
    <refpurpose>
     Ermittelt die Lnge der bereinstimmenden Zeichen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
    <para>
 		 Ermittelt die Anzahl der Zeichen am Anfang von 
		 <parameter>str1</parameter>, die aus dem in
     <parameter>str2</parameter> bergebenen 
     Zeichenvorrat stammen.   
    </para>
    <para>    
     So ergibt z.B.
  	 <informalexample>
		  <programlisting role="php">
strspn("42 ist die Antwort, was ist die Frage ...","1234567890");
		  </programlisting>
     </informalexample>
     als Ergebnis 2.
    </para>
   <simpara>
     Siehe auch <function>strcspn</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strstr">
   <refnamediv>
    <refname>strstr</refname>
    <refpurpose>Findet das erste Vorkommen eines Strings</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Es wird alles von <parameter>haystack</parameter> zurck gegeben
     ab der ersten Fundstelle von <parameter>needle</parameter> bis zum
     Ende.
    </para>
    <para>
     Falls <parameter>needle</parameter> nicht gefunden wird, ist das
     Ergebnis &false;.
    </para>
    <para>
     Ist <parameter>needle</parameter> kein String, wird er zu einem
     Integer-Wert umgesetzt und als das diesem Wert entsprechende 
     ASCII-Zeichen angesehen.
    </para>
    <para>
     Diese Funktion unterscheidet zwischen Gro- und Kleinschreibung.
     Ist keine Unterscheidung gewnscht / erforderlich, sollten Sie
     <function>stristr</function> verwenden.
    </para>
    <para> 
     <example>
      <title><function>strstr</function>-Beispiel:</title>
      <programlisting role="php">
$email = 'sterling@designmultimedia.com';
$domain = strstr ($email, '@');
print $domain; // gibt @designmultimedia.com zurck
      </programlisting>
     </example> 
    </para>
    <para>
     Siehe auch <function>stristr</function>,
     <function>strrchr</function>, <function>substr</function> und
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtok">
   <refnamediv>
    <refname>strtok</refname>
    <refpurpose>Zerlegt einen String</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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> wird benutzt, um einen String
     (<parameter>arg1</parameter>) zu teilen. Den Satz "Das ist ein
     Beispiel" knnen Sie in seine einzelnen Wrter zerlegen, in dem
     Sie das Leerzeichen als Trennzeichen (<parameter>arg2</parameter>)
     angeben.
     <example>
      <title><function>strtok</function>-Beispiel:</title>
      <programlisting role="php">
$string = "Das ist noch ein Beispiel";
$tok = strtok ($string," ");
while ($tok) {
    echo "Wort=$tok&lt;br>";
    $tok = strtok (" ");
}
      </programlisting>
     </example>
    </para>
    <para>
     Beachten Sie, dass der zu zerlegende String nur beim ersten Aufruf
     von <function>strtok</function> angegeben werden muss. Die
     nachfolgenden Aufrufe brauchen nur das Trennzeichen als Parameter.
     Falls Sie eine neue Zeichenkette zerlegen wollen, rufen Sie
     <function>strtok</function> wieder mit dem Parameter
     <parameter>arg1</parameter> auf. Das initialisiert die Funktion.
     Sie knnen auch meherere Trennzeichen in
     <parameter>arg2</parameter> angeben. Die Trennung erfolgt beim
     ersten Auftreten eines beliebigen Zeichens aus
     <parameter>arg2</parameter>.
    </para>
    <para>
     Beachten Sie, dass die Teile auch "0" sein knnen. Dies entspricht
     in bedingten Ausdrcken dem Wert &false;.
    </para>
    <para>
     Siehe auch <function>split</function> und
     <function>explode</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtolower">
   <refnamediv>
    <refname>strtolower</refname>
    <refpurpose>Setzt einen String in Kleinbuchstaben um</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>strtolower</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt <parameter>string</parameter> zurck, in dem alle Buchstaben
     in Kleinbuchstaben umgewandelt wurden.
    </para>
    <para>
     Beachten Sie, dass 'Buchstaben' vom Wert locale abhngig ist. Ist
     z.B. die Voreinstellung fr locale "C", werden keine Umlaute (, 
     , ) umgewandelt.
    </para>
    <example>
     <title><function>strtolower</function>-Beispiel:</title>
     <programlisting role="php">
$str = "Dieter B. (M.T.) Ist Ein Schaf und Er LIEBT Sich So";
$str = strtolower($str);	
print $str; // Gibt "dieter b. (m.t.) ist ein schaf und er liebt sich 
            // so" aus.
     </programlisting>
    </example>
    <para>
     Siehe auch <function>strtoupper</function>
     und <function>ucfirst</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtoupper">
   <refnamediv>
    <refname>strtoupper</refname>
    <refpurpose>Setzt einen String in Grobuchstaben um</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>strtoupper</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt <parameter>string</parameter> zurck, in dem alle Buchstaben
     in Grobuchstaben umgewandelt wurden.
    </para>
    <para>
     Beachten Sie, dass 'Buchstaben' vom Wert locale abhngig ist. Ist
     z.B. die Voreinstellung fr locale "C", werden keine Umlaute (, 
     , ) umgewandelt.
    </para>
    <example>
     <title><function>strtoupper</function>-Beispiel:</title>
     <programlisting role="php">
$str = "Dieter B. (M.T.) Ist Ein Schaf und Er LIEBT Sich So";
$str = strtoupper($str);	
print $str; // Gibt "DIETER B. (M.T.) IST EIN SCHAF UND ER LIEBT SICH 
            // SO" aus.
     </programlisting>
    </example>
    <para>
     Siehe auch <function>strtolower</function>
     und <function>ucfirst</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.str-replace">
   <refnamediv>
    <refname>str_replace</refname>
    <refpurpose>
     Ersetzt alle Vorkommen eines Strings in einem anderen String
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion ersetzt alle Vorkommen von
     <parameter>needle</parameter> innerhalb der Zeichenkette
     <parameter>haystack</parameter> durch den String
     <parameter>str</parameter>. Falls Sie keine ausgefallenen
     String-Ersetzungen brauchen, sollten Sie immer dieser Funktion
     den Vorzug vor <function>ereg_replace</function> geben.
    </para>
    <para>
     <example>
      <title><function>str_replace</function>-Beispiel:</title>
      <programlisting role="php">
$bodytag = str_replace ("%body%", "black", "&lt;body text=%body%>");
      </programlisting>
     </example>
    </para>
    <para>
     Diese Funktion beruht auf einem Binr-Vergleich.
    </para>
    <note>
     <para>
      <function>str_replace</function> ist seit PHP 3.0.6 verfgbar,
      war aber bis PHP 3.0.8 fehlerhaft.
     </para>
    </note>
    <para>
     Siehe auch <function>ereg_replace</function> und
     <function>strtr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtr">
   <refnamediv>
    <refname>strtr</refname>
    <refpurpose>Tauscht bestimmte Zeichen aus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Diese Funktion bearbeitet <parameter>str</parameter>, in dem alle
     Vorkommen von Zeichen aus <parameter>from</parameter> in die
     entsprechenden Zeichen aus <parameter>to</parameter> umgesetzt
     werden. Zurck gegeben wird der bearbeitete String.
    </para>
    <para>
     Sind <parameter>from</parameter> und <parameter>to</parameter> von
     unterschiedlicher Lnge werden die berzhligen Zeichen ignoriert.
     <example>
      <title><function>strtr</function>-Beispiel:</title>
      <programlisting role="php">
$addr = strtr($addr, "", "aao");
      </programlisting>
     </example>
    </para>
    <para>
     <function>strtr</function> kann auch mit nur 2 Argumenten
     aufgerufen werden. Die Funktionsweise ist dann anders:
     <parameter>From</parameter> muss dann ein Array sein, welches
     String -> String Paare enthlt, die innerhalb des Quellstrings
     ausgetauscht werden sollen. <parameter>Strtr</parameter> sucht
     immer erst die lngste Entsprechung und wird keine Auswechselungen
     vornehmen, die bereits bearbeitet wurden.
    </para>
    <para>
     Beispiele dazu:
     <informalexample>
      <programlisting role="php">
$trans = array ("hallo" => "hi", "hi" => "hallo");
echo strtr("hi alle, ich sage hallo", $trans) . "\n";
      </programlisting>
     </informalexample>
     Die Ausgabe ist: "hallo alle, ich sage hi",
    </para>
    <note>
     <simpara>
      Die Mglichkeit mit 2 Parametern wurde in PHP 4.0 hinzugefgt.
     </simpara>
    </note>
    <para>
     Siehe auch <function>ereg_replace</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.substr">
   <refnamediv>
    <refname>substr</refname>
    <refpurpose>Gibt einen Teilstring zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     <function>substr</function> gibt den Teil von 
     <parameter>string</parameter> zurck, der durch die 
     <parameter>start</parameter> und <parameter>length</parameter>
     Parameter definiert wurde.
    </para>
    <para>
     Wenn <parameter>start</parameter> positiv ist, beginnt der zurck
     gegebene String an der <parameter>start</parameter>-Position von
     <parameter>string</parameter>, angefangen bei &null;. So ist z.B. im
     String '<literal>abcdef</literal>' das Zeichen an der Position
     <literal>0</literal> gleich '<literal>a</literal>', das Zeichen an
     der Position <literal>2</literal> ist '<literal>c</literal>' usw.
    </para>  
    <para>
     Beispiele:
     <informalexample>
      <programlisting role="php">
$rest = substr ("abcdef", 1);    // gibt "bcdef" zurck
$rest = substr ("abcdef", 1, 3); // gibt "bcd" zurck
      </programlisting>
     </informalexample>
    </para>
    <para>
     Ist <parameter>start</parameter> negativ, gibt er den Beginn-Wert
     ab Ende des Strings an (also rckwrts gezhlt).
    </para>  
    <para>
     Beispiele:
     <informalexample>
      <programlisting role="php">
$rest = substr ("abcdef", -1);     // gibt "f" zurck
$rest = substr ("abcdef", -2);     // gibt "ef" zurck
$rest = substr ("abcdef", -3,  1); // gibt "d" zurck
$rest = substr ("abcdef",  1, -1); // gibt "bcde" zurck
$rest = substr ("abcdef",  4, -4); // gibt "" zurck (nichts)
$rest = substr ("abcdef",  7,  1); // gibt "" zurck (nichts)
$rest = substr ("abcdef",  7, -4); // gibt "" zurck (nichts)
$rest = substr ("abcdef",  4,  4); // gibt "ef" zurck
$rest = substr ("abcdef", -2,  4); // gibt "ef" zurck
$rest = substr ("abcdef", -5, -4); // gibt "b" zurck
      </programlisting>
     </informalexample>
    </para>
    <para>
     Siehe auch <function>strrchr</function> und
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.substr-count">
   <refnamediv>
    <refname>substr_count</refname>
    <refpurpose>
     Ermittelt die Hufigkeit des Vorkommens einer Zeichenkette in
     einem String
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Die Funktion <function>substr_count</function> ermittelt, wie oft
     <parameter>needle</parameter> in dem String
     <parameter>haystack</parameter> vorkommt.
    </para>
    <para>
     <example>
      <title><function>substr_count</function>-Beispiel:</title>
      <programlisting>
print substr_count("Dieser Test ist Mist", "ist"); // ergibt 2
      </programlisting>
     </example>
    </para>
    <para>
     Diese Funktion steht ab PHP 4.0.0 zur Verfgung.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.substr-replace">
   <refnamediv>
    <refname>substr_replace</refname>
    <refpurpose>Ersetzt Text in einer Zeichenkette</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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> ersetzt den Teil von
     <parameter>string</parameter>, der durch die Parameter
     <parameter>start</parameter> und (optional)
     <parameter>length</parameter> begrenzt wird mit der in 
     <parameter>replacement</parameter> angegeben Zeichnekette. Das
     Ergebnis wird zurck gegeben.
    </para>
    <para>
     Ist <parameter>start</parameter> positiv, beginnt der Austausch
     am Offset <parameter>start</parameter> innerhalb von
     <parameter>string</parameter>.  
    </para>
    <para>
     Ist <parameter>start</parameter> negativ, wird vom Ende der 
     Zeichenkette <parameter>string</parameter> bis zum Wert von 
     <parameter>start</parameter> rckwrts gezhlt und dort mit dem
     Austausch begonnen.
    </para>
    <para>
     Ist <parameter>length</parameter> angegeben und positive, stellt
     dieser Parameter die Lnge des auszuwechselnden Teilstrings dar.
     Ist <parameter>length</parameter> angegeben und negativ, gibt er
     die Zeichenzahl an um die ab Ende von 
     <parameter>string</parameter> rckwrts gezhlt wird. Bis zu
     dieser Stelle erfolgt dann der Austausch.
     Ist <parameter>length</parameter> nicht angegeben, wird
     unterstellt, dass Sie die Ersetzung bis zum String-Ende 
     (strlen(<parameter>string</parameter> )) bezwecken.
    </para>
    <para>
     <example>
      <title><function>substr_replace</function>-Beispiel:</title>
      <programlisting role="php">
&lt;?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var&lt;hr&gt;\n";

/* Diese 2 Beispiele ersetzen alles in $var mit 'bob'. */
echo substr_replace ($var, 'bob', 0) . "&lt;br&gt;\n";
echo substr_replace ($var, 'bob', 0, strlen ($var)) . "&lt;br&gt;\n";

/* Fgt 'bob' am Anfang von $var ein . */
echo substr_replace ($var, 'bob', 0, 0) . "&lt;br&gt;\n";

/* Die nchsten beiden ersetzen 'MNRPQR' in $var durch 'bob'. */
echo substr_replace ($var, 'bob', 10, -1) . "&lt;br&gt;\n";
echo substr_replace ($var, 'bob', -7, -1) . "&lt;br&gt;\n";

/* Lscht 'MNRPQR' aus $var. */
echo substr_replace ($var, '', 10, -1) . "&lt;br&gt;\n";
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Sieehe auch <function>str_replace</function> und
     <function>substr</function>.
    </para>
    <note>
     <simpara>
      <function>substr_replace</function> existiert ab PHP 4.0.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.trim">
   <refnamediv>
    <refname>trim</refname> 
    <refpurpose>
     Entfernt berflssige Zeichen ("whitespace") am Anfang und Ende
     eines Strings
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>trim</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion entfernt Leerraum am Anfang und Ende einer
     Zeichenkette. Der gekrzte String wird zurck gegeben. Als
     berflssige Zeichen werden z.Zt. angesehen: "\n", "\r", "\t",
     "\v", "\0" und normale Leerzeichen.
    </para>
    <para>
     Siehe auch <function>chop</function>, <function>ltrim</function>,
     und <function>rtrim</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ucfirst">
   <refnamediv>
    <refname>ucfirst</refname> 
    <refpurpose>
     Setzt das erste Zeichen eines Strings als Grobuchstabe um
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>ucfirst</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Setzt das erste Zeichen von <parameter>str</parameter> in einen
     Grobuchstaben um, wenn es ein Zeichen des Alphabets ist.
    </para>
    <para>
     Beachten Sie, dass die Zeichen des Alphabets abhngig sind vom
     Wert des gesetzten locale. Ist dieser (Voreinstellung) "C", werden
     die deutschen Umlaute nicht erkannt.
    <example>
        <title><function>ucfirst</function>-Beispiel:</title>
        <programlisting role="php">    
$text = 'markus ist ein kleines schaf.';
$text = ucfirst ($text); // $text ist nun "Markus ist ein kleines
                         // schaf."
        </programlisting>
    </example>
    </para>
    <para>
     Siehe auch <function>strtoupper</function> und
     <function>strtolower</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ucwords">
   <refnamediv>
    <refname>ucwords</refname> 
    <refpurpose>
     Setzt die ersten Buchstaben aller Wrter eines Strings in die
     entsprechenden Grobuchstaben um
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>ucwords</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Setzt die ersten Buchstaben aller Wrter innerhalb von
     <parameter>str</parameter> in die entsprechenden Grobuchstaben
     um, sofern es sich um alphabetische Zeichen handelt.
    </para>
    <para>
     Beachten Sie, dass die Zeichen des Alphabets abhngig sind vom
     Wert des gesetzten locale. Ist dieser (Voreinstellung) "C", werden
     die deutschen Umlaute nicht erkannt.
    <example>
       <title><function>ucwords</function>-Beispiel:</title>
       <programlisting role="php">
$text = "markus ist ein kleines schaf.";
$text = ucwords ($text); // $text ist jetzt: "Markus Ist Ein Kleines
                         // Schaf."
       </programlisting>
    </example>
    </para>
    <para>
     Siehe auch <function>strtoupper</function>,
     <function>strtolower</function> und <function>ucfirst</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.wordwrap">
   <refnamediv>
    <refname>wordwrap</refname>
    <refpurpose>
     Zeilenumbruch eines Strings an einer angegebenen Stelle unter
     Verwendung eines angegebenen Trennzeichens
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</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>
     Bricht den String <parameter>str</parameter> an der mittels
     <parameter>width</parameter> angegebenen
     Position in die nchste Zeile um. Der Umbruch geschieht mit
     dem <parameter>break</parameter> Parameter.
    </para>
    <para>
     Die Funktion <function>wordwrap</function> bricht selbst an der
     Spalte 75 unter Verwendung des Steuerzeichens '\n' (neue Zeile)
     um, wenn die optionalen Parameter <parameter>width</parameter>
     und / oder <parameter>break</parameter> nicht angegeben werden.
    </para>
    <para>
     Steht <parameter>cut</parameter> auf 1, wird der String immer an
     der vorgegebenen Lnge umgebrochen. Ist ein Wort also lnger als
     die gegebene Lnge, wird es mitten drin umgebrochen (siehe zweites
     Beispiel)
    </para>
    <para>
     <example>
      <title><function>wordwrap</function>-Beispiel:</title>
      <programlisting role="php">
$text = "Der schnelle braune Fuchs springt ber den blden Hund.";
$neuertext = wordwrap( $text, 20 );
echo "$neuertext\n";
      </programlisting>
     </example>
    </para>
    <para>
     Dieses Beispiel gibt aus:
    </para>
    <para>
     <informalexample>
      <programlisting>
Der schnelle braune 
Fuchs springt ber den blden Hund.
      </programlisting>
     </informalexample>
    </para>
    <para>
     <example>
      <title><function>wordwrap</function> example</title>
      <programlisting role="php">
$text = "Ein sehr langes Wooooooooooort.";
$neuertext = wordwrap( $text, 8, "\n", 1);
echo "$neuertext\n";
      </programlisting>
     </example>
    </para>
    <para>
     Dieses Beispiel gibt aus:
    </para>
    <para>
     <informalexample>
      <programlisting>
Ein sehr
langes W
oooooooo
ooort.
      </programlisting>
     </informalexample>
    </para>
    <para>
     Siehe auch <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:
-->