<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: 40e4bf862f9c23ffe871a68baebf31f753d4293b Maintainer: sammywg Status: ready -->

<!-- Reviewed: no -->

<appendix xml:id="json.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

&reftitle.constants;

&extension.constants;

<para>

Die folgenden Konstanten geben den Typ des Fehlers an, der von

<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>int</type>)

</term>

<listitem>

<simpara>

Kein Fehler aufgetreten.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-depth">

<term>

<constant>JSON_ERROR_DEPTH</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Die maximale Stacktiefe wurde überschritten.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-state-mismatch">

<term>

<constant>JSON_ERROR_STATE_MISMATCH</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Tritt ein bei Unterlauf oder State-Mismatch.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-ctrl-char">

<term>

<constant>JSON_ERROR_CTRL_CHAR</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Steuerzeichenfehler, möglicherweise unkorrekt kodiert.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-syntax">

<term>

<constant>JSON_ERROR_SYNTAX</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Syntaxfehler.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-utf8">

<term>

<constant>JSON_ERROR_UTF8</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Ungültige UTF-8 Zeichen, eventuall falsch kodiert.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-recursion">

<term>

<constant>JSON_ERROR_RECURSION</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Das an <function>json_encode</function> übergebene Objekt oder Array

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-inf-or-nan">

<term>

<constant>JSON_ERROR_INF_OR_NAN</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Der an <function>json_encode</function> übergebene Wert enthält entweder

<link linkend="language.types.float.nan"><constant>NAN</constant></link>

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-unsupported-type">

<term>

<constant>JSON_ERROR_UNSUPPORTED_TYPE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Der an <function>json_encode</function> übergebene Wert enthält einen

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-invalid-property-name">

<term>

<constant>JSON_ERROR_INVALID_PROPERTY_NAME</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-utf16">

<term>

<constant>JSON_ERROR_UTF16</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Ein einzelnes, alleinstehendes UTF-16-Surrogat war im JSON-String enthalten, der an

<function>json_decode</function> übergeben wurde.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-error-non-backed-enum">

<term>

<constant>JSON_ERROR_NON_BACKED_ENUM</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Der Wert, der an <function>json_encode</function> übergeben wird, enthält

eine nicht-wertgebundene (non-backed) Enum, die nicht serialisiert werden

kann. Verfügbar von PHP 8.1.0 an.

</simpara>

</listitem>

</varlistentry>

</variablelist>

<para>

Die folgenden Konstanten können kombiniert (verodert) werden,

um Optionen für <function>json_decode</function> zu bilden.

</para>

<variablelist>

<varlistentry xml:id="constant.json-bigint-as-string">

<term>

<constant>JSON_BIGINT_AS_STRING</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Dekodiert große Zahlen als ihre originale Zeichenkette.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-object-as-array">

<term>

<constant>JSON_OBJECT_AS_ARRAY</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

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.

</simpara>

</listitem>

</varlistentry>

</variablelist>

<para>

Die folgenden Konstanten können kombiniert (verodert) werden,

um Optionen für <function>json_encode</function> zu bilden.

</para>

<variablelist>

<varlistentry xml:id="constant.json-hex-tag">

<term>

<constant>JSON_HEX_TAG</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Alle &lt; und &gt; werden zu \u003C und \u003E konvertiert.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-hex-amp">

<term>

<constant>JSON_HEX_AMP</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Alle &amp;s werden zu \u0026 konvertiert.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-hex-apos">

<term>

<constant>JSON_HEX_APOS</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Alle ' werden zu \u0027 konvertiert.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-hex-quot">

<term>

<constant>JSON_HEX_QUOT</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Alle " werden zu \u0022 konvertiert.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-force-object">

<term>

<constant>JSON_FORCE_OBJECT</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

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.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-numeric-check">

<term>

<constant>JSON_NUMERIC_CHECK</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Kodiert numerische Zeichenketten als Zahlen.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-pretty-print">

<term>

<constant>JSON_PRETTY_PRINT</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Nutzt Whitespace um die zurückgegebenen Daten zu formatieren.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-unescaped-slashes">

<term>

<constant>JSON_UNESCAPED_SLASHES</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Escape <literal>/</literal> nicht.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-unescaped-unicode">

<term>

<constant>JSON_UNESCAPED_UNICODE</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Kodiere Unicode Zeichen, welche aus mehreren Bytes bestehen, direkt

(standardmäßig werden \uXXXX Escapes genutzt).

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-partial-output-on-error">

<term>

<constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Ersetze einige unkodierbare Werte anstatt fehlzuschlagen.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-preserve-zero-fraction">

<term>

<constant>JSON_PRESERVE_ZERO_FRACTION</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Stellt sicher, dass &float; Werte immer als Fließkomma-Werte

kodiert werden.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="constant.json-unescaped-line-terminators">

<term>

<constant>JSON_UNESCAPED_LINE_TERMINATORS</constant>

(<type>int</type>)

</term>

<listitem>

<simpara>

Die Zeilentrenner bleiben unmaskiert, wenn

<constant>JSON_UNESCAPED_UNICODE</constant> übergeben wird. Das ist das

gleiche Verhalten wie vor PHP 7.1 ohne diese Konstante.

Verfügbar von PHP 7.1.0 an.

</simpara>

</listitem>

</varlistentry>

</variablelist>

<para>

Die folgenden Konstanten können kombiniert (verodert) werden, um Optionen für

<function>json_decode</function> und <function>json_encode</function> zu

bilden.

</para>

<variablelist>

<varlistentry xml:id="constant.json-invalid-utf8-ignore">

<term>

<constant>JSON_INVALID_UTF8_IGNORE</constant>

(<type>int</type>)

</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>

(<type>int</type>)

</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>int</type>)

</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 von PHP 7.3.0 an.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</appendix>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->