[PHP-DOC] cvs: phpdoc /de/functions strings.xml From: Thomas Schuermann (thomas.schuermann <email protected>)
Date: 08/14/00

tschuer Mon Aug 14 13:05:40 2000 EDT

  Modified files:
    /phpdoc/de/functions strings.xml
  Log:
  Some changes (e.g. new or changed functions)
  
Index: phpdoc/de/functions/strings.xml
diff -u phpdoc/de/functions/strings.xml:1.21 phpdoc/de/functions/strings.xml:1.22
--- phpdoc/de/functions/strings.xml:1.21 Wed Jul 12 12:04:38 2000
+++ phpdoc/de/functions/strings.xml Mon Aug 14 13:05:40 2000
@@ -352,6 +352,32 @@
     </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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>crc32</function></funcdef>
+ <paramdef>string <parameter>str</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Berechnet die zyklisch redundante polynomische Prüfsumme mit einer
+ Länge von 32-Bit für <parameter>str</parameter>. Dies wird regulär
+ für die Integritätsprüfung übermittelter Daten verwendet.
+ </para>
+ <para>
+ Siehe auch: <function>md5</function>.
+ </para>
+ </refsect1>
+ </refentry>
  
   <refentry id="function.crypt">
    <refnamediv>
@@ -430,6 +456,9 @@
      Der veschlüsselte String kann nicht entschlüsselt werden, da
      <function>crypt</function> eine Einweg-Verschlüsselung ist.
     </simpara>
+ <simpara>
+ Siehe auch: <function>md5</function>.
+ </simpara>
    </refsect1>
   </refentry>
 
@@ -666,6 +695,68 @@
    </refsect1>
   </refentry>
 
+ <refentry id="function.hebrev">
+ <refnamediv>
+ <refname>hebrev</refname>
+ <refpurpose>
+ Konvertiert (natürlichen) hebräischen Text in sichtbaren Text
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung:</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>hebrev</function></funcdef>
+ <paramdef>string <parameter>hebrew_text</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>max_chars_per_line</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Der optionale Parameter <parameter>max_chars_per_line</parameter>
+ entspricht der Zeichenzahl pro Ausgabe-Zeile. Wortbrüche werden,
+ soweit möglich, vermieden.
+ </para>
+ <para>
+ Siehe auch: <function>hebrevc</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.hebrevc">
+ <refnamediv>
+ <refname>hebrevc</refname>
+ <refpurpose>
+ Konvertiert (natürlichen) hebräischen Text in sichtbaren Text
+ incl. Anpassung von Zeilenumbrüchen
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung:</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>hebrevc</function></funcdef>
+ <paramdef>string <parameter>hebrew_text</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>max_chars_per_line</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion ist gleich <function>hebrev</function>, mit dem
+ Unterschied, dass Zeilenumbrüche (\n) zu "&lt;br&gt;\n"
+ umgewandelt werden. Der optionale Parameter
+ <parameter>max_chars_per_line</parameter> entspricht der
+ Zeichenzahl pro Ausgabe-Zeile. Wortbrüche werden, soweit möglich,
+ vermieden.
+ </para>
+ <para>
+ Siehe auch: <function>hebrev</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
   <refentry id="function.htmlentities">
    <refnamediv>
     <refname>htmlentities</refname>
@@ -903,6 +994,9 @@
      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>
 
@@ -1242,7 +1336,8 @@
     </simpara>
     <simpara>
      Siehe auch <function>print</function>,
- <function>sprintf</function> und <function>flush</function>.
+ <function>sprintf</function>, <function>sscanf</function>,
+ <function>fscanf</function> und <function>flush</function>.
     </simpara>
    </refsect1>
   </refentry>
@@ -1302,75 +1397,94 @@
    </refsect1>
   </refentry>
 
- <refentry id="function.rawurldecode">
+ <refentry id="function.rtrim">
    <refnamediv>
- <refname>rawurldecode</refname>
- <refpurpose>Dekodierung von URL-kodierten Strings</refpurpose>
+ <refname>rtrim</refname>
+ <refpurpose>Entfernt Leerzeichen am String-Ende</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Beschreibung:</title>
     <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>rawurldecode</function></funcdef>
- <paramdef>string <parameter>str</parameter></paramdef>
- </funcprototype>
+ <funcdef>string <function>rtrim</function></funcdef>
+ <paramdef>string <parameter>str</parameter></paramdef>
     </funcsynopsis>
     <para>
- Gibt einen String zurück, in dem die Abschnitte, die mit einem
- Prozent-Zeichen (<literal>%</literal>) beginnen (dem ein 2-stelliger
- hexadezimal-Wert folgt), ersetzt wurden durch Buchstaben. So wird
- z.B. die Zeichenkette <screen>foo%20bar%40baz</screen> umgewandelt
- in <screen>foo bar <email protected></screen>.
+ Gibt den als Argument übergebenen String ohne abschließende
+ 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>
- <simpara>
- Siehe auch <function>rawurlencode</function>.
- </simpara>
+ <para>
+ Siehe auch <function>trim</function> und
+ <function>ltrim</function>.
+ </para>
    </refsect1>
   </refentry>
 
- <refentry id="function.rawurlencode">
+ <refentry id="function.sscanf">
    <refnamediv>
- <refname>rawurlencode</refname>
- <refpurpose>URL-Kodierung nach RFC 1738</refpurpose>
+ <refname>sscanf</refname>
+ <refpurpose>
+ Übertragt die Eingaben eines Strings in ein angegebenes Format
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Beschreibung:</title>
     <funcsynopsis>
      <funcprototype>
- <funcdef>string <function>rawurlencode</function></funcdef>
+ <funcdef>mixed <function>sscanf</function></funcdef>
       <paramdef>string <parameter>str</parameter></paramdef>
+ <paramdef>string <parameter>format</parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>var1</optional></parameter>...
+ </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
- Gibt eine Zeichenkette zurück, in der alle Sonderzeichen ausser
- <screen>-_.</screen> durch ein Prozent-Zeichen
- (<literal>%</literal>), gefolgt von einer 2-stelligen hexadezimalen
- Zahl, ersetzt worden sind. Dies ist die Kodierung nach RFC 1738
- zum Schutz von Zeichen, die als spezielle URL-Trennzeichen zu
- interpretieren sind oder die vor einer Umwandlung durch
- Übertragungs-Medien mit Zeichen-Konvertierung (z.B. einige
- E-Mail-Systeme) bewahrt werden sollen.
- Falls sie z.B. ein Passwort in eine FTP-URL einbinden wollen:
+ 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
+ zurück gegeben.
      <example>
- <title><function>Rawurlencode</function>-Beispiel 1:</title>
+ <title><function>Sscanf</function>-Beispiel:</title>
       <programlisting role="php">
-echo '&lt;A HREF="ftp://user:', rawurlencode ('foo @+%/'),
- ' <email protected>/x.txt">';
+// 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>
- Oder sie wollen Informationen in der Pfadangabe der URL
- übertragen:
+ Werden optionale Parameter übergeben, gibt die Funktion die Anzahl
+ der ermittelten Werte zurück. Die optionalen Parameter müssen
+ refenziert übergeben werden.
      <example>
- <title><function>Rawurlencode</function>-Beispiel 2:</title>
+ <title>
+ <function>Sscanf</function> - Gebrauch optionaler Parameter
+ </title>
       <programlisting role="php">
-echo '&lt;A HREF="http://x.de/leitung_list_skript/',
- rawurlencode ('verkauf und marketing/Hamburg'), '">';
+// 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>
- <simpara>
- Siehe auch <function>rawurldecode</function>.
- </simpara>
+ <para>
+ Siehe auch: <function>fscanf</function>,
+ <function>printf</function> und <function>sprintf</function>.
+ </para>
    </refsect1>
   </refentry>
 
@@ -1646,7 +1760,8 @@
      </orderedlist>
     </para>
     <simpara>
- Siehe auch: <function>printf</function> und
+ Siehe auch: <function>printf</function>,
+ <function>sscanf</function>, <function>fscanf</function> und
      <function>number_format</function>.
     </simpara>
    </refsect1>
@@ -2314,6 +2429,13 @@
      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 gewünscht / erforderlich, sollten sie
+ <function>stristr</function> verwenden.
+ </para>
+ <para>
      <example>
       <title><function>Strstr</function>-Beispiel:</title>
       <programlisting role="php">