archived-doc-ro/reference/json/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- $Author$ -->
<!-- EN-Revision: bd5c1c0ac014e9e2d58e5555194f80a3dfa4695f Maintainer: simionea Status: ready -->

<appendix xml:id="json.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.constants;
 &extension.constants;
 <para>
  Următoarele constante indică tipul erorii întoarse de funcția
  <function>json_last_error</function> sau stocate în atributul
  <varname>code</varname> al obiectului <classname>JsonException</classname>.
 </para>
 <variablelist>
  <varlistentry xml:id="constant.json-error-none">
   <term>
    <constant>JSON_ERROR_NONE</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Nu s-a produs vre-o eroare.
     Disponibilă începând cu PHP 5.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-error-depth">
   <term>
    <constant>JSON_ERROR_DEPTH</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     A fost depășită adâncimea maximă a stivei.
     Disponibilă începând cu PHP 5.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-error-state-mismatch">
   <term>
    <constant>JSON_ERROR_STATE_MISMATCH</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Are loc în cazul unei valori ce depășește limita de jos, sau când modurile
     nu coincid.
     Disponibilă începând cu PHP 5.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-error-ctrl-char">
   <term>
    <constant>JSON_ERROR_CTRL_CHAR</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Eroare în caracterul de control, posibil a fost codificat greșit.
     Disponibilă începând cu PHP 5.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-error-syntax">
   <term>
    <constant>JSON_ERROR_SYNTAX</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Eroare în sintaxă.
     Disponibilă începând cu PHP 5.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-error-utf8">
   <term>
    <constant>JSON_ERROR_UTF8</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Caractere UTF-8 eronate, posibil codificate incorect.
     Disponibilă începând cu PHP 5.3.3.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-error-recursion">
   <term>
    <constant>JSON_ERROR_RECURSION</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Obiectul sau tabloul transmis funcției <function>json_encode</function>
     include referințe recursive și de aceea nu pot fi codificate.
     Dacă a fost indicată opțiunea <constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant>,
     în locul referințelor recursive va fi codificat &null;.
     Disponibilă începând cu PHP 5.5.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-error-inf-or-nan">
   <term>
    <constant>JSON_ERROR_INF_OR_NAN</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Valoarea transmisă funcției <function>json_encode</function> include
     <link linkend="language.types.float.nan"><constant>NAN</constant></link>
     sau <link linkend="function.is-infinite"><constant>INF</constant></link>.
     Dacă a fost indicată opțiunea <constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant>,
     în locul acestor numere speciale va fi codificat <literal>0</literal>.
     Disponibilă începând cu PHP 5.5.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-error-unsupported-type">
   <term>
    <constant>JSON_ERROR_UNSUPPORTED_TYPE</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     O valoare de tip nesusținut a fost transmisă funcției
     <function>json_encode</function>, cum ar fi o &resource;.
     Dacă a fost indicată opțiunea <constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant>,
     în locul valorii nesusținute va fi codificat &null;.
     Disponibilă începând cu PHP 5.5.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-error-invalid-property-name">
   <term>
    <constant>JSON_ERROR_INVALID_PROPERTY_NAME</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     În șirul de caractere transmis funcției <function>json_decode</function> a
     fost găsită o cheie ce începe cu caracterul \u0000, la decodificarea unui
     obiect JSON într-un obiect PHP.
     Disponibilă începând cu PHP 7.0.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-error-utf16">
   <term>
    <constant>JSON_ERROR_UTF16</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     În șirul JSON transmis către <function>json_decode</function> a fost găsit
     un surogat UTF-16 singur, fără pereche.
     Disponibilă începând cu PHP 7.0.0.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <para>
  Următoarele constante pot fi combinate pentru a forma opțiuni pentru
  <function>json_decode</function>.
 </para>
 <variablelist>
  <varlistentry xml:id="constant.json-bigint-as-string">
   <term>
    <constant>JSON_BIGINT_AS_STRING</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Decodifică numere întregi mari ca șiruri de caractere cu valoarea lor originală.
     Disponibilă începând cu PHP 5.4.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-object-as-array">
   <term>
    <constant>JSON_OBJECT_AS_ARRAY</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Decodifică obiecte JSON ca tablouri PHP. Această opțiune poate fi adăugată
     automat apelând <function>json_decode</function> cu al doilea parametru egal
     cu &true;.
     Disponibilă începând cu PHP 5.4.0.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <para>
  Următoarele constante pot fi combinate pentru a forma opțiuni pentru
  <function>json_encode</function>.
 </para>
 <variablelist>
  <varlistentry xml:id="constant.json-hex-tag">
   <term>
    <constant>JSON_HEX_TAG</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Toate &lt; și &gt; sunt convertite în \u003C și \u003E.
     Disponibilă începând cu PHP 5.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-hex-amp">
   <term>
    <constant>JSON_HEX_AMP</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Toate &amp; sunt convertite în \u0026.
     Disponibilă începând cu PHP 5.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-hex-apos">
   <term>
    <constant>JSON_HEX_APOS</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Toate ' sunt convertite în \u0027.
     Disponibilă începând cu PHP 5.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-hex-quot">
   <term>
    <constant>JSON_HEX_QUOT</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Toate " sunt convertite în \u0022.
     Disponibilă începând cu PHP 5.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-force-object">
   <term>
    <constant>JSON_FORCE_OBJECT</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Întoarce un obiect în loc de tablou când este utilizat un tablou
     non-associativ. Util în special când receptorul rezultatului se așteaptă la
     un obiect, iar tabloul este vid.
     Disponibilă începând cu PHP 5.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-numeric-check">
   <term>
    <constant>JSON_NUMERIC_CHECK</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Codifică șiruri numerice ca numere.
     Disponibilă începând cu PHP 5.3.3.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-pretty-print">
   <term>
    <constant>JSON_PRETTY_PRINT</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Folosește spații în datele întoarse pentru a le formata.
     Disponibilă începând cu PHP 5.4.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-unescaped-slashes">
   <term>
    <constant>JSON_UNESCAPED_SLASHES</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Nu evadează caracterele <literal>/</literal>.
     Disponibilă începând cu PHP 5.4.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-unescaped-unicode">
   <term>
    <constant>JSON_UNESCAPED_UNICODE</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Codifică caracterele Unicode pe mai mulți baiți așa cum sunt (implicit se
     efectuează evadarea de tip \uXXXX).
     Disponibilă începând cu PHP 5.4.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-partial-output-on-error">
   <term>
    <constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Substituie unele valori ce nu pot fi codificate, în loc să eșueze.
     Disponibilă începând cu PHP 5.5.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-preserve-zero-fraction">
   <term>
    <constant>JSON_PRESERVE_ZERO_FRACTION</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Asigură ca valorile &float; să fie întotdeauna codificate ca valori float.
     Disponibilă începând cu PHP 5.6.6.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-unescaped-line-terminators">
   <term>
    <constant>JSON_UNESCAPED_LINE_TERMINATORS</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Sfârșiturile liniilor sunt păstrate fără schimbare atunci când este indicată
     <constant>JSON_UNESCAPED_UNICODE</constant>. Ea are același comportament ca
     și până la versiunea PHP 7.1 fără această constantă.
     Disponibilă începând cu PHP 7.1.0.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <para>
  Următoarele constante pot fi combinate pentru a forma opțiuni pentru
  <function>json_decode</function> și <function>json_encode</function>.
 </para>
 <variablelist>
  <varlistentry xml:id="constant.json-invalid-utf8-ignore">
   <term>
    <constant>JSON_INVALID_UTF8_IGNORE</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Ignorează caracterele UTF-8 nevalide.
     Disponibilă începând cu PHP 7.2.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-invalid-utf8-substitute">
   <term>
    <constant>JSON_INVALID_UTF8_SUBSTITUTE</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Convertește caracterele UTF-8 nevalide în \0xfffd
     (Caracterul Unicode 'REPLACEMENT CHARACTER')
     Disponibil începând cu PHP 7.2.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.json-throw-on-error">
   <term>
    <constant>JSON_THROW_ON_ERROR</constant>
    (&integer;)
   </term>
   <listitem>
    <simpara>
     Emite <classname>JsonException</classname> dacă are loc o eroare în loc să seteze
     starea de eroare globală care este obținută cu
     <function>json_last_error</function> și <function>json_last_error_msg</function>.
     <constant>JSON_PARTIAL_OUTPUT_ON_ERROR</constant> are precedență față de
     <constant>JSON_THROW_ON_ERROR</constant>.
     Disponibilă începând cu PHP 7.3.0.
    </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
-->