svn: /phpdoc/de/trunk/reference/json/ constants.xml functions/json-decode.xml functions/json-last-error-msg.xml functions/json-last-error.xml jsonserializable/jsonserialize.xml
[email protected] (Christoph Michael Becker)
| Newsgroups | php.doc.de |
|---|---|
| Message-ID | <[email protected]> |
cmb Sat, 27 Jul 2019 12:07:00 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=347809
Log:
Sync with EN
Changed paths:
U phpdoc/de/trunk/reference/json/constants.xml
U phpdoc/de/trunk/reference/json/functions/json-decode.xml
U phpdoc/de/trunk/reference/json/functions/json-last-error-msg.xml
U phpdoc/de/trunk/reference/json/functions/json-last-error.xml
U phpdoc/de/trunk/reference/json/jsonserializable/jsonserialize.xml
svn-diffs-347809.txt
(text/x-diff, 19.7 KB)
Modified: phpdoc/de/trunk/reference/json/constants.xml
===================================================================
--- phpdoc/de/trunk/reference/json/constants.xml 2019-07-27 11:30:19 UTC (rev 347808)
+++ phpdoc/de/trunk/reference/json/constants.xml 2019-07-27 12:07:00 UTC (rev 347809)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 345719 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 347475 Maintainer: sammywg Status: ready -->
<appendix xml:id="json.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
@@ -7,18 +7,19 @@
&extension.constants;
<para>
Die folgenden Konstanten geben den Typ des Fehlers an, der von
- <function>json_last_error</function> zurückgegeben wurde.
+ <function>json_last_error</function> zurückgegeben, oder der als <varname>code</varname>
+ einer <classname>JsonException</classname> gespeichert wurde.
</para>
<variablelist>
<varlistentry xml:id="constant.json-error-none">
<term>
<constant>JSON_ERROR_NONE</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Kein Fehler aufgetreten.
- Verfügbar seit PHP 5.3.0.
+ Verfügbar von PHP 5.3.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -25,12 +26,12 @@
<varlistentry xml:id="constant.json-error-depth">
<term>
<constant>JSON_ERROR_DEPTH</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Die maximale Stacktiefe wurde überschritten.
- Verfügbar seit PHP 5.3.0.
+ Verfügbar von PHP 5.3.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -37,12 +38,12 @@
<varlistentry xml:id="constant.json-error-state-mismatch">
<term>
<constant>JSON_ERROR_STATE_MISMATCH</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Tritt ein bei Unterlauf oder State-Mismatch.
- Verfügbar seit PHP 5.3.0.
+ Verfügbar von PHP 5.3.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -49,12 +50,12 @@
<varlistentry xml:id="constant.json-error-ctrl-char">
<term>
<constant>JSON_ERROR_CTRL_CHAR</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Steuerzeichenfehler, möglicherweise unkorrekt kodiert.
- Verfügbar seit PHP 5.3.0.
+ Verfügbar von PHP 5.3.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -61,12 +62,12 @@
<varlistentry xml:id="constant.json-error-syntax">
<term>
<constant>JSON_ERROR_SYNTAX</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Syntaxfehler.
- Verfügbar seit PHP 5.3.0.
+ Verfügbar von PHP 5.3.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -73,12 +74,12 @@
<varlistentry xml:id="constant.json-error-utf8">
<term>
<constant>JSON_ERROR_UTF8</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Ungültige UTF-8 Zeichen, eventuall falsch kodiert.
- Verfügbar seit PHP 5.3.3.
+ Verfügbar von PHP 5.3.3 an.
</simpara>
</listitem>
</varlistentry>
@@ -85,7 +86,7 @@
<varlistentry xml:id="constant.json-error-recursion">
<term>
<constant>JSON_ERROR_RECURSION</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
@@ -93,7 +94,7 @@
enthält rekursive Referenzen und kann nicht kodiert werden. Wenn
die <constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant> Option übergeben
wurde, wird &null; an Stelle der rekursiven Referenz kodiert.
- Verfügbar seit PHP 5.5.0.
+ Verfügbar von PHP 5.5.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -100,7 +101,7 @@
<varlistentry xml:id="constant.json-error-inf-or-nan">
<term>
<constant>JSON_ERROR_INF_OR_NAN</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
@@ -109,7 +110,7 @@
oder <link linkend="function.is-infinite"><constant>INF</constant></link>.
Wenn die <constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant> Option übergeben
wurde, wird <literal>0</literal> an Stelle dieser speziellen Zahlen kodiert.
- Verfügbar seit PHP 5.5.0.
+ Verfügbar von PHP 5.5.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -116,15 +117,15 @@
<varlistentry xml:id="constant.json-error-unsupported-type">
<term>
<constant>JSON_ERROR_UNSUPPORTED_TYPE</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Der an <function>json_encode</function> übergebene Wert enthält einen
- nicht unterstützten Typ, beispielweise <type>resource</type>.
+ nicht unterstützten Typ, beispielweise &resource;.
Wenn die <constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant> Option übergeben
wurde, wird &null; an Stelle des nicht unterstützten Wertes kodiert.
- Verfügbar seit PHP 5.5.0.
+ Verfügbar von PHP 5.5.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -131,7 +132,7 @@
<varlistentry xml:id="constant.json-error-invalid-property-name">
<term>
<constant>JSON_ERROR_INVALID_PROPERTY_NAME</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
@@ -138,7 +139,7 @@
Ein Schlüssel beginnend mit einem \u0000 Zeichen war in der Zeichenkette
enthalten, die an <function>json_decode</function> übergeben wurde, wenn
ein JSON-Objekt in ein PHP-Objekt konvertiert werden sollte.
- Verfügbar seit PHP 7.0.0.
+ Verfügbar von PHP 7.0.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -145,13 +146,13 @@
<varlistentry xml:id="constant.json-error-utf16">
<term>
<constant>JSON_ERROR_UTF16</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Ein einzelnes, alleinstehendes UTF-16-Surrogat war im JSON-String enthalten, der an
<function>json_decode</function> übergeben wurde.
- Verfügbar seit PHP 7.0.0.
+ Verfügbar von PHP 7.0.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -165,12 +166,12 @@
<varlistentry xml:id="constant.json-bigint-as-string">
<term>
<constant>JSON_BIGINT_AS_STRING</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Dekodiert große Zahlen als ihre originale Zeichenkette.
- Verfügbar seit PHP 5.4.0.
+ Verfügbar von PHP 5.4.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -177,7 +178,7 @@
<varlistentry xml:id="constant.json-object-as-array">
<term>
<constant>JSON_OBJECT_AS_ARRAY</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
@@ -184,7 +185,7 @@
Dekodiert JSON-Objekte als PHP-Arrays. Diese Option kann automatisch
angefügt werden, indem <function>json_decode</function> mit &true; als
zweitem Parameter aufgerufen wird.
- Verfügbar seit PHP 5.4.0.
+ Verfügbar von PHP 5.4.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -197,12 +198,12 @@
<varlistentry xml:id="constant.json-hex-tag">
<term>
<constant>JSON_HEX_TAG</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Alle < und > werden zu \u003C und \u003E konvertiert.
- Verfügbar seit PHP 5.3.0.
+ Verfügbar von PHP 5.3.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -209,12 +210,12 @@
<varlistentry xml:id="constant.json-hex-amp">
<term>
<constant>JSON_HEX_AMP</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Alle &s werden zu \u0026 konvertiert.
- Verfügbar seit PHP 5.3.0.
+ Verfügbar von PHP 5.3.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -221,12 +222,12 @@
<varlistentry xml:id="constant.json-hex-apos">
<term>
<constant>JSON_HEX_APOS</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Alle ' werden zu \u0027 konvertiert.
- Verfügbar seit PHP 5.3.0.
+ Verfügbar von PHP 5.3.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -233,12 +234,12 @@
<varlistentry xml:id="constant.json-hex-quot">
<term>
<constant>JSON_HEX_QUOT</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Alle " werden zu \u0022 konvertiert.
- Verfügbar seit PHP 5.3.0.
+ Verfügbar von PHP 5.3.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -245,7 +246,7 @@
<varlistentry xml:id="constant.json-force-object">
<term>
<constant>JSON_FORCE_OBJECT</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
@@ -252,7 +253,7 @@
Gibt ein Objekt statt einem Array aus, wenn ein nichtassoziatives
Array verwendet wird. Besonders nützlich, wenn der Empfänger der Ausgabe
ein Objekt erwartet und das Array leer ist.
- Verfügbar seit PHP 5.3.0.
+ Verfügbar von PHP 5.3.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -259,12 +260,12 @@
<varlistentry xml:id="constant.json-numeric-check">
<term>
<constant>JSON_NUMERIC_CHECK</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Kodiert numerische Zeichenketten als Zahlen.
- Verfügbar seit PHP 5.3.3.
+ Verfügbar von PHP 5.3.3 an.
</simpara>
</listitem>
</varlistentry>
@@ -271,12 +272,12 @@
<varlistentry xml:id="constant.json-pretty-print">
<term>
<constant>JSON_PRETTY_PRINT</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Nutzt Whitespace um die zurückgegebenen Daten zu formatieren.
- Verfügbar seit PHP 5.4.0.
+ Verfügbar von PHP 5.4.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -283,12 +284,12 @@
<varlistentry xml:id="constant.json-unescaped-slashes">
<term>
<constant>JSON_UNESCAPED_SLASHES</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Escape <literal>/</literal> nicht.
- Verfügbar seit PHP 5.4.0.
+ Verfügbar von PHP 5.4.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -295,13 +296,13 @@
<varlistentry xml:id="constant.json-unescaped-unicode">
<term>
<constant>JSON_UNESCAPED_UNICODE</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Kodiere Unicode Zeichen, welche aus mehreren Bytes bestehen, direkt
(standardmäßig werden \uXXXX Escapes genutzt).
- Verfügbar seit PHP 5.4.0.
+ Verfügbar von PHP 5.4.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -308,12 +309,12 @@
<varlistentry xml:id="constant.json-partial-output-on-error">
<term>
<constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Ersetze einige unkodierbare Werte anstatt fehlzuschlagen.
- Verfügbar seit PHP 5.5.0.
+ Verfügbar von PHP 5.5.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -320,12 +321,12 @@
<varlistentry xml:id="constant.json-preserve-zero-fraction">
<term>
<constant>JSON_PRESERVE_ZERO_FRACTION</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
- Stellt sicher, dass <type>float</type> Werte immer als Fließkomma-Werte
- kodiert werden. Verfügbar seit PHP 5.6.6.
+ Stellt sicher, dass &float; Werte immer als Fließkomma-Werte
+ kodiert werden. Verfügbar von PHP 5.6.6 an.
</simpara>
</listitem>
</varlistentry>
@@ -332,7 +333,7 @@
<varlistentry xml:id="constant.json-unescaped-line-terminators">
<term>
<constant>JSON_UNESCAPED_LINE_TERMINATORS</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
@@ -339,7 +340,7 @@
Die Zeilentrenner bleiben unmaskiert, wenn
<constant>JSON_UNESCAPE_UNICODE</constant> übergeben wird. Das ist das
gleiche Verhalten wie vor PHP 7.1 ohne diese Konstante.
- Verfügbar seit PHP 7.1.0.
+ Verfügbar von PHP 7.1.0 an.
</simpara>
</listitem>
</varlistentry>
@@ -351,23 +352,49 @@
bilden.
</para>
<variablelist>
+ <varlistentry xml:id="constant.json-invalid-utf8-ignore">
+ <term>
+ <constant>JSON_INVALID_UTF8_IGNORE</constant>
+ (&integer;)
+ </term>
+ <listitem>
+ <simpara>
+ Ignoriert ungültige UTF-8 Zeichen.
+ Verfügbar von PHP 7.2.0 an.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.json-invalid-utf8-substitute">
+ <term>
+ <constant>JSON_INVALID_UTF8_SUBSTITUTE</constant>
+ (&integer;)
+ </term>
+ <listitem>
+ <simpara>
+ Konvertiert ungültige UTF-8 Zeichen in \0xfffd
+ (Unicode Zeichen 'REPLACEMENT CHARACTER')
+ Verfügbar von PHP 7.2.0 an.
+ </simpara>
+ </listitem>
+ </varlistentry>
<varlistentry xml:id="constant.json-throw-on-error">
<term>
<constant>JSON_THROW_ON_ERROR</constant>
- (<type>integer</type>)
+ (&integer;)
</term>
<listitem>
<simpara>
Wirft im Fehlerfall eine <classname>JsonException</classname> anstatt den
globalen Fehlerstatus zu setzen, der mit <function>json_last_error</function>
+ und <function>json_last_error_msg</function>
abgerufen werden kann.
<constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant> hat Vorrang vor
- <constant>JSON_THROW_ON_ERROR</constant>. Verfügbar seit PHP 7.3.0.
+ <constant>JSON_THROW_ON_ERROR</constant>. Verfügbar von PHP 7.3.0 an.
</simpara>
</listitem>
</varlistentry>
</variablelist>
-
+
</appendix>
Modified: phpdoc/de/trunk/reference/json/functions/json-decode.xml
===================================================================
--- phpdoc/de/trunk/reference/json/functions/json-decode.xml 2019-07-27 11:30:19 UTC (rev 347808)
+++ phpdoc/de/trunk/reference/json/functions/json-decode.xml 2019-07-27 12:07:00 UTC (rev 347809)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 345972 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 347250 Maintainer: simp Status: ready -->
<!-- Credits: sammywg -->
<refentry xml:id="function.json-decode" xmlns="http://docbook.org/ns/docbook">
@@ -44,7 +44,7 @@
<listitem>
<para>
Wenn &true;, werden zurückgegebene &object;e in assoziative
- <type>Array</type>s konvertiert.
+ &array;s konvertiert.
</para>
</listitem>
</varlistentry>
@@ -150,6 +150,14 @@
<row>
<entry>5.4.0</entry>
<entry>
+ <constant>JSON_BIGINT_AS_STRING</constant> und
+ <constant>JSON_OBJECT_AS_ARRAY</constant>
+ <parameter>options</parameter> wurden hinzugefügt.
+ </entry>
+ </row>
+ <row>
+ <entry>5.4.0</entry>
+ <entry>
Der Parameter <parameter>options</parameter> wurde hinzugefügt.
</entry>
</row>
Modified: phpdoc/de/trunk/reference/json/functions/json-last-error-msg.xml
===================================================================
--- phpdoc/de/trunk/reference/json/functions/json-last-error-msg.xml 2019-07-27 11:30:19 UTC (rev 347808)
+++ phpdoc/de/trunk/reference/json/functions/json-last-error-msg.xml 2019-07-27 12:07:00 UTC (rev 347809)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 343770 Maintainer: tihox Status: ready -->
+<!-- EN-Revision: 347407 Maintainer: tihox Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.json-last-error-msg" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -16,7 +16,9 @@
<void />
</methodsynopsis>
<para>
-
+ Gibt die Fehlerzeichenkette des letzten <function>json_encode</function> oder
+ <function>json_decode</function> Aufrufs, der nicht <constant>JSON_THROW_ON_ERROR</constant>
+ angab, zurück.
</para>
</refsect1>
Modified: phpdoc/de/trunk/reference/json/functions/json-last-error.xml
===================================================================
--- phpdoc/de/trunk/reference/json/functions/json-last-error.xml 2019-07-27 11:30:19 UTC (rev 347808)
+++ phpdoc/de/trunk/reference/json/functions/json-last-error.xml 2019-07-27 12:07:00 UTC (rev 347809)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 341024 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 347407 Maintainer: sammywg Status: ready -->
<refentry xml:id="function.json-last-error" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -16,7 +16,7 @@
</methodsynopsis>
<para>
Gibt (sofern vorhanden) den letzten Fehler zurück, der beim letzten Kodieren/Dekodieren
- von JSON aufgetreten ist.
+ von JSON, das <constant>JSON_THROW_ON_ERROR</constant> nicht angab, aufgetreten ist.
</para>
</refsect1>
@@ -189,6 +189,31 @@
</screen>
</example>
</para>
+ <para>
+ <example>
+ <title><function>json_last_error</function> und <constant>JSON_THROW_ON_ERROR</constant></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Eine ungültige UTF8 Sequenz, die ein JSON_ERROR_UTF8 verursacht
+json_encode("\xB1\x31");
+
+// Das folgende verursacht keinen JSON Fehler
+json_encode('okay', JSON_THROW_ON_ERROR);
+
+// Der globale Fehlerzustand wurde durch das vorherige json_encode nicht geändert
+var_dump(json_last_error() === JSON_ERROR_UTF8);
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+bool(true)
+]]>
+ </screen>
+ </example>
+ </para>
</refsect1>
<refsect1 role="seealso">
Modified: phpdoc/de/trunk/reference/json/jsonserializable/jsonserialize.xml
===================================================================
--- phpdoc/de/trunk/reference/json/jsonserializable/jsonserialize.xml 2019-07-27 11:30:19 UTC (rev 347808)
+++ phpdoc/de/trunk/reference/json/jsonserializable/jsonserialize.xml 2019-07-27 12:07:00 UTC (rev 347809)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 326959 Maintainer: tihox Status: ready -->
+<!-- EN-Revision: 347247 Maintainer: tihox Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="jsonserializable.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -30,7 +30,7 @@
&reftitle.returnvalues;
<para>
Gibt Daten zurück, die von <function>json_encode</function> serialisiert werden können,
- welche ein Wert eines beliebigen Typs, der nicht <type>resource</type> ist.
+ welche ein Wert eines beliebigen Typs, der nicht &resource; ist.
</para>
</refsect1>
@@ -40,7 +40,7 @@
<example>
<title>
<methodname>JsonSerializable::jsonSerialize</methodname> Beispiel, das
- ein <type>array</type> zurückgibt.
+ ein &array; zurückgibt.
</title>
<programlisting role="php">
<![CDATA[
@@ -74,7 +74,7 @@
<example>
<title>
<methodname>JsonSerializable::jsonSerialize</methodname> Beispiel, das
- ein assoziatives <type>array</type> zurückgibt.
+ ein assoziatives &array; zurückgibt.
</title>
<programlisting role="php">
<![CDATA[
@@ -107,7 +107,7 @@
<example>
<title>
<methodname>JsonSerializable::jsonSerialize</methodname> Beispiel, das
- einen <type>integer</type> zurückgibt.
+ einen &integer; zurückgibt.
</title>
<programlisting role="php">
<![CDATA[
@@ -136,7 +136,7 @@
<example>
<title>
<methodname>JsonSerializable::jsonSerialize</methodname> Beispiel,
- das einen <type>string</type> zurückgibt
+ das einen &string; zurückgibt
</title>
<programlisting role="php">
<![CDATA[