svn: /phpdoc/de/trunk/ appendices/about.xml appendices/ini.list.xml appendices/migration54.xml appendices/reserved.constants.core.xml features/connection-handling.xml language-snippets.ent reference/array/functions/array-map.xml reference/array/functions/array-slice.xml reference/array/functions/array-splice.xml
[email protected] (Christoph Michael Becker)
| Newsgroups | php.doc.de |
|---|---|
| Message-ID | <[email protected]> |
cmb Sun, 10 Nov 2019 16:17:00 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=348287
Log:
Sync with EN
Changed paths:
U phpdoc/de/trunk/appendices/about.xml
U phpdoc/de/trunk/appendices/ini.list.xml
U phpdoc/de/trunk/appendices/migration54.xml
U phpdoc/de/trunk/appendices/reserved.constants.core.xml
U phpdoc/de/trunk/features/connection-handling.xml
U phpdoc/de/trunk/language-snippets.ent
U phpdoc/de/trunk/reference/array/functions/array-map.xml
U phpdoc/de/trunk/reference/array/functions/array-slice.xml
U phpdoc/de/trunk/reference/array/functions/array-splice.xml
svn-diffs-348287.txt
(text/x-diff, 27.6 KB)
Modified: phpdoc/de/trunk/appendices/about.xml
===================================================================
--- phpdoc/de/trunk/appendices/about.xml 2019-11-10 13:08:15 UTC (rev 348286)
+++ phpdoc/de/trunk/appendices/about.xml 2019-11-10 16:17:00 UTC (rev 348287)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 342148 Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 347032 Maintainer: hholzgra Status: ready -->
<!-- Credits: mk, simp -->
<appendix xml:id="about" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -158,7 +158,7 @@
strlen -- Ermitteln der String-Länge
Beschreibung
-int strlen ( string $string )
+strlen ( string $string ) : int
Gibt die Länge der übergebenen Zeichenkette zurück.
]]>
@@ -193,22 +193,22 @@
</row>
<row>
<entry>
- int
+ ( string $string )
</entry>
<entry>
- Type des Wertes, den diese Funktion zurückgibt, welche hier ein
- <type>integer</type> ist (d.h. die Länge einer Zeichenkette in Zahlen
- gemessen).
+ Der erste (und in diesem Fall einzige) Parameter (Argument) dieser
+ Funktion trägt den Namen <parameter>string</parameter> und ist ein
+ <type>String</type>.
</entry>
</row>
<row>
<entry>
- ( string $string )
+ int
</entry>
<entry>
- Der erste (und in diesem Fall einzige) Parameter (Argument) dieser
- Funktion trägt den Namen <parameter>string</parameter> und ist ein
- <type>String</type>.
+ Type des Wertes, den diese Funktion zurückgibt, welche hier ein
+ <type>integer</type> ist (d.h. die Länge einer Zeichenkette in Zahlen
+ gemessen).
</entry>
</row>
</tbody>
@@ -222,7 +222,7 @@
<para>
<screen>
<![CDATA[
- Rückgabetyp Funktionsname ( Parametertyp Parametername )
+ Funktionsname ( Parametertyp Parametername ) : Rückgabetyp
]]>
</screen>
</para>
@@ -233,7 +233,7 @@
<para>
<screen>
<![CDATA[
- bool in_array ( mixed $needle, array $haystack [, bool $strict = FALSE])
+ in_array ( mixed $needle, array $haystack [, bool $strict = FALSE]) : bool
]]>
</screen>
</para>
@@ -265,8 +265,8 @@
<para>
<screen>
<![CDATA[
- int preg_match ( string $pattern , string $subject [, array &$matches
- [, int $flags = 0 [, int $offset = 0 ]]] )
+ preg_match ( string $pattern , string $subject [, array &$matches
+ [, int $flags = 0 [, int $offset = 0 ]]] ) : int
]]>
</screen>
</para>
Modified: phpdoc/de/trunk/appendices/ini.list.xml
===================================================================
--- phpdoc/de/trunk/appendices/ini.list.xml 2019-11-10 13:08:15 UTC (rev 348286)
+++ phpdoc/de/trunk/appendices/ini.list.xml 2019-11-10 16:17:00 UTC (rev 348287)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 346697 Maintainer: nikic Status: ready -->
+<!-- EN-Revision: 348210 Maintainer: nikic Status: ready -->
<section xml:id="ini.list" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Liste der &php.ini;-Direktiven</title>
@@ -245,7 +245,7 @@
<entry><link linkend="ini.asp-tags">asp_tags</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_PERDIR</entry>
- <entry></entry>
+ <entry>Entfernt in PHP 7.0.0.</entry>
</row>
<row>
<entry><link linkend="ini.assert.active">assert.active</link></entry>
@@ -2413,6 +2413,12 @@
</row>
<row>
<entry><link linkend="ini.session.sid-bits-per-character">session.sid_bits_per_character</link></entry>
+ <entry>"4"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry>Verfügbar seit PHP 7.1.0.</entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.session.sid-length">session.sid_length</link></entry>
<entry>"32"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Verfügbar seit PHP 7.1.0.</entry>
@@ -2651,13 +2657,8 @@
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('sqlite3.configuration.list')/*)" />
<row>
- <entry><link linkend="ini.sqlite3.extension-dir">sqlite3.extension_dir</link></entry>
- <entry>""</entry>
- <entry>PHP_INI_SYSTEM</entry>
- <entry>Verfügbar seit PHP 5.3.11.</entry>
- </row>
- <row>
<entry><link linkend="ini.sybase.allow-persistent">sybase.allow_persistent</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
@@ -2763,7 +2764,7 @@
<entry><link linkend="ini.track-errors">track_errors</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
- <entry></entry>
+ <entry>Von PHP 7.2.0 an missbilligt.</entry>
</row>
<row>
<entry><link linkend="ini.unserialize-callback-func">unserialize_callback_func</link></entry>
Modified: phpdoc/de/trunk/appendices/migration54.xml
===================================================================
--- phpdoc/de/trunk/appendices/migration54.xml 2019-11-10 13:08:15 UTC (rev 348286)
+++ phpdoc/de/trunk/appendices/migration54.xml 2019-11-10 16:17:00 UTC (rev 348287)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 344769 Maintainer: cmb Status: ready -->
+<!-- EN-Revision: 347892 Maintainer: cmb Status: ready -->
<appendix xml:id="migration54" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Migration von PHP 5.3.x auf PHP 5.4.x</title>
@@ -315,6 +315,12 @@
Ein eingebauter <link linkend="features.commandline.webserver">Webserver im CLI-Modus</link> für die Entwicklung.
</simpara>
</listitem>
+ <listitem>
+ <simpara>
+ Die GD Extension unterstützt nun Lesen und Schreiben von WebP-Bildern durch
+ <function>imagecreatefromwebp</function> bzw. <function>imagewebp</function>.
+ </simpara>
+ </listitem>
</itemizedlist>
</section>
Modified: phpdoc/de/trunk/appendices/reserved.constants.core.xml
===================================================================
--- phpdoc/de/trunk/appendices/reserved.constants.core.xml 2019-11-10 13:08:15 UTC (rev 348286)
+++ phpdoc/de/trunk/appendices/reserved.constants.core.xml 2019-11-10 16:17:00 UTC (rev 348287)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 345134 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 347996 Maintainer: nobody Status: ready -->
<!-- Credits: hholzgra -->
<sect2 xml:id="reserved.constants.core" xmlns="http://docbook.org/ns/docbook">
Modified: phpdoc/de/trunk/features/connection-handling.xml
===================================================================
--- phpdoc/de/trunk/features/connection-handling.xml 2019-11-10 13:08:15 UTC (rev 348286)
+++ phpdoc/de/trunk/features/connection-handling.xml 2019-11-10 16:17:00 UTC (rev 348287)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 333194 Maintainer: fa Status: ready -->
+<!-- EN-Revision: 347626 Maintainer: fa Status: ready -->
<chapter xml:id="features.connection-handling" xmlns="http://docbook.org/ns/docbook">
<title>Verbindungssteuerung</title>
@@ -19,8 +19,8 @@
Wenn ein PHP-Skript aktiv ist, ist der Status üblicherweise
NORMAL. Sollte der Client-Rechner die Verbindung beenden, wird
der Status auf ABORTED gesetzt. Ein clientseitiges Beenden der
- Verbindung wird für gewöhnlich veranlasst, wenn der Benutzer den
- STOP-Button seines Browsers drückt. Wenn das eingestellte Zeitlimit
+ Verbindung wird für gewöhnlich veranlasst, wenn Benutzer den
+ STOP-Button des Browsers drücken. Wenn das eingestellte Zeitlimit
(siehe <function>set_time_limit</function>) überschritten wird,
wird der Status TIMEOUT gesetzt.</simpara>
Modified: phpdoc/de/trunk/language-snippets.ent
===================================================================
--- phpdoc/de/trunk/language-snippets.ent 2019-11-10 13:08:15 UTC (rev 348286)
+++ phpdoc/de/trunk/language-snippets.ent 2019-11-10 16:17:00 UTC (rev 348287)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 347061 Maintainer: simp Status: wip -->
+<!-- EN-Revision: 347934 Maintainer: simp Status: wip -->
<!-- CREDITS: sammywg, mk, betz -->
<!ENTITY installation.enabled.disable 'Diese Erweiterung ist standardmäßig aktiviert. Sie kann bei der Kompilierung mit der folgenden Option ausgeschaltet werden: '>
@@ -2169,6 +2169,22 @@
<!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>boolean, if the operation (in case of batch operation) must be executed sequentually (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>An array of writeConcern options (see below)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>writeConcern array values</title> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>boolean, force flushing to disk before returning</entry> </row> <row> <entry>j</entry> <entry>boolean, force journal write before returning</entry> </row> <row> <entry>wtimeout</entry> <entry>integer, milliseconds, maximum time the primary is allowed to wait to verify replication</entry> </row> <row> <entry>w</entry> <entry>integer=server count, or string=replication-tag</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'> <!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>The total size (in bytes) of the encoded message being sent over the wire</entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>The MongoDB namespace used for the protocol message <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!-- mongodb -->
+<!ENTITY mongodb.option.maxCommitTimeMS '
+ <row xmlns="http://docbook.org/ns/docbook">
+ <entry>maxCommitTimeMS</entry>
+ <entry>integer</entry>
+ <entry>
+ <para>
+ Die maximale Dauer in Millisekunden, die ein einziger <literal>commitTransaction</literal>-Befehl beanspruchen darf.
+ </para>
+ <para>
+ Wenn angegeben, muss <literal>maxCommitTimeMS</literal> eine vorzeichenbehaftete
+ 32-bit Ganzzahl größer als oder gleich Null sein.
+ </para>
+ </entry>
+ </row>
+'>
+
<!ENTITY mongodb.parameter.namespace '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>namespace</parameter></term>
Modified: phpdoc/de/trunk/reference/array/functions/array-map.xml
===================================================================
--- phpdoc/de/trunk/reference/array/functions/array-map.xml 2019-11-10 13:08:15 UTC (rev 348286)
+++ phpdoc/de/trunk/reference/array/functions/array-map.xml 2019-11-10 16:17:00 UTC (rev 348287)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 339528 Maintainer: wiesemann Status: ready -->
+<!-- EN-Revision: 347465 Maintainer: wiesemann Status: ready -->
<!-- CREDITS: tom -->
<refentry xml:id="function.array-map" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -17,10 +17,11 @@
<methodparam choice="opt"><type>array</type><parameter>...</parameter></methodparam>
</methodsynopsis>
<para>
- <function>array_map</function> gibt ein Array mit allen Elementen von
- <parameter>array1</parameter> zurück, nachdem die Callback-Funktion
- <parameter>callback</parameter> auf jedes einzelne Element angewandt
- wurde. Die Anzahl Parameter, welche die Callback-Funktion
+ <function>array_map</function> gibt ein &array; zurück, das die Ergebnisse der
+ Anwendung der <parameter>callback</parameter> Funktion auf den entsprechenden Index von
+ <parameter>array1</parameter> (und <parameter>...</parameter>, wenn weitere Arrays angegeben wurden)
+ als Callback-Argumente enthält.
+ Die Anzahl Parameter, welche die Callback-Funktion
<parameter>callback</parameter> akzeptiert, sollte der Anzahl der an
<function>array_map</function> übergebenen Arrays entsprechen.
</para>
@@ -37,6 +38,12 @@
Callback-Funktion, die für jedes Element in jedem Array
aufgerufen werden soll.
</para>
+ <para>
+ &null; kann als Wert an <parameter>callback</parameter> übergeben werden,
+ um eine zip-Operation auf mehrere Arrays durchzuführen.
+ Wird nur <parameter>array1</parameter> übergeben,
+ gibt <methodname>array_map</methodname> das Eingabe-Array zurück.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -52,7 +59,7 @@
<term><parameter>...</parameter></term>
<listitem>
<para>
- Variable Liste von Array-Argumenten, auf die die
+ Zusätzliche variable Liste von Array-Argumenten, auf die die
<parameter>callback</parameter>-Funktion angewendet werden soll.
</para>
</listitem>
@@ -64,10 +71,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Gibt ein Array zurück, das alle Elemente von
- <parameter>array1</parameter> enthält, nachdem die
- <parameter>callback</parameter>-Funktion auf jedes Element
- angewendet wurde.
+ <function>array_map</function> gibt ein Array zurück, das die Ergebnisse der
+ Anwendung der <parameter>callback</parameter> Funktion auf den entsprechenden Index von
+ <parameter>array1</parameter> (und <parameter>...</parameter>, wenn weitere Arrays angegeben wurden)
+ als Callback-Argumente enthält.
</para>
</refsect1>
@@ -81,11 +88,11 @@
<?php
function cube($n)
{
- return($n * $n * $n);
+ return ($n * $n * $n);
}
-$a = array(1, 2, 3, 4, 5);
-$b = array_map("cube", $a);
+$a = [1, 2, 3, 4, 5];
+$b = array_map('cube', $a);
print_r($b);
?>
]]>
@@ -148,21 +155,21 @@
<?php
function show_Spanish($n, $m)
{
- return("Die Zahl $n heißt auf Spanisch $m");
+ return "Die Zahl {$n} heißt auf Spanisch {$m}";
}
function map_Spanish($n, $m)
{
- return(array($n => $m));
+ return [$n => $m];
}
-$a = array(1, 2, 3, 4, 5);
-$b = array("uno", "dos", "tres", "cuatro", "cinco");
+$a = [1, 2, 3, 4, 5];
+$b = ['uno', 'dos', 'tres', 'cuatro', 'cinco'];
-$c = array_map("show_Spanish", $a, $b);
+$c = array_map('show_Spanish', $a, $b);
print_r($c);
-$d = array_map("map_Spanish", $a , $b);
+$d = array_map('map_Spanish', $a , $b);
print_r($d);
?>
]]>
@@ -227,13 +234,13 @@
</para>
<para>
<example>
- <title>Erstellen eines Arrays mit Arrays</title>
+ <title>Durchführen einer zip-Operation von Arrays</title>
<programlisting role="php">
<![CDATA[
<?php
-$a = array(1, 2, 3, 4, 5);
-$b = array("eins", "zwei", "drei", "vier", "fünf");
-$c = array("uno", "dos", "tres", "cuatro", "cinco");
+$a = [1, 2, 3, 4, 5];
+$b = ['eins', 'zwei', 'drei', 'vier', 'fünf'];
+$c = ['uno', 'dos', 'tres', 'cuatro', 'cinco'];
$d = array_map(null, $a, $b, $c);
print_r($d);
@@ -292,19 +299,47 @@
</para>
<para>
<example>
+ <title>
+ &null; <parameter>callback</parameter> nur mit <parameter>array1</parameter>
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$array = [1, 2, 3];
+var_dump(array_map(null, $array));
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+array(3) {
+ [0]=>
+ int(1)
+ [1]=>
+ int(2)
+ [2]=>
+ int(3)
+}
+]]>
+ </screen>
+ </example>
+ </para>
+ <para>
+ <example>
<title><function>array_map</function> - mit String-Schlüsseln</title>
<programlisting role="php">
<![CDATA[
<?php
-$arr = array("stringkey" => "value");
+$arr = ['stringkey' => 'value'];
function cb1($a) {
- return array ($a);
+ return [$a];
}
function cb2($a, $b) {
- return array ($a, $b);
+ return [$a, $b];
}
-var_dump(array_map("cb1", $arr));
-var_dump(array_map("cb2", $arr, $arr));
+var_dump(array_map('cb1', $arr));
+var_dump(array_map('cb2', $arr, $arr));
var_dump(array_map(null, $arr));
var_dump(array_map(null, $arr, $arr));
?>
Modified: phpdoc/de/trunk/reference/array/functions/array-slice.xml
===================================================================
--- phpdoc/de/trunk/reference/array/functions/array-slice.xml 2019-11-10 13:08:15 UTC (rev 348286)
+++ phpdoc/de/trunk/reference/array/functions/array-slice.xml 2019-11-10 16:17:00 UTC (rev 348287)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 345313 Maintainer: gerdtsteltner Status: ready -->
+<!-- EN-Revision: 347119 Maintainer: gerdtsteltner Status: ready -->
<!-- CREDITS: tom -->
<refentry xml:id="function.array-slice" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -41,11 +41,17 @@
<para>
Ist <parameter>offset</parameter> nicht negativ, beginnt die
Sequenz bei diesem Offset in dem <parameter>array</parameter>.
+ </para>
+ <para>
Ist <parameter>offset</parameter> negativ, beginnt die Sequenz
so viele Elemente vor dem Ende von <parameter>array</parameter>.
- Es ist zu beachten, dass der <parameter>offset</parameter> die Position
- im Array angibt, nicht den Schlüssel.
</para>
+ <note>
+ <para>
+ Der <parameter>offset</parameter> Parameter gibt die Position
+ im Array an, nicht den Schlüssel.
+ </para>
+ </note>
</listitem>
</varlistentry>
<varlistentry>
@@ -53,12 +59,18 @@
<listitem>
<para>
Ist <parameter>length</parameter> angegeben und positiv, enthält
- die Sequenz bis zu so viele Elemente. Wenn das Array kürzer als der
- <parameter>length</parameter> ist, dann werden nur die verfügbaren
- Array-Elemente vorhanden sein. Ist
- <parameter>length</parameter> angegeben und negativ, endet die
- Sequenz so viele Elemente vor dem Ende des Arrays. Wenn nicht
- angegeben, enthält die Sequenz alle Elemente von
+ die Sequenz bis zu so viele Elemente.
+ </para>
+ <para>
+ Ist das Array kürzer als <parameter>length</parameter>, dann werden nur
+ die verfügbaren Array-Elemente vorhanden sein.
+ </para>
+ <para>
+ Ist <parameter>length</parameter> angegeben und negativ, endet die
+ Sequenz so viele Elemente vor dem Ende des Arrays.
+ </para>
+ <para>
+ Wenn nicht angegeben, enthält die Sequenz alle Elemente von
<parameter>offset</parameter> bis zum Ende von
<parameter>array</parameter>.
</para>
@@ -67,13 +79,15 @@
<varlistentry>
<term><parameter>preserve_keys</parameter></term>
<listitem>
- <para>
- Beachten Sie, dass <function>array_slice</function>
- standardmäßig ganzzahlige Schlüssel des Arrays zurücksetzt und neu vergibt.
- Sie können dieses Verhalten ändern, indem Sie
- <parameter>preserve_keys</parameter> auf &true; setzen.
- Zeichenkettenschlüssel werden immer erhalten, unabhängig von diesem Parameter.
- </para>
+ <note>
+ <para>
+ <function>array_slice</function> setzt
+ standardmäßig ganzzahlige Schlüssel des Arrays zurück und vergibt sie neu.
+ Dieses Verhalten kann geändert werden, indem
+ <parameter>preserve_keys</parameter> auf &true; gesetzt wird.
+ Zeichenkettenschlüssel werden immer erhalten, unabhängig von diesem Parameter.
+ </para>
+ </note>
</listitem>
</varlistentry>
</variablelist>
@@ -82,7 +96,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Gibt den Ausschnitt zurück. Wenn der gewählte offset größer als die Anzahl an Array Elementen ist, wird ein leeres Array zurückgegeben.
+ Gibt den Ausschnitt zurück. Ist der gewählte offset größer als die Anzahl an Array-Elementen,
+ wird ein leeres Array zurückgegeben.
</para>
</refsect1>
<refsect1 role="changelog">
@@ -101,10 +116,10 @@
<entry>5.2.4</entry>
<entry>
Der Standardwert des <parameter>length</parameter> Parameters wurde zu
- <literal>NULL</literal> geändert. Eine <literal>NULL</literal>
+ &null; geändert. Eine &null;
<parameter>length</parameter> weist nun die Funktion an, die Länge des
<parameter>array</parameter> zu verwenden. Vor dieser Version wurde
- eine <literal>NULL</literal> <parameter>length</parameter> als 0
+ eine &null; <parameter>length</parameter> als 0
interpretiert (nichts wird zurückgegeben).
</entry>
</row>
@@ -216,9 +231,9 @@
&reftitle.seealso;
<para>
<simplelist>
+ <member><function>array_chunk</function></member>
<member><function>array_splice</function></member>
<member><function>unset</function></member>
- <member><function>array_chunk</function></member>
</simplelist>
</para>
</refsect1>
Modified: phpdoc/de/trunk/reference/array/functions/array-splice.xml
===================================================================
--- phpdoc/de/trunk/reference/array/functions/array-splice.xml 2019-11-10 13:08:15 UTC (rev 348286)
+++ phpdoc/de/trunk/reference/array/functions/array-splice.xml 2019-11-10 16:17:00 UTC (rev 348287)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 342773 Maintainer: gerdtsteltner Status: ready -->
+<!-- EN-Revision: 347729 Maintainer: gerdtsteltner Status: ready -->
<refentry xml:id="function.array-splice" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_splice</refname>
@@ -24,11 +24,13 @@
<parameter>input</parameter>, und ersetzt diese durch die Elemente
des Arrays <parameter>replacement</parameter>, wenn angegeben.
</para>
- <para>
- Beachten Sie, dass numerische Schlüssel in
- <parameter>input</parameter> nicht erhalten werden.
- </para>
<note>
+ <para>
+ Numerische Schlüssel in
+ <parameter>input</parameter> werden nicht erhalten.
+ </para>
+ </note>
+ <note>
<simpara>
Wenn <parameter>replacement</parameter> kein Array ist, wird es in
ein Array <link linkend="language.types.array.casting">umgewandelt</link>
@@ -56,7 +58,10 @@
<para>
Ist <parameter>offset</parameter> positiv, beginnt der zu
entfernende Bereich bei diesem Offset vom Anfang des Arrays
- <parameter>input</parameter>. Ist <parameter>offset</parameter>
+ <parameter>input</parameter>.
+ </para>
+ <para>
+ Ist <parameter>offset</parameter>
negativ, beginnt der zu entfernende Bereich so viele Elemente
vor dem Ende des Arrays <parameter>input</parameter>.
</para>
@@ -68,18 +73,30 @@
<para>
Ist <parameter>length</parameter> nicht angegeben, wird alles
von <parameter>offset</parameter> bis zum Ende des Arrays
- entfernt. Ist <parameter>length</parameter> angegeben und
- positiv, werden so viele Elemente entfernt. Ist
- <parameter>length</parameter> angegeben und negativ, so ist das
+ entfernt.
+ </para>
+ <para>
+ Ist <parameter>length</parameter> angegeben und
+ positiv, werden so viele Elemente entfernt.
+ </para>
+ <para>
+ Ist <parameter>length</parameter> angegeben und negativ, so ist das
Ende des entfernten Bereichs so viele Elemente vor dem Ende des
- Array. Wenn <parameter>length</parameter> angegeben und 0 ist, werden
+ Array.
+ </para>
+ <para>
+ Wenn <parameter>length</parameter> angegeben und 0 ist, werden
keine Elemente entfernt.
- Tipp: Um alles von <parameter>offset</parameter> bis zum
- Ende des Arrays zu entfernen, wenn
- <parameter>replacement</parameter> ebenfalls angegeben ist,
- verwenden Sie <literal>count($input)</literal> als
- <parameter>length</parameter>.
</para>
+ <tip>
+ <para>
+ Um alles von <parameter>offset</parameter> bis zum
+ Ende des Arrays zu entfernen, wenn
+ <parameter>replacement</parameter> ebenfalls angegeben ist,
+ verwenden Sie <code>count($input)</code> als
+ <parameter>length</parameter>.
+ </para>
+ </tip>
</listitem>
</varlistentry>
<varlistentry>
@@ -95,12 +112,16 @@
<parameter>length</parameter> so angegeben, dass nichts entfernt
wird, werden die Elemente von <parameter>replacement</parameter>
an der von <parameter>offset</parameter> spezifizierten Stelle
- eingefügt. Beachten Sie, dass Schlüssel bei der Ersetzung nicht
- erhalten werden.
+ eingefügt.
</para>
+ <note>
+ <para>
+ Schlüssel werden bei der Ersetzung nicht erhalten.
+ </para>
+ </note>
<para>
Wenn <parameter>replacement</parameter> nur aus einem Element
- besteht, ist es nicht notwendig, <literal>array()</literal>
+ besteht, ist es nicht notwendig, <literal>array()</literal> oder eckige Klammern
anzugeben, sofern das Element nicht selbst ein Array, ein Objekt
oder &null; ist.
</para>
@@ -126,36 +147,64 @@
<?php
$input = array("rot", "grün", "blau", "gelb");
array_splice($input, 2);
-// $input ist nun array("rot", "grün")
+var_dump($input);
$input = array("rot", "grün", "blau", "gelb");
array_splice($input, 1, -1);
-// $input ist nun array("rot", "gelb")
+var_dump($input);
$input = array("rot", "grün", "blau", "gelb");
array_splice($input, 1, count($input), "orange");
-// $input ist nun array("rot", "orange")
+var_dump($input);
$input = array("rot", "grün", "blau", "gelb");
array_splice($input, -1, 1, array("schwarz", "braun"));
-// $input ist nun array("rot", "grün",
-// "blau", "schwarz", "braun")
-
-$input = array("rot", "grün", "blau", "gelb");
-array_splice($input, 3, 0, "lila");
-// $input is now array("rot", "grün",
-// "blau", "lila", "gelb");
+var_dump($input);
?>
]]>
</programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+array(2) {
+ [0]=>
+ string(3) "rot"
+ [1]=>
+ string(5) "grün"
+}
+array(2) {
+ [0]=>
+ string(3) "rot"
+ [1]=>
+ string(4) "gelb"
+}
+array(2) {
+ [0]=>
+ string(3) "rot"
+ [1]=>
+ string(6) "orange"
+}
+array(5) {
+ [0]=>
+ string(3) "rot"
+ [1]=>
+ string(5) "grün"
+ [2]=>
+ string(4) "blau"
+ [3]=>
+ string(7) "schwarz"
+ [4]=>
+ string(5) "braun"
+}
+]]>
+ </screen>
</example>
</para>
<para>
<example>
- <title><function>array_splice</function>-Beispiele</title>
+ <title><function>array_splice</function>-Beispiele zu gleichwertigen Anweisungen</title>
<para>
- Die folgenden Anweisungen ändern die Werte von <varname>$input</varname>
- auf die gleiche Weise:
+ Die folgenden Anweisungen sind gleichwertig:
</para>
<programlisting role="php">
<![CDATA[
@@ -189,9 +238,9 @@
&reftitle.seealso;
<para>
<simplelist>
+ <member><function>array_merge</function></member>
<member><function>array_slice</function></member>
<member><function>unset</function></member>
- <member><function>array_merge</function></member>
</simplelist>
</para>
</refsect1>