Skip to content

Commit de913f5

Browse files
edorianedorian
authored
Sync reference/strings/functions with EN (#212)
1 parent 7008df0 commit de913f5

9 files changed

Lines changed: 171 additions & 38 deletions

File tree

‎reference/strings/functions/levenshtein.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: a484d5d2bbad7e385a8864370b5280c4e05add8c Maintainer: sammywg Status: ready -->
3+
<!-- EN-Revision: 873f4a3d5027bd1b584f1d1e590e22cd4a08ae84 Maintainer: sammywg Status: ready -->
44
<refentry xml:id="function.levenshtein" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>levenshtein</refname>

‎reference/strings/functions/metaphone.xml‎

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: e095023e408c8cb6378ae16bb6870343a3946919 Maintainer: sammywg Status: ready -->
3+
<!-- EN-Revision: 873f4a3d5027bd1b584f1d1e590e22cd4a08ae84 Maintainer: sammywg Status: ready -->
44
<refentry xml:id="function.metaphone" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>metaphone</refname>
@@ -159,6 +159,17 @@ string(6) "ASTRKS"
159159
</para>
160160
</refsect1><!-- }}} -->
161161

162+
<refsect1 role="seealso">
163+
&reftitle.seealso;
164+
<para>
165+
<simplelist>
166+
<member><function>levenshtein</function></member>
167+
<member><function>similar_text</function></member>
168+
<member><function>soundex</function></member>
169+
</simplelist>
170+
</para>
171+
</refsect1>
172+
162173
</refentry>
163174
<!-- Keep this comment at the end of the file
164175
Local variables:

‎reference/strings/functions/setlocale.xml‎

Lines changed: 45 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: ec01a42be50e84f192c0b19fc6e9cf40a0f7ac31 Maintainer: sammywg Status: ready -->
33
<!-- Reviewed: yes -->
44
<!-- Rev-Revision: 8cdc6621f9826d04abc3e50438c010804d7e8683 Reviewer: samesch -->
55
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.setlocale">
@@ -13,7 +13,7 @@
1313
<methodsynopsis>
1414
<type class="union"><type>string</type><type>false</type></type><methodname>setlocale</methodname>
1515
<methodparam><type>int</type><parameter>category</parameter></methodparam>
16-
<methodparam><type>string</type><parameter>locales</parameter></methodparam>
16+
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>locales</parameter></methodparam>
1717
<methodparam rep="repeat"><type>string</type><parameter>rest</parameter></methodparam>
1818
</methodsynopsis>
1919
<simpara>
@@ -103,9 +103,9 @@
103103
<listitem>
104104
<para>
105105
Ist <parameter>locales</parameter> der leere String
106-
<literal>""</literal>, werden die Namen der Locales von den Werten der
107-
Umgebungsvariablen gleichen Namens wie die obigen Kategorien oder von
108-
"LANG" bestimmt.
106+
<literal>""</literal> oder &null;, dann werden die Namen der Locales von
107+
den Werten der Umgebungsvariablen gleichen Namens wie die obigen
108+
Kategorien oder von "LANG" bestimmt.
109109
</para>
110110
<para>
111111
Ist <parameter>locales</parameter> <literal>"0"</literal>, sind keine
@@ -135,7 +135,7 @@
135135
<listitem>
136136
<para>
137137
Für jedes Array-Element wird versucht, es als neue Locale zu setzen,
138-
bis zum Erfolg. Dies ist nützlich, wenn eine Locale unter
138+
bis zum Erfolg. Dies ist nützlich, wenn eine Locale unter
139139
verschiedenen Namen auf verschiedenen Systemen bekannt ist oder als
140140
Fallback für eine möglicherweise nicht verfügbare Locale.
141141
</para>
@@ -175,6 +175,30 @@
175175
</note>
176176
</refsect1>
177177

178+
<refsect1 role="changelog">
179+
&reftitle.changelog;
180+
<informaltable>
181+
<tgroup cols="2">
182+
<thead>
183+
<row>
184+
<entry>&Version;</entry>
185+
<entry>&Description;</entry>
186+
</row>
187+
</thead>
188+
<tbody>
189+
<row>
190+
<entry>8.5.0</entry>
191+
<entry>
192+
Die Übergabe des Integerwertes <literal>0</literal> als
193+
<parameter>locales</parameter>-Argument wird nicht mehr unterstützt und
194+
löst nun eine <exceptionname>TypeError</exceptionname>-Ausnahme aus.
195+
</entry>
196+
</row>
197+
</tbody>
198+
</tgroup>
199+
</informaltable>
200+
</refsect1>
201+
178202
<refsect1 role="examples">
179203
&reftitle.examples;
180204
<para>
@@ -193,6 +217,21 @@ echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978));
193217
$loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge');
194218
echo "Preferred locale for german on this system is '$loc_de'";
195219
?>
220+
]]>
221+
</programlisting>
222+
</example>
223+
</para>
224+
<para>
225+
<example>
226+
<title><function>setlocale</function>: aktuellen Wert auslesen</title>
227+
<programlisting role="php" annotations="non-interactive">
228+
<![CDATA[
229+
<?php
230+
/* Aktuellen Wert auslesen */
231+
$current = setlocale(LC_ALL, null);
232+
233+
echo "Aktuelle Locale '$current'";
234+
?>
196235
]]>
197236
</programlisting>
198237
</example>

‎reference/strings/functions/strcmp.xml‎

Lines changed: 37 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 9b68bf2b63200534e022bc65e800cae6c75abf26 Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 873f4a3d5027bd1b584f1d1e590e22cd4a08ae84 Maintainer: sammywg Status: ready -->
33
<!-- Reviewed: yes -->
44
<!-- Rev-Revision: c44475e1fafcbee203ed4935a6d5d7a01379fcdc Reviewer: samesch -->
55
<refentry xml:id="function.strcmp" xmlns="http://docbook.org/ns/docbook">
@@ -16,8 +16,14 @@
1616
<methodparam><type>string</type><parameter>string2</parameter></methodparam>
1717
</methodsynopsis>
1818
<simpara>
19-
Es ist zu beachten, dass zwischen Groß- und Kleinschreibung unterschieden
20-
wird.
19+
Es ist zu beachten, dass dieser Vergleich Groß-/Kleinschreibung berücksichtigt.
20+
Für einen Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung siehe
21+
<function>strcasecmp</function>.
22+
</simpara>
23+
<simpara>
24+
Des weiteren ist zu beachten, dass der Vergleich die locale Einstellung ignoriert.
25+
Für einen Vergleich, der die locale Einstellung respektiert, siehe
26+
<function>strcoll</function> oder <methodname>Collator::compare</methodname>
2127
</simpara>
2228
</refsect1>
2329

@@ -90,14 +96,34 @@ if (strcmp($var1, $var2) !== 0) {
9096
<refsect1 role="seealso">
9197
&reftitle.seealso;
9298
<para>
93-
<simplelist>
94-
<member><function>strcasecmp</function></member>
95-
<member><function>preg_match</function></member>
96-
<member><function>substr_compare</function></member>
97-
<member><function>strncmp</function></member>
98-
<member><function>strstr</function></member>
99-
<member><function>substr</function></member>
100-
</simplelist>
99+
<itemizedlist>
100+
<listitem>
101+
<simpara>Vollständiger String-Vergleich</simpara>
102+
<simplelist>
103+
<member><function>strcasecmp</function></member>
104+
<member><methodname>Collator::compare</methodname></member>
105+
<member><function>strcoll</function></member>
106+
</simplelist>
107+
</listitem>
108+
<listitem>
109+
<simpara>Teilweiser String-Vergleich</simpara>
110+
<simplelist>
111+
<member><function>substr_compare</function></member>
112+
<member><function>strncmp</function></member>
113+
<member><function>strstr</function></member>
114+
</simplelist>
115+
</listitem>
116+
<listitem>
117+
<simpara>Vergleich ähnlicher / verschiedener Strings</simpara>
118+
<simplelist>
119+
<member><function>preg_match</function></member>
120+
<member><function>levenshtein</function></member>
121+
<member><function>metaphone</function></member>
122+
<member><function>similar_text</function></member>
123+
<member><function>soundex</function></member>
124+
</simplelist>
125+
</listitem>
126+
</itemizedlist>
101127
</para>
102128
</refsect1>
103129

‎reference/strings/functions/stripos.xml‎

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 4b72b23513caa3a8bc520d459a0417defc7b3880 Maintainer: sammywg Status: ready -->
33
<!-- Reviewed: no -->
44
<refentry xml:id="function.stripos" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
@@ -78,6 +78,19 @@
7878
&return.falseproblem;
7979
</refsect1>
8080

81+
<refsect1 role="errors">
82+
&reftitle.errors;
83+
<itemizedlist>
84+
<listitem>
85+
<simpara>
86+
Wenn <parameter>offset</parameter> größer ist als die Länge von
87+
<parameter>haystack</parameter>, wird eine
88+
<classname>ValueError</classname>-Ausnahme geworfen.
89+
</simpara>
90+
</listitem>
91+
</itemizedlist>
92+
</refsect1>
93+
8194
<refsect1 role="changelog">
8295
&reftitle.changelog;
8396
<informaltable>
@@ -137,8 +150,8 @@ if ($pos1 === false) {
137150
echo "Die Zeichenkette '$findmich' kommt nicht im String '$meinstring1' vor.", PHP_EOL;
138151
}
139152
140-
// Beachten Sie die Verwendung von ===. Ein einfaches == funktioniert nicht wie
141-
// erwartet, da 'a' an Position 0 (also erster!) Stelle steht
153+
// Beachten Sie die Verwendung von !==. Ein einfaches != funktioniert nicht wie
154+
// erwartet, da 'a' an Position 0 (also erster!) Stelle steht.
142155
if ($pos2 !== false) {
143156
echo "Die Zeichenkette '$findmich' wurde in '$meinstring2' an Position $pos2 gefunden", PHP_EOL;
144157
}

‎reference/strings/functions/strpos.xml‎

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: sammywg Status: ready -->
2+
<!-- EN-Revision: 4b72b23513caa3a8bc520d459a0417defc7b3880 Maintainer: sammywg Status: ready -->
33
<!-- Reviewed: no -->
44
<refentry xml:id="function.strpos" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
@@ -73,6 +73,19 @@
7373
</para>
7474
&return.falseproblem;
7575
</refsect1>
76+
77+
<refsect1 role="errors">
78+
&reftitle.errors;
79+
<itemizedlist>
80+
<listitem>
81+
<simpara>
82+
Wenn <parameter>offset</parameter> größer ist als die Länge von
83+
<parameter>haystack</parameter>, wird eine
84+
<classname>ValueError</classname>-Ausnahme geworfen.
85+
</simpara>
86+
</listitem>
87+
</itemizedlist>
88+
</refsect1>
7689

7790
<refsect1 role="changelog">
7891
&reftitle.changelog;
@@ -120,6 +133,7 @@
120133
<programlisting role="php">
121134
<![CDATA[
122135
<?php
136+
123137
$meinString = 'abc';
124138
$findMich = 'a';
125139
$pos = strpos($meinString, $findMich);
@@ -133,6 +147,7 @@ if ($pos === false) {
133147
echo "Der String '$findMich' wurde im String '$meinString' gefunden";
134148
echo " und befindet sich an Position $pos";
135149
}
150+
136151
?>
137152
]]>
138153
</programlisting>
@@ -143,6 +158,7 @@ if ($pos === false) {
143158
<programlisting role="php">
144159
<![CDATA[
145160
<?php
161+
146162
$meinString = 'abc';
147163
$findMich = 'a';
148164
$pos = strpos($meinString, $findMich);
@@ -156,6 +172,7 @@ if ($pos !== false) {
156172
} else {
157173
echo "Der String '$findMich' wurde nicht im String '$meinString' gefunden";
158174
}
175+
159176
?>
160177
]]>
161178
</programlisting>
@@ -166,7 +183,7 @@ if ($pos !== false) {
166183
<programlisting role="php">
167184
<![CDATA[
168185
<?php
169-
// Wir koennen nach einem Zeichen suchen und dabei alles vor dem Offset ignorieren
186+
// Wir können nach einem Zeichen suchen und dabei alles vor dem Offset ignorieren
170187
$newstring = 'abcdef abcdef';
171188
$pos = strpos($newstring, 'a', 1); // $pos = 7, nicht 0
172189

‎reference/strings/functions/strripos.xml‎

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 71b1e926631d5f5bec9b2e2685553453349ae799 Maintainer: sammywg Status: ready -->
3+
<!-- EN-Revision: 95d05546430b9e5db225dd42a0d285b870f0da42 Maintainer: sammywg Status: ready -->
44
<refentry xml:id="function.strripos" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>strripos</refname>
@@ -81,7 +81,7 @@
8181
<para>
8282
Gibt die Position zurück, an der <parameter>needle</parameter> relativ zum
8383
Anfang der Zeichenkette <parameter>haystack</parameter> vorkommt
84-
(unabhängig von Suchrichtung oder Offset).
84+
(unabhängig von Suchrichtung oder dem Wert von <parameter>offset</parameter>).
8585
<note>
8686
<simpara>
8787
Positionen in Zeichenketten werden ab 0 gezählt, und nicht ab 1.
@@ -95,6 +95,20 @@
9595
&return.falseproblem;
9696
</refsect1>
9797

98+
<refsect1 role="errors">
99+
&reftitle.errors;
100+
<itemizedlist>
101+
<listitem>
102+
<simpara>
103+
Wenn <parameter>offset</parameter> größer ist als die Länge von
104+
<parameter>haystack</parameter>, wird eine
105+
<classname>ValueError</classname>-Ausnahme geworfen.
106+
</simpara>
107+
</listitem>
108+
</itemizedlist>
109+
</refsect1>
110+
111+
98112
<refsect1 role="changelog">
99113
&reftitle.changelog;
100114
<informaltable>
@@ -135,25 +149,27 @@
135149
<programlisting role="php">
136150
<![CDATA[
137151
<?php
152+
138153
$haystack = 'ababcd';
139154
$needle = 'aB';
140155
141156
$pos = strripos($haystack, $needle);
142157
143158
if ($pos === false) {
144-
echo "Leider wurde ($needle) nicht in ($haystack) gefunden.";
159+
echo "Leider wurde `$needle` nicht in `$haystack` gefunden.";
145160
} else {
146161
echo "Glückwunsch!\n";
147-
echo "Das letzte Vorkommen von ($needle) in ($haystack) ist an Position ($pos).";
162+
echo "Das letzte Vorkommen von `$needle` in `$haystack` ist an Position `$pos`.";
148163
}
164+
149165
?>
150166
]]>
151167
</programlisting>
152168
&example.outputs;
153169
<screen>
154170
<![CDATA[
155-
Glückwunsch!
156-
Das letzte Vorkommen von (aB) in (ababcd) ist an Position (2).
171+
Glückwunsch!
172+
Das letzte Vorkommen von `aB` in `ababcd` ist an Position (2).
157173
]]>
158174
</screen>
159175
</example>

‎reference/strings/functions/strrpos.xml‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: simp Status: ready -->
2+
<!-- EN-Revision: 4b72b23513caa3a8bc520d459a0417defc7b3880 Maintainer: simp Status: ready -->
33
<!-- Reviewed: no -->
44
<!-- Credits: sammywg -->
55
<refentry xml:id="function.strrpos" xmlns="http://docbook.org/ns/docbook">
@@ -92,6 +92,19 @@
9292
&return.falseproblem;
9393
</refsect1>
9494

95+
<refsect1 role="errors">
96+
&reftitle.errors;
97+
<itemizedlist>
98+
<listitem>
99+
<simpara>
100+
Wenn <parameter>offset</parameter> größer ist als die Länge von
101+
<parameter>haystack</parameter>, wird eine
102+
<classname>ValueError</classname>-Ausnahme geworfen.
103+
</simpara>
104+
</listitem>
105+
</itemizedlist>
106+
</refsect1>
107+
95108
<refsect1 role="changelog">
96109
&reftitle.changelog;
97110
<informaltable>

0 commit comments

Comments
 (0)