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

tschuer Sun Jul 9 11:51:40 2000 EDT

  Modified files:
    /phpdoc/de/functions strings.xml
  Log:
  Some minor corrections and docu for str_pad
  
Index: phpdoc/de/functions/strings.xml
diff -u phpdoc/de/functions/strings.xml:1.18 phpdoc/de/functions/strings.xml:1.19
--- phpdoc/de/functions/strings.xml:1.18 Sat Jul 8 10:53:49 2000
+++ phpdoc/de/functions/strings.xml Sun Jul 9 11:51:39 2000
@@ -1973,6 +1973,64 @@
    </refsect1>
   </refentry>
 
+ <refentry id="function.str-pad">
+ <refnamediv>
+ <refname>str_pad</refname>
+ <refpurpose>
+ Erweitert einen String auf eine bestimmte Länge unter Verwendung
+ eines anderen Strings
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung:</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>str_pad</function></funcdef>
+ <paramdef>string <parameter>input</parameter></paramdef>
+ <paramdef>int <parameter>pad_length</parameter></paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>pad_string</optional></parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter><optional>pad_type</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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 Länge. 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 Länge 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>