svn: /phpdoc/de/trunk/reference/ apache/functions/apache-note.xml com/com/construct.xml com/variant/construct.xml exec/functions/shell-exec.xml exif/constants.xml strings/functions/fprintf.xml strings/functions/printf.xml strings/functions/setlocale.xml strings/functions/sprintf.xml strings/functions/sscanf.xml strings/functions/strip-tags.xml strings/functions/vfprintf.xml strings/functions/vprintf.xml strings/functions/vsprintf.xml
[email protected] (Christoph Michael Becker)
| Newsgroups | php.doc.de |
|---|---|
| Message-ID | <[email protected]> |
cmb Sun, 24 Nov 2019 11:03:29 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=348344
Log:
Sync with EN
Changed paths:
U phpdoc/de/trunk/reference/apache/functions/apache-note.xml
U phpdoc/de/trunk/reference/com/com/construct.xml
U phpdoc/de/trunk/reference/com/variant/construct.xml
U phpdoc/de/trunk/reference/exec/functions/shell-exec.xml
U phpdoc/de/trunk/reference/exif/constants.xml
U phpdoc/de/trunk/reference/strings/functions/fprintf.xml
U phpdoc/de/trunk/reference/strings/functions/printf.xml
U phpdoc/de/trunk/reference/strings/functions/setlocale.xml
U phpdoc/de/trunk/reference/strings/functions/sprintf.xml
U phpdoc/de/trunk/reference/strings/functions/sscanf.xml
U phpdoc/de/trunk/reference/strings/functions/strip-tags.xml
U phpdoc/de/trunk/reference/strings/functions/vfprintf.xml
U phpdoc/de/trunk/reference/strings/functions/vprintf.xml
U phpdoc/de/trunk/reference/strings/functions/vsprintf.xml
svn-diffs-348344.txt
(text/x-diff, 38.5 KB)
Modified: phpdoc/de/trunk/reference/apache/functions/apache-note.xml
===================================================================
--- phpdoc/de/trunk/reference/apache/functions/apache-note.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/apache/functions/apache-note.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 323349 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 348317 Maintainer: sammywg Status: ready -->
<refentry xml:id="function.apache-note" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -13,8 +13,12 @@
<methodsynopsis>
<type>string</type><methodname>apache_note</methodname>
<methodparam><type>string</type><parameter>note_name</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>note_value</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
+ <methodsynopsis>
+ <type>string</type><methodname>apache_note</methodname>
+ <methodparam><type>string</type><parameter>note_name</parameter></methodparam>
+ <methodparam><type>string</type><parameter>note_value</parameter></methodparam>
+ </methodsynopsis>
<para>
Diese Funktion ist ein Wrapper für das <literal>table_get</literal> und
<literal>table_set</literal> von Apache. Sie editiert die Notestabelle, die
Modified: phpdoc/de/trunk/reference/com/com/construct.xml
===================================================================
--- phpdoc/de/trunk/reference/com/com/construct.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/com/com/construct.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 347688 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 347692 Maintainer: nobody Status: ready -->
<refentry xml:id="com.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -13,8 +13,8 @@
<constructorsynopsis role="oop">
<methodname>COM::__construct</methodname>
<methodparam><type>string</type><parameter>module_name</parameter></methodparam>
- <methodparam choice="opt"><type>mixed</type><parameter>server_name</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>codepage</parameter></methodparam>
+ <methodparam choice="opt"><type>mixed</type><parameter>server_name</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>codepage</parameter><initializer>CP_ACP</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>typelib</parameter></methodparam>
</constructorsynopsis>
<para>
Modified: phpdoc/de/trunk/reference/com/variant/construct.xml
===================================================================
--- phpdoc/de/trunk/reference/com/variant/construct.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/com/variant/construct.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 347688 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 347692 Maintainer: nobody Status: ready -->
<refentry xml:id="variant.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -12,9 +12,9 @@
&reftitle.description;
<constructorsynopsis role="oop">
<methodname>VARIANT::__construct</methodname>
- <methodparam choice="opt"><type>mixed</type><parameter>value</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>codepage</parameter></methodparam>
+ <methodparam choice="opt"><type>mixed</type><parameter>value</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>type</parameter><initializer>VT_EMPTY</initializer></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>codepage</parameter><initializer>CP_ACP</initializer></methodparam>
</constructorsynopsis>
<para>
Konstruiert ein neues VARIANT Objekt.
Modified: phpdoc/de/trunk/reference/exec/functions/shell-exec.xml
===================================================================
--- phpdoc/de/trunk/reference/exec/functions/shell-exec.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/exec/functions/shell-exec.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 348185 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 348273 Maintainer: sammywg Status: ready -->
<refentry xml:id='function.shell-exec' xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>shell_exec</refname>
Modified: phpdoc/de/trunk/reference/exif/constants.xml
===================================================================
--- phpdoc/de/trunk/reference/exif/constants.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/exif/constants.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 342647 Maintainer: tihox Status: ready -->
+<!-- EN-Revision: 348315 Maintainer: tihox Status: ready -->
<appendix xml:id="exif.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
Modified: phpdoc/de/trunk/reference/strings/functions/fprintf.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/fprintf.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/strings/functions/fprintf.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 346102 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 347041 Maintainer: sammywg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fprintf">
<refnamediv>
@@ -32,16 +32,8 @@
&fs.file.pointer;
</listitem>
</varlistentry>
+ &strings.parameter.format;
<varlistentry>
- <term><parameter>format</parameter></term>
- <listitem>
- <para>
- Der Parameter <parameter>format</parameter> wird in der Dokumentation von
- <function>sprintf</function> beschrieben.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
<term><parameter>...</parameter></term>
<listitem>
<para>
@@ -108,10 +100,13 @@
<simplelist>
<member><function>printf</function></member>
<member><function>sprintf</function></member>
+ <member><function>vprintf</function></member>
+ <member><function>vsprintf</function></member>
+ <member><function>vfprintf</function></member>
<member><function>sscanf</function></member>
<member><function>fscanf</function></member>
- <member><function>vsprintf</function></member>
<member><function>number_format</function></member>
+ <member><function>date</function></member>
</simplelist>
</para>
</refsect1>
Modified: phpdoc/de/trunk/reference/strings/functions/printf.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/printf.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/strings/functions/printf.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 325214 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 347601 Maintainer: sammywg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.printf">
<refnamediv>
<refname>printf</refname>
@@ -12,7 +12,6 @@
<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>
<methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
</methodsynopsis>
<simpara>
@@ -24,23 +23,8 @@
&reftitle.parameters;
<para>
<variablelist>
+ &strings.parameter.format;
<varlistentry>
- <term><parameter>format</parameter></term>
- <listitem>
- <para>
- <parameter>Format</parameter> wird in der Dokumentation zu
- <function>sprintf</function> näher beschrieben.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>args</parameter></term>
- <listitem>
- <para>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
<term><parameter>...</parameter></term>
<listitem>
<para>
@@ -58,6 +42,89 @@
</para>
</refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <example>
+ <title><function>printf</function>: Verschiedene Beispiele</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$n = 43951789;
+$u = -43951789;
+$c = 65; // ASCII 65 is 'A'
+
+// Beachten Sie das doppelte %%, dies gibt ein '%'-Zeichen aus
+printf("%%b = '%b'\n", $n); // Binärdarstellung
+printf("%%c = '%c'\n", $c); // Ausgabe des ASCII-Zeichens; gleicht der chr() Funktion
+printf("%%d = '%d'\n", $n); // Standard-Integerdarstellung
+printf("%%e = '%e'\n", $n); // Wissenschaftliche Notation
+printf("%%u = '%u'\n", $n); // vorzeichenlose Integerdarstellung einer positiven Zahl
+printf("%%u = '%u'\n", $u); // vorzeichenlose Integerdarstellung einer negativen Zahl
+printf("%%f = '%f'\n", $n); // Fließkommazahldarstellung
+printf("%%o = '%o'\n", $n); // Oktaldarstellung
+printf("%%s = '%s'\n", $n); // Stringdarstellung
+printf("%%x = '%x'\n", $n); // Hexadezimaldarstellung (Kleinbuchstaben)
+printf("%%X = '%X'\n", $n); // Hexadezimaldarstellung (Großbuchstaben)
+
+printf("%%+d = '%+d'\n", $n); // Vorzeichenangabe für positive Integerzahlen
+printf("%%+d = '%+d'\n", $u); // Vorzeichenangabe für negative Integerzahlen
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+%b = '10100111101010011010101101'
+%c = 'A'
+%d = '43951789'
+%e = '4.39518e+7'
+%u = '43951789'
+%u = '4251015507'
+%f = '43951789.000000'
+%o = '247523255'
+%s = '43951789'
+%x = '29ea6ad'
+%X = '29EA6AD'
+%+d = '+43951789'
+%+d = '-43951789'
+]]>
+ </screen>
+ </example>
+ <example>
+ <title><function>printf</function>: Stringformatierung</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$s = 'monkey';
+$t = 'many monkeys';
+
+printf("[%s]\n", $s); // normale rechtsbündige Ausgabe
+printf("[%10s]\n", $s); // rechtsbündige Ausgabe, mit Leerzeichen aufgefüllt
+printf("[%-10s]\n", $s); // linksbündige Ausgabe, mit Leerzeichen aufgefüllt
+printf("[%010s]\n", $s); // auffüllen mit Nullen funktioniert auch bei Strings
+printf("[%'#10s]\n", $s); // Verwendung des benutzerdefinierten Auffüllzeichens '#'
+printf("[%10.9s]\n", $t); // rechtsbündige Ausgabe mit Abschneiden überflüssiger
+ // Buchstaben nach der achten Stelle
+printf("[%-10.9s]\n", $t); // linksbündige Ausgabe mit Abschneiden überflüssiger
+ // Buchstaben nach der achten Stelle
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+[monkey]
+[ monkey]
+[monkey ]
+[0000monkey]
+[####monkey]
+[ many monk]
+[many monk ]
+]]>
+ </screen>
+ </example>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -64,9 +131,14 @@
<simplelist>
<member><function>print</function></member>
<member><function>sprintf</function></member>
+ <member><function>fprintf</function></member>
<member><function>vprintf</function></member>
+ <member><function>vsprintf</function></member>
+ <member><function>vfprintf</function></member>
<member><function>sscanf</function></member>
<member><function>fscanf</function></member>
+ <member><function>number_format</function></member>
+ <member><function>date</function></member>
<member><function>flush</function></member>
</simplelist>
</para>
Modified: phpdoc/de/trunk/reference/strings/functions/setlocale.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/setlocale.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/strings/functions/setlocale.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 341282 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 348286 Maintainer: sammywg Status: ready -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.setlocale">
<refnamediv>
Modified: phpdoc/de/trunk/reference/strings/functions/sprintf.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/sprintf.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/strings/functions/sprintf.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 346810 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 347041 Maintainer: sammywg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sprintf">
<refnamediv>
@@ -25,209 +25,36 @@
&reftitle.parameters;
<para>
<variablelist>
+ &strings.parameter.format;
<varlistentry>
- <term><parameter>format</parameter></term>
+ <term><parameter>...</parameter></term>
<listitem>
<para>
- Der Formatierungs-String wird aus null oder mehreren Anweisungen
- gebildet: Gewöhnliche Zeichen (außer <literal>%</literal>), die direkt in
- das Ergebnis übertragen werden, und
- <emphasis>Umsetzungs-Anweisungen</emphasis>. Jede dieser Anweisungen holt
- sich als Resultat ihre eigenen Parameter. Diese Anweisungen gelten sowohl
- für die <function>sprintf</function>- als auch für die
- <function>printf</function>-Funktion.
</para>
- <para>
- Jede der Formatierungs-Anweisungen besteht aus einem
- Prozent-Zeichen (<literal>%</literal>), gefolgt von einem oder mehreren
- der folgenden Elemente:
- <orderedlist>
- <listitem>
- <simpara>
- Eine optionale <emphasis>Vorzeichenangabe</emphasis>, die die
- Verwendung eines Vorzeichens (- oder +) vor einer Zahl erzwingt.
- Standardmäßig wird nur das - Zeichen vor negativen Zahlen verwendet.
- Die Vorzeichenangabe erzwingt, dass positive Zahlen ein + Zeichen
- vorangestellt bekommen.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Ein optionales <emphasis>Füllzeichen</emphasis>, das festlegt, mit
- welchem Zeichen ein String bis zum Erreichen einer bestimmten Länge
- aufgefüllt wird. Dies kann ein Leerzeichen oder eine
- <literal>0</literal> (das Null-Zeichen) sein. Standardmäßig wird
- mit dem Leerzeichen gefüllt. Andere Füllzeichen können durch
- Voranstellen eines einfachen Anführungszeichens (<literal>'</literal>)
- definiert werden. Beachten Sie die nachstehenden Beispiele.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Eine optionale Angabe der <emphasis>Ausrichtung</emphasis>, die
- bestimmt, ob das Ergebnis rechts- oder linksbündig ausgerichtet werden
- soll. Das Standardverhalten ist rechtsbündige Ausrichtung, ein
- <literal>-</literal>-Zeichen an dieser Stelle lässt den Text
- linksbündig erscheinen.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Eine optionale Zahl für die <emphasis>Längenangabe</emphasis>,
- welche die mindestens zurückzugebende Anzahl Zeichen spezifiziert.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Eine optionale <emphasis>Genauigkeitsangabe</emphasis> in der Form
- eines Punktes (<literal>.</literal>) gefolgt von einem optionalen Dezimalstring. Dieser
- drückt aus, wieviele Dezimalstellen für Fließkommazahlen ausgegeben
- werden sollten. Wenn Sie diese Angabe auf einen String anwenden,
- fungiert sie als Grenzpunkt, der die maximale Zeichenzahl der
- ausgegebenen Zeichenkette bestimmt. Zusätzlich kann optional das
- Zeichen, das zum Auffüllen einer Zahl verwendet werden soll, zwischen
- dem Punkt und der Ziffer angegeben werden.
- </simpara>
- </listitem>
- <listitem>
- <para>
- Eine <emphasis>Typangabe</emphasis>, welche den Typ enthält,
- als der das jeweils übergebene Argument angesehen werden soll.
- Mögliche Angaben sind:
- <simplelist>
- <member>
- <literal>%</literal> - ein Prozentzeichen. Es ist kein
- Argument erforderlich.
- </member>
- <member>
- <literal>b</literal> - das Argument wird als Integer
- angesehen und als Binär-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 als vorzeichenbehafteter Dezimalwert
- (signed integer) ausgegeben.
- </member>
- <member>
- <literal>e</literal> - das Argument wird als wissenschaftliche
- Notation betrachtet (z.B. 1.2e+2). Die Genauigkeitsangabe steht
- seit PHP 5.2.1 für die Anzahl der Dezimalstellen. In früheren
- PHP-Versionen wurde sie als signifikante Stelle betrachtet (eine
- Stelle weniger).
- </member>
- <member>
- <literal>E</literal> - wie <literal>%e</literal>, mit dem Unterschied,
- dass ein großes E verwendet wird (z.B. 1.2E+2).
- </member>
- <member>
- <literal>f</literal> - das Argument wird als float angesehen und
- entsprechend der Einstellungen in den locales als Fließkommazahl
- ausgegeben.
- </member>
- <member>
- <literal>F</literal> - das Argument wird als float angesehen und
- unabhängig von den Einstellungen in den locales als Fließkommazahl
- ausgegeben.
- Verfügbar ab PHP 5.0.3.
- </member>
- <member>
- <literal>g</literal> - das Kürzere von <literal>%e</literal> und
- <literal>%f</literal>.
- </member>
- <member>
- <literal>G</literal> - das Kürzere von <literal>%E</literal> und
- <literal>%F</literal>.
- </member>
- <member>
- <literal>o</literal> - das Argument wird als Integer
- angesehen und als Oktalzahl ausgegeben.
- </member>
- <member>
- <literal>s</literal> - das Argument wird als String angesehen
- und auch als solcher ausgegeben.
- </member>
- <member>
- <literal>u</literal> - das Argument wird als Integer
- angesehen und ein positiver vorzeichenloser Dezimalwert (unsigned
- integer) ausgegeben.
- </member>
- <member>
- <literal>x</literal> - das Argument wird als Integer
- angesehen und als Hexadezimalwert ausgegeben (mit
- Kleinbuchstaben).
- </member>
- <member>
- <literal>X</literal> - das Argument wird als Integer
- angesehen und als Hexadezimalwert ausgegeben (mit
- Großbuchstaben).
- </member>
- </simplelist>
- </para>
- </listitem>
- </orderedlist>
- </para>
- <para>
- Variablen werden in einen für die Typangabe passenden Typ konvertiert:
- <table xml:id="sprintf.coercion">
- <title>Typ-Behandlung</title>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>Typ</entry>
- <entry>Typangaben</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><literal>string</literal></entry>
- <entry><literal>s</literal></entry>
- </row>
- <row>
- <entry><literal>integer</literal></entry>
- <entry>
- <literal>d</literal>,
- <literal>u</literal>,
- <literal>c</literal>,
- <literal>o</literal>,
- <literal>x</literal>,
- <literal>X</literal>,
- <literal>b</literal>
- </entry>
- </row>
- <row>
- <entry><literal>double</literal></entry>
- <entry>
- <literal>g</literal>,
- <literal>G</literal>,
- <literal>e</literal>,
- <literal>E</literal>,
- <literal>f</literal>,
- <literal>F</literal>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </para>
- <warning>
- <para>
- Der Versuch der Verwendung einer Kombination von Stringtyp- und
- Längenangaben bei Zeichensätzen, die mehr als ein Byte pro Zeichen
- benötigen, kann zu unerwarteten Ergebnissen führen
- </para>
- </warning>
- <para>
- Der Formatstring unterstützt nummerierte Argumente und kann daher auch
- ihre Position bestimmen (argument numbering/swapping). Hier ein Beispiel:
- <example>
- <title>Argumente tauschen</title>
- <programlisting role="php">
-<![CDATA[
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Gibt eine an Hand des Formatierungs-Strings <parameter>format</parameter>
+ gebildete Zeichenkette zurück. &return.falseforfailure;
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <example>
+ <title>Argumente tauschen</title>
+ <para>
+ Der Formatstring unterstützt nummerierte Argumente und kann daher auch
+ ihre Position bestimmen (argument numbering/swapping).
+ </para>
+ <programlisting role="php">
+<![CDATA[
<?php
$anzahl = 5;
$ort = 'Baum';
@@ -236,31 +63,35 @@
echo sprintf($format, $anzahl, $ort);
?>
]]>
- </programlisting>
- </example>
- Dies wird "Es sind 5 Affen auf dem Baum" ausgeben. Aber nehmen
- wir einmal an, dass wir den Formatstring in einer separaten Datei
- erstellen, da wir ihn internationalisieren wollen und deshalb wie
- folgt umschreiben:
- <example>
- <title>Argumente tauschen</title>
- <programlisting role="php">
+ </programlisting>
+ &example.outputs;
+ <screen>
<![CDATA[
+Es sind 5 Affen auf dem Baum
+]]>
+ </screen>
+ <para>
+ Aber nehmen
+ wir einmal an, dass wir den Formatstring in einer separaten Datei
+ erstellen, da wir ihn internationalisieren wollen und deshalb wie
+ folgt umschreiben:
+ </para>
+ <programlisting role="php">
+<![CDATA[
<?php
$format = 'Der %s enthält %d Affen';
echo sprintf($format, $anzahl, $ort);
?>
]]>
- </programlisting>
- </example>
- Nun haben wir ein Problem. Die Reihenfolge der Platzhalter im
- Formatstrings entspricht nicht mehr der Reihenfolge der Argumente im
- Code. Wir würden gern den Code belassen wie er ist und einfach im
- Formatstring angeben, welche Argumenten welchen Platzhaltern entsprechen.
- Wir würden dann den Formatstring wie folgt schreiben:
- <example>
- <title>Argumente tauschen</title>
- <programlisting role="php">
+ </programlisting>
+ <para>
+ Nun haben wir ein Problem. Die Reihenfolge der Platzhalter im
+ Formatstrings entspricht nicht mehr der Reihenfolge der Argumente im
+ Code. Wir würden gern den Code belassen wie er ist und einfach im
+ Formatstring angeben, welche Argumenten welchen Platzhaltern entsprechen.
+ Wir würden dann den Formatstring wie folgt schreiben:
+ </para>
+ <programlisting role="php">
<![CDATA[
<?php
$format = 'Der %2$s enthält %1$d Affen';
@@ -267,13 +98,12 @@
echo sprintf($format, $anzahl, $ort);
?>
]]>
- </programlisting>
- </example>
- Ein weiterer Vorteil ist, dass wir nun die Platzhalter wiederholen
- können, ohne mehr Argumente im Code hinzufügen zu müssen. Zum Beispiel:
- <example>
- <title>Argumente tauschen</title>
- <programlisting role="php">
+ </programlisting>
+ <para>
+ Ein weiterer Vorteil ist, dass die Platzhalter wiederholt werden
+ können, ohne mehr Argumente im Code hinzufügen zu müssen.
+ </para>
+ <programlisting role="php">
<![CDATA[
<?php
$format = 'Der %2$s enthält %1$d Affen.
@@ -281,107 +111,21 @@
echo sprintf($format, $anzahl, $ort);
?>
]]>
- </programlisting>
- </example>
- Wenn Argumenttausch verwendet wird muss die <literal>n$</literal>
- <emphasis>Positionsangabe</emphasis>
- direkt nach dem Prozentzeichen (<literal>%</literal>) folgen, vor
- jeglichen anderen Angaben, wie im Beispiel unten zu sehen ist.
- <example>
- <title>Angabe von Füllzeichen</title>
- <programlisting role="php">
- <![CDATA[
-<?php
-echo sprintf("%'.9d\n", 123);
-echo sprintf("%'.09d\n", 123);
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
- <![CDATA[
-......123
-000000123
-]]>
- </screen>
- </example>
- <example>
- <title>Positionstausch mit weiteren Spezifikatoren</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-$format= 'Der %2$s enthält %1$04d Affen';
-echo sprintf($format, $anzahl, $ort);
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-Der Baum enthält 0005 Affen.
-]]>
- </screen>
- </example>
- </para>
- <note>
- <para>
- Der Versuch der Verwendung einer Positionsangabe, die größer als
- <constant>PHP_INT_MAX</constant> ist, hat zur Folge, dass
- <function>sprintf</function> Warnungen erzeugt.
- </para>
- </note>
- <warning>
- <para>
- Die <literal>c</literal>-Typangabe ignoriert Füllzeichen und Längenangabe
- </para>
- </warning>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>...</parameter></term>
- <listitem>
- <para>
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect1>
-
- <refsect1 role="returnvalues">
- &reftitle.returnvalues;
- <para>
- Gibt eine an Hand des Formatierungs-Strings <parameter>format</parameter>
- gebildete Zeichenkette zurück. &return.falseforfailure;
- </para>
- </refsect1>
-
- <refsect1 role="examples">
- &reftitle.examples;
+ </programlisting>
+ <para>
+ Wenn Argumenttausch verwendet wird muss die <literal>n$</literal>
+ <emphasis>Positionsangabe</emphasis>
+ direkt nach dem Prozentzeichen (<literal>%</literal>) folgen, vor
+ jeglichen anderen Angaben, wie unten zu sehen ist.
+ </para>
+ </example>
<example>
- <title><function>printf</function>: Verschiedene Beispiele</title>
+ <title>Angabe von Füllzeichen</title>
<programlisting role="php">
<![CDATA[
<?php
-$n = 43951789;
-$u = -43951789;
-$c = 65; // ASCII 65 is 'A'
-
-// Beachten Sie das doppelte %%, dies gibt ein '%'-Zeichen aus
-printf("%%b = '%b'\n", $n); // Binärdarstellung
-printf("%%c = '%c'\n", $c); // print the ascii character, same as chr() function
-printf("%%d = '%d'\n", $n); // Standard-Integerdarstellung
-printf("%%e = '%e'\n", $n); // Wissenschaftliche Notation
-printf("%%u = '%u'\n", $n); // vorzeichenlose Integerdarstellung einer positiven Zahl
-printf("%%u = '%u'\n", $u); // vorzeichenlose Integerdarstellung einer negativen Zahl
-printf("%%f = '%f'\n", $n); // Fließkommazahldarstellung
-printf("%%o = '%o'\n", $n); // Oktaldarstellung
-printf("%%s = '%s'\n", $n); // Stringdarstellung
-printf("%%x = '%x'\n", $n); // Hexadezimaldarstellung (Kleinbuchstaben)
-printf("%%X = '%X'\n", $n); // Hexadezimaldarstellung (Großbuchstaben)
-
-printf("%%+d = '%+d'\n", $n); // Vorzeichenangabe für positive Integerzahlen
-printf("%%+d = '%+d'\n", $u); // Vorzeichenangabe für negative Integerzahlen
+echo sprintf("%'.9d\n", 123);
+echo sprintf("%'.09d\n", 123);
?>
]]>
</programlisting>
@@ -388,37 +132,18 @@
&example.outputs;
<screen>
<![CDATA[
-%b = '10100111101010011010101101'
-%c = 'A'
-%d = '43951789'
-%e = '4.39518e+7'
-%u = '43951789'
-%u = '4251015507'
-%f = '43951789.000000'
-%o = '247523255'
-%s = '43951789'
-%x = '29ea6ad'
-%X = '29EA6AD'
-%+d = '+43951789'
-%+d = '-43951789'
+......123
+000000123
]]>
</screen>
</example>
<example>
- <title><function>printf</function>: Stringformatierung</title>
+ <title>Positionstausch mit weiteren Spezifikatoren</title>
<programlisting role="php">
<![CDATA[
<?php
-$s = 'monkey';
-$t = 'many monkeys';
-
-printf("[%s]\n", $s); // normale rechtsbündige Ausgabe
-printf("[%10s]\n", $s); // rechtsbündige Ausgabe, mit Leerzeichen aufgefüllt
-printf("[%-10s]\n", $s); // linksbündige Ausgabe, mit Leerzeichen aufgefüllt
-printf("[%010s]\n", $s); // auffüllen mit Nullen funktioniert auch bei Strings
-printf("[%'#10s]\n", $s); // Verwendung des benutzerdefinierten Auffüllzeichens '#'
-printf("[%10.10s]\n", $t); // linksbündige Ausgabe mit abschneiden überflüssiger
- // Buchstaben nach der zehnten Stelle
+$format= 'Der %2$s enthält %1$04d Affen';
+echo sprintf($format, $anzahl, $ort);
?>
]]>
</programlisting>
@@ -425,12 +150,7 @@
&example.outputs;
<screen>
<![CDATA[
-[monkey]
-[ monkey]
-[monkey ]
-[0000monkey]
-[####monkey]
-[many monke]
+Der Baum enthält 0005 Affen.
]]>
</screen>
</example>
@@ -452,12 +172,20 @@
$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
-// echo $money gibt "123.1" aus
+echo $money;
+echo "\n";
$formatted = sprintf("%01.2f", $money);
-// echo $formatted gibt "123.10" aus
+echo $formatted;
?>
]]>
</programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+123.1
+123.10
+]]>
+ </screen>
</example>
<example>
<title><function>sprintf</function>: Wissenschaftliche Notation</title>
@@ -466,10 +194,16 @@
<?php
$number = 362525200;
-echo sprintf("%.3e", $number); // Ausgabe 3.625e+8
+echo sprintf("%.3e", $number);
?>
]]>
</programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+3.625e+8
+]]>
+ </screen>
</example>
</refsect1>
@@ -478,9 +212,12 @@
<para>
<simplelist>
<member><function>printf</function></member>
+ <member><function>fprintf</function></member>
+ <member><function>vprintf</function></member>
+ <member><function>vsprintf</function></member>
+ <member><function>vfprintf</function></member>
<member><function>sscanf</function></member>
<member><function>fscanf</function></member>
- <member><function>vsprintf</function></member>
<member><function>number_format</function></member>
<member><function>date</function></member>
</simplelist>
Modified: phpdoc/de/trunk/reference/strings/functions/sscanf.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/sscanf.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/strings/functions/sscanf.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 342425 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 347041 Maintainer: sammywg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sscanf" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Modified: phpdoc/de/trunk/reference/strings/functions/strip-tags.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/strip-tags.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/strings/functions/strip-tags.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 347577 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 348314 Maintainer: sammywg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strip-tags">
<refnamediv>
Modified: phpdoc/de/trunk/reference/strings/functions/vfprintf.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/vfprintf.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/strings/functions/vfprintf.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 347041 Maintainer: sammywg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vfprintf">
<refnamediv>
<refname>vfprintf</refname>
@@ -36,16 +36,8 @@
</para>
</listitem>
</varlistentry>
+ &strings.parameter.format;
<varlistentry>
- <term><parameter>format</parameter></term>
- <listitem>
- <para>
- Die möglichen <parameter>Format</parameter>-Anweisungen sind in der
- Funktion <function>sprintf</function> dokumentiert.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
<term><parameter>args</parameter></term>
<listitem>
<para>
@@ -89,10 +81,13 @@
<simplelist>
<member><function>printf</function></member>
<member><function>sprintf</function></member>
+ <member><function>fprintf</function></member>
+ <member><function>vprintf</function></member>
+ <member><function>vsprintf</function></member>
<member><function>sscanf</function></member>
<member><function>fscanf</function></member>
- <member><function>vsprintf</function></member>
<member><function>number_format</function></member>
+ <member><function>date</function></member>
</simplelist>
</para>
</refsect1>
Modified: phpdoc/de/trunk/reference/strings/functions/vprintf.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/vprintf.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/strings/functions/vprintf.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 347041 Maintainer: sammywg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vprintf">
<refnamediv>
@@ -30,16 +30,8 @@
&reftitle.parameters;
<para>
<variablelist>
+ &strings.parameter.format;
<varlistentry>
- <term><parameter>format</parameter></term>
- <listitem>
- <para>
- Die Dokumentation der <function>sprintf</function> enthält die
- vollständige Beschreibung des <parameter>format</parameter>-Parameters.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
<term><parameter>args</parameter></term>
<listitem>
<para>
@@ -65,10 +57,16 @@
<programlisting role="php">
<![CDATA[
<?php
-vprintf("%04d-%02d-%02d", explode('-', '1988-8-1')); // 1988-08-01
+vprintf("%04d-%02d-%02d", explode('-', '1988-8-1'));
?>
]]>
</programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+1988-08-01
+]]>
+ </screen>
</example>
</para>
</refsect1>
@@ -79,7 +77,13 @@
<simplelist>
<member><function>printf</function></member>
<member><function>sprintf</function></member>
+ <member><function>fprintf</function></member>
<member><function>vsprintf</function></member>
+ <member><function>vfprintf</function></member>
+ <member><function>sscanf</function></member>
+ <member><function>fscanf</function></member>
+ <member><function>number_format</function></member>
+ <member><function>date</function></member>
</simplelist>
</para>
</refsect1>
Modified: phpdoc/de/trunk/reference/strings/functions/vsprintf.xml
===================================================================
--- phpdoc/de/trunk/reference/strings/functions/vsprintf.xml 2019-11-24 07:57:51 UTC (rev 348343)
+++ phpdoc/de/trunk/reference/strings/functions/vsprintf.xml 2019-11-24 11:03:29 UTC (rev 348344)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 347041 Maintainer: sammywg Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vsprintf">
<refnamediv>
@@ -25,16 +25,8 @@
&reftitle.parameters;
<para>
<variablelist>
+ &strings.parameter.format;
<varlistentry>
- <term><parameter>format</parameter></term>
- <listitem>
- <para>
- Die Dokumentation der <function>sprintf</function> enthält die
- vollständige Beschreibung des <parameter>format</parameter>-Parameters.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
<term><parameter>args</parameter></term>
<listitem>
<para>
@@ -49,9 +41,8 @@
&reftitle.returnvalues;
<para>
Gibt Array-Werte als formatierten String entsprechend der
- <parameter>Format</parameter>anweisung (siehe Beschreibung der
- Formatierungsmöglichkeiten der Funktion <function>sprintf</function>)
- zurück.
+ <parameter>Format</parameter>-Anweisung.
+ &return.falseforfailure;
</para>
</refsect1>
@@ -63,10 +54,16 @@
<programlisting role="php">
<![CDATA[
<?php
-print vsprintf("%04d-%02d-%02d", explode('-', '1988-8-1')); // 1988-08-01
+print vsprintf("%04d-%02d-%02d", explode('-', '1988-8-1'));
?>
]]>
</programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+1988-08-01
+]]>
+ </screen>
</example>
</para>
</refsect1>
@@ -75,8 +72,15 @@
&reftitle.seealso;
<para>
<simplelist>
+ <member><function>printf</function></member>
<member><function>sprintf</function></member>
+ <member><function>fprintf</function></member>
<member><function>vprintf</function></member>
+ <member><function>vfprintf</function></member>
+ <member><function>sscanf</function></member>
+ <member><function>fscanf</function></member>
+ <member><function>number_format</function></member>
+ <member><function>date</function></member>
</simplelist>
</para>
</refsect1>