archived-doc-de/reference/strings/functions/wordwrap.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.7 $ -->
<!-- EN-Revision: 1.18 Maintainer: sammywg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.wordwrap">
 <refnamediv>
  <refname>wordwrap</refname>
  <refpurpose>Bricht einen String nach einer bestimmten Anzahl Zeichen um</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>wordwrap</methodname>
   <methodparam><type>string</type><parameter>str</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>width</parameter><initializer>75</initializer></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>break</parameter><initializer>"\n"</initializer></methodparam>
   <methodparam choice="opt"><type>bool</type><parameter>cut</parameter><initializer>false</initializer></methodparam>
  </methodsynopsis>
  <para>
   Bricht einen String nach einer bestimmten Anzahl Zeichen mittels eines
   angegebenen Trennzeichens um.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>str</parameter></term>
     <listitem>
      <para>
       Die Eingabezeichenkette.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>width</parameter></term>
     <listitem>
      <para>
       Die Spaltenbreite des Umbruchs. Standardwert sind 75 Zeichen.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>break</parameter></term>
     <listitem>
      <para>
       Der optionale Parameter <parameter>break</parameter> wird als Zeichen(kette)
       für den Zeilenumbruch verwendet. Standardwert ist '<literal>\n</literal>'.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>cut</parameter></term>
     <listitem>
      <para>
       Wenn der Parameter <parameter>cut</parameter> auf &true; gesetzt ist,
       wird die Zeichenkette immer nach der angegebenen Länge umgebrochen.
       Wenn sie also ein Wort haben, das länger als die angegebene
       Maximallänge ist, wird der Umbruch im Wort selbst durchgeführt (siehe
       zweites Beispiel).
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Gibt die übergebene Zeichenkette zurück, die an der angegebenen Trennstelle
   umgebrochen wurde.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>4.0.3</entry>
       <entry>
        Der optionale Parameter <parameter>cut</parameter> wurde hinzugefügt.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>wordwrap</function>-Beispiel</title>
    <programlisting role="php">
<![CDATA[
$text = "Der schnelle braune Fuchs sprang über den faulen Hund.";
$neuertext = wordwrap( $text, 20, "<br />\n" );

echo $neuertext;
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Der schnelle braune<br />
Fuchs sprang über<br />
den faulen Hund.
]]>
    </screen>
   </example>
   <example>
    <title><function>wordwrap</function>-Beispiel</title>
    <programlisting role="php">
<![CDATA[
$text = "Ein sehr langes Wooooooooooort.";
$neuertext = wordwrap($text, 8, "\n", true);

echo "$neuertext\n";
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Ein sehr
langes
Wooooooo
oooort.
]]>
    </screen>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>nl2br</function></member>
    <member><function>chunk_split</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>


<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->