Skip to content

Commit dde81ed

Browse files
msameschmsamesch
committed
Sync with EN
1 parent f6c5785 commit dde81ed

38 files changed

+335
-276
lines changed

‎reference/strings/book.xml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: 523a0692f739594aaea8aa3f226f0f4e78b5ae67 Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
3+
<!-- Reviewed: no -->
44

5-
<book xml:id="book.strings" xmlns="http://docbook.org/ns/docbook">
5+
<book xml:id="book.strings" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
66
<?phpdoc extension-membership="core" ?>
77
<title>Zeichenketten</title>
88

‎reference/strings/functions/addcslashes.xml‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: 2bcb7a986d47e06c1a37474a8b3634367c907043 Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
3+
<!-- Reviewed: no -->
44
<refentry xml:id="function.addcslashes" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>addcslashes</refname>
@@ -49,7 +49,8 @@
4949
Zeichen definiert wird, sollte bekannt sein, welche Zeichen zwischen
5050
den Zeichen liegen, die als Anfang und Ende des Bereichs festgelegt
5151
wurden.
52-
<informalexample>
52+
<example>
53+
<title><function>addcslashes</function> mit Bereichen</title>
5354
<programlisting role="php">
5455
<![CDATA[
5556
<?php
@@ -60,13 +61,14 @@ echo addcslashes('foo[ ]', 'A..z');
6061
?>
6162
]]>
6263
</programlisting>
63-
</informalexample>
64+
</example>
6465
Es ist außerdem zu beachten, dass keine Sequenz erstellt wird, wenn das
6566
erste Zeichen einer Sequenz einen höheren ASCII-Wert hat, als das
6667
zweite. In diesem Fall werden nur das erste und das letzte Zeichen
6768
sowie Punkte maskiert. Um den ASCII-Wert eines Zeichens zu ermitteln,
6869
kann die Funktion <function>ord</function> verwendet werden.
69-
<informalexample>
70+
<example>
71+
<title><function>addcslashes</function> mit Zeichen in falscher Reihenfolge</title>
7072
<programlisting role="php">
7173
<![CDATA[
7274
<?php
@@ -75,7 +77,7 @@ echo addcslashes("zoo['.']", 'z..A');
7577
?>
7678
]]>
7779
</programlisting>
78-
</informalexample>
80+
</example>
7981
</para>
8082
<para>
8183
Besondere Vorsicht ist geboten, wenn die Zeichen 0, a, b, f, n, r, t
@@ -112,7 +114,9 @@ echo addcslashes("zoo['.']", 'z..A');
112114
<programlisting role="php">
113115
<![CDATA[
114116
<?php
117+
$nicht_maskiert = "PHP isThirty\nYears Old!\tYay to the Elephant!\n";
115118
$maskiert = addcslashes($nicht_maskiert, "\0..\37!@\177..\377");
119+
echo $maskiert;
116120
?>
117121
]]>
118122
</programlisting>

‎reference/strings/functions/addslashes.xml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: 8cdc6621f9826d04abc3e50438c010804d7e8683 Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
43
<!-- Reviewed: yes -->
54
<!-- Rev-Revision: 8cdc6621f9826d04abc3e50438c010804d7e8683 Reviewer: samesch -->
65
<refentry xml:id="function.addslashes" xmlns="http://docbook.org/ns/docbook">
@@ -29,7 +28,8 @@
2928
Ein Anwendungsfall für die Verwendung von <function>addslashes</function>
3029
ist das Maskieren der zuvor erwähnten Zeichen in einer Zeichenkette, die von
3130
PHP ausgewertet werden soll.
32-
<informalexample>
31+
<example>
32+
<title>Maskieren von Zeichen</title>
3333
<programlisting role="php">
3434
<![CDATA[
3535
<?php
@@ -38,7 +38,7 @@ eval("echo '" . addslashes($str) . "';");
3838
?>
3939
]]>
4040
</programlisting>
41-
</informalexample>
41+
</example>
4242
</para>
4343
<para>
4444
Die Funktion <function>addslashes</function> wird manchmal

‎reference/strings/functions/chr.xml‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: 4d3d1ebea1eeecb7f76fb2fa8ecb55ef35d1d518 Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
3+
<!-- Reviewed: no -->
44
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.chr">
55
<refnamediv>
66
<refname>chr</refname>
@@ -104,14 +104,17 @@ $bytevalue %= 256;
104104
105105
$str = "Diese Zeichenkette endet mit einem Escape-Zeichen: ";
106106
$str .= chr(27); /* fügt das Escape-Zeichen an das Ende von $str an */
107+
echo $str, PHP_EOL;
107108
108109
/* Die häufig praktischere Lösung: */
109-
110110
$str = sprintf("Diese Zeichenkette endet mit einem Escape-Zeichen: %c", 27);
111+
echo $str, PHP_EOL;
111112
?>
112113
]]>
113114
</programlisting>
114115
</example>
116+
</para>
117+
<para>
115118
<example>
116119
<title>Überlauf-Verhalten</title>
117120
<programlisting role="php">
@@ -136,7 +139,7 @@ aA
136139
<![CDATA[
137140
<?php
138141
$str = chr(240) . chr(159) . chr(144) . chr(152);
139-
echo $str;
142+
echo $str, PHP_EOL;
140143
?>
141144
]]>
142145
</programlisting>

‎reference/strings/functions/chunk-split.xml‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: d335ba69a16f4013280de8e3e71d9ba19fe3cb3c Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
43
<!-- Reviewed: yes -->
54
<!-- Rev-Revision: d335ba69a16f4013280de8e3e71d9ba19fe3cb3c Reviewer: samesch -->
65
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.chunk-split">
@@ -74,8 +73,11 @@
7473
<programlisting role="php">
7574
<![CDATA[
7675
<?php
76+
$data = 'Dies ist eine ziemlich lange Zeichenkette, die aufgeteilt wird, da die Zeile nach der Base64-Kodierung zu lang wäre.';
77+
7778
// formatiert $data unter Beachtung von RFC 2045
7879
$neuer_string = chunk_split(base64_encode($data));
80+
echo $neuer_string, PHP_EOL;
7981
?>
8082
]]>
8183
</programlisting>

‎reference/strings/functions/echo.xml‎

Lines changed: 36 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: 2a5223230bf6177c225003ca30c63f48ef266cc0 Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
3+
<!-- Reviewed: no -->
44
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.echo">
55
<refnamediv>
66
<refname>echo</refname>
@@ -112,9 +112,6 @@ echo implode(" und ", $fruechte); // Zitrone und Orange und Banane
112112
// declare(strict_types=1) verwendet wird
113113
echo 6 * 7; // 42
114114
115-
// Da echo sich nicht wie ein Ausdruck verhält, ist der folgende Code ungültig.
116-
($eine_variable) ? echo 'true' : echo 'false';
117-
118115
// Folgende Beispiele funktionieren hingegen:
119116
($eine_variable) ? print 'true' : print 'false'; // print ist auch ein Konstrukt,
120117
// aber es ist ein gültiger Ausdruck, der 1 zurückgibt,
@@ -123,6 +120,19 @@ echo 6 * 7; // 42
123120
echo $eine_variable ? 'true': 'false'; // den Ausdruck zuerst auswerten und
124121
// dann an echo übergeben
125122
?>
123+
]]>
124+
</programlisting>
125+
</example>
126+
</para>
127+
<para>
128+
<example>
129+
<title><literal>echo</literal> ist kein Ausdruck</title>
130+
<programlisting role="php" annotations="non-interactive">
131+
<![CDATA[
132+
<?php
133+
// Da echo sich nicht wie ein Ausdruck verhält, ist der folgende Code ungültig.
134+
($eine_variable) ? echo 'true' : echo 'false';
135+
?>
126136
]]>
127137
</programlisting>
128138
</example>
@@ -132,6 +142,7 @@ echo $eine_variable ? 'true': 'false'; // den Ausdruck zuerst auswerten und
132142
<refsect1 role="notes">
133143
&reftitle.notes;
134144
&note.language-construct;
145+
135146
<note>
136147
<title>Die Verwendung mit Klammern</title>
137148
<para>
@@ -142,32 +153,44 @@ echo $eine_variable ? 'true': 'false'; // den Ausdruck zuerst auswerten und
142153
auszugebenden Ausdrucks und nicht Teil der <literal>echo</literal>-Syntax
143154
selbst.
144155

145-
<informalexample>
156+
<example>
157+
<title>Verwenden von Klammern</title>
146158
<programlisting role="php">
147159
<![CDATA[
148160
<?php
149-
echo "Hallo";
161+
echo "Hallo", PHP_EOL;
150162
// gibt "Hallo" aus
151163
152-
echo("Hallo");
164+
echo("Hallo"), PHP_EOL;
153165
// gibt auch "Hallo" aus, weil ("Hallo") ein gültiger Ausdruck ist
154166
155-
echo(1 + 2) * 3;
167+
echo(1 + 2) * 3, PHP_EOL;
156168
// gibt "9" aus; die Klammern bewirken, dass zuerst 1+2 ausgewertet wird, dann 3*3
157169
// Die echo-Anweisung sieht den gesamten Ausdruck als ein Argument
158170
159-
echo "Hallo", " Welt";
171+
echo "Hallo", " Welt", PHP_EOL;
160172
// gibt "Hallo Welt" aus
161173
162-
echo("Hallo"), (" Welt");
174+
echo("Hallo"), (" Welt"), PHP_EOL;
163175
// gibt "Hallo Welt" aus; die Klammern sind Teil des jeweiligen Ausdrucks
176+
?>
177+
]]>
178+
</programlisting>
179+
</example>
180+
</para>
164181

165-
echo("Hallo", " Welt");
182+
<para>
183+
<example>
184+
<title>Ungültiger Ausdruck</title>
185+
<programlisting role="php" annotations="non-interactive">
186+
<![CDATA[
187+
<?php
188+
echo("Hallo", " Welt"), PHP_EOL;
166189
// löst eine Syntaxfehler aus, weil ("Hallo", " Welt") kein gültiger Ausdruck ist
167190
?>
168191
]]>
169192
</programlisting>
170-
</informalexample>
193+
</example>
171194
</para>
172195
</note>
173196
<tip>

‎reference/strings/functions/explode.xml‎

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: abd75f51f4daa22d471b0d14114df3886832fb6f Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
43
<!-- Reviewed: yes -->
54
<!-- Rev-Revision: abd75f51f4daa22d471b0d14114df3886832fb6f Reviewer: samesch -->
65
<refentry xml:id="function.explode" xmlns="http://docbook.org/ns/docbook">
@@ -137,15 +136,14 @@
137136
// Beispiel 1
138137
$pizza = "Teil1 Teil2 Teil3 Teil4 Teil5 Teil6";
139138
$teile = explode(" ", $pizza);
140-
echo $teile[0]; // Teil1
141-
echo $teile[1]; // Teil2
139+
echo $teile[0], PHP_EOL; // Teil1
140+
echo $teile[1], PHP_EOL; // Teil2
142141
143142
// Beispiel 2
144143
$data = "foo:*:1023:1000::/home/foo:/bin/sh";
145144
list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);
146-
echo $user; // foo
147-
echo $pass; // *
148-
145+
echo $user, PHP_EOL; // foo
146+
echo $pass, PHP_EOL; // *
149147
?>
150148
]]>
151149
</programlisting>

‎reference/strings/functions/fprintf.xml‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: f134250210702ab6280ab303b846679177d39f14 Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
3+
<!-- Reviewed: no -->
44
<refentry xml:id="function.fprintf" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>fprintf</refname>
@@ -71,7 +71,11 @@ if (!($fp = fopen('date.txt', 'w'))) {
7171
return;
7272
}
7373
74-
fprintf($fp, "%04d-%02d-%02d", $year, $month, $day);
74+
$jahr = 2005;
75+
$monat = 5;
76+
$tag = 6;
77+
78+
fprintf($fp, "%04d-%02d-%02d", $jahr, $monat, $tag);
7579
// schreibt ein ISO-formatiertes Datum in die Datei date.txt
7680
?>
7781
]]>

‎reference/strings/functions/html-entity-decode.xml‎

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: eabde0419cf90f596f60db00e31fcb6ebe41ac55 Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
43
<!-- Reviewed: yes -->
54
<!-- Rev-Revision: e4b52745bc8ef288726f8e76e7fdc6277a2f656f Reviewer: samesch -->
65
<refentry xml:id="function.html-entity-decode" xmlns="http://docbook.org/ns/docbook">
@@ -25,7 +24,7 @@
2524
<para>
2625
Genau gesagt dekodiert diese Funktion alle Entities (einschließlich aller
2726
numerischen Entities), die a) auf jeden Fall gültig für den gewählten
28-
Dokumenttyp sind — d. h. für XML dekodiert diese Funktion keine benannten
27+
Dokumenttyp sind — &dh; für XML dekodiert diese Funktion keine benannten
2928
Entities, die in einer DTD definiert sein könnten — und b) deren Zeichen in
3029
der Zeichenkodierung und im gewählten Dokumenttyp erlaubt sind. Alle
3130
anderen Entities bleiben wie sie sind.
@@ -183,9 +182,9 @@ $a = htmlentities($orig);
183182
184183
$b = html_entity_decode($a);
185184
186-
echo $a; // I'll &quot;walk&quot; the &lt;b&gt;dog&lt;/b&gt; now
185+
echo $a, PHP_EOL; // I'll &quot;walk&quot; the &lt;b&gt;dog&lt;/b&gt; now
187186
188-
echo $b; // I'll "walk" the <b>dog</b> now
187+
echo $b, PHP_EOL; // I'll "walk" the <b>dog</b> now
189188
?>
190189
]]>
191190
</programlisting>

‎reference/strings/functions/lcfirst.xml‎

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: 54ff7bf8e0f8fa90988cccf6b583517366605f6d Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
43
<!-- Reviewed: yes -->
54
<!-- Rev-Revision: 54ff7bf8e0f8fa90988cccf6b583517366605f6d Reviewer: samesch -->
65
<refentry xml:id="function.lcfirst" xmlns="http://docbook.org/ns/docbook">
@@ -72,11 +71,11 @@
7271
<![CDATA[
7372
<?php
7473
$foo = 'HalloWelt';
75-
$foo = lcfirst($foo); // halloWelt
74+
echo lcfirst($foo), PHP_EOL; // halloWelt
7675
7776
$bar = 'HALLO WELT!';
78-
$bar = lcfirst($bar); // hALLO WELT!
79-
$bar = lcfirst(strtoupper($bar)); // hALLO WELT!
77+
echo lcfirst($bar), PHP_EOL; // hALLO WELT!
78+
echo lcfirst(strtoupper($bar)), PHP_EOL; // hALLO WELT!
8079
?>
8180
]]>
8281
</programlisting>

0 commit comments

Comments
 (0)