Modified: phpdoc/ro/trunk/language-snippets.ent =================================================================== --- phpdoc/ro/trunk/language-snippets.ent 2014-01-10 06:41:32 UTC (rev 332587) +++ phpdoc/ro/trunk/language-snippets.ent 2014-01-10 15:51:33 UTC (rev 332588) @@ -1,7 +1,7 @@ - + @@ -579,6 +579,10 @@ specificată de funcția mb_regex_encoding va fi utilizată în calitate de codificare a caracterelor pentru această funcție.'> + +Codificarea caracterelor specificată de mb_regex_encoding +va fi utilizată implicit în calitate de codificare pentru această funcție.'> + Parametrul encoding reprezintă codificarea caracterelor. Dacă el este omis, va fi utilizată valoarea internă a codificării caracterelor. @@ -871,10 +875,11 @@ pentru a determina instanța Oracle la care trebuie efectuată conexiunea. Pentru a utiliza metoda Easy -Connect, PHP trebuie să fie legat cu bibliotecile-client Oracle 10g sau -ulterioare. Șirul Easy Connect pentru Oracle 10g este de forma: -[//]host_name[:port][/service_name]. Pentru Oracle 11g -sintaxa este: +Connect, PHP trebuie să fie legat cu bibliotecile-client Oracle +10g sau ulterioare. Șirul Easy Connect pentru Oracle +10g este de forma: +[//]host_name[:port][/service_name]. Pentru Oracle +11g sintaxa este: [//]host_name[:port][/service_name][:server_type][/instance_name]. Denumirile serviciilor pot fi găsite rulând utilitara Oracle lsnrctl status pe mașina unde rulează serverul de baze de @@ -934,13 +939,11 @@ oci_connect, oci_pconnect sau oci_new_connect.'> - - Versiune Oracle necesară Această funcție este disponibilă atunci când PHP este compilat cu -bibliotecile Oracle Database de versiunea 10g sau ulterioare.'> +bibliotecile Oracle Database de versiunea 10g +sau ulterioare.'> PerformanțăCu versiuni mai vechi ale OCI8 sau ale Oracle @@ -2145,10 +2148,14 @@ MongoClient este 10000 milisecunde.'> "fsync"O valoare boolean-ă, valoarea -implicită este &false;. Forțează sincronizarea pe disc a operațiunii de inserare -înainte de a întoarce succes. Dacă are valoarea &true;, se presupune efectuarea +implicită este &false;. Dacă jurnalizarea e activată, ea funcționează exact ca +"j". Dacă jurnalizarea nu este acticvată, atunci se forțează +sincronizarea pe disc a operațiunii de inserare înainte de a întoarce succes. +Dacă are valoarea &true;, se presupune efectuarea unei inserări cu confirmare și setarea w va fi modificată în -0.'> +0. +Această opțiune e învechită. Utilizați în loc +opțiunea "j".'> - + &reftitle.constants; &extension.constants; Următoarele constante indică tipul erorii întoarse de funcția - json_last_error. Acestea toate sunt disponibile începând - cu PHP 5.3.0. + json_last_error. - + JSON_ERROR_NONE (integer) @@ -20,10 +19,11 @@ Nu s-a produs vre-o eroare. + Disponibilă începând cu PHP 5.3.0. - + JSON_ERROR_DEPTH (integer) @@ -31,21 +31,36 @@ A fost depășită adâncimea maximă a stivei. + Disponibilă începând cu PHP 5.3.0. - + + JSON_ERROR_STATE_MISMATCH + (integer) + + + + 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. + + + + + JSON_ERROR_CTRL_CHAR (integer) Eroare în caracterul de control, posibil a fost codificat greșit. + Disponibilă începând cu PHP 5.3.0. - + JSON_ERROR_SYNTAX (integer) @@ -53,10 +68,11 @@ Eroare în sintaxă. + Disponibilă începând cu PHP 5.3.0. - + JSON_ERROR_UTF8 (integer) @@ -64,19 +80,70 @@ Caractere UTF-8 eronate, posibil codificate incorect. Această constantă - este disponibilă începând cu PHP 5.3.1. + este disponibilă începând cu PHP 5.3.3. + + + JSON_ERROR_RECURSION + (integer) + + + + Obiectul sau tabloul transmis funcției json_encode + include referințe recursive și de aceea nu pot fi codificate. + Dacă a fost indicată opțiunea JSON_PARTIAL_OUTPUT_ON_ERROR, + în locul referințelor recursive va fi codificat &null;. + + + Această constantă e disponibilă începând cu PHP 5.5.0. + + + + + + JSON_ERROR_INF_OR_NAN + (integer) + + + + Valoarea transmisă funcției json_encode include + NAN + sau INF. + Dacă a fost indicată opțiunea JSON_PARTIAL_OUTPUT_ON_ERROR, + în locul acestor numere speciale va fi codificat 0. + + + Această constantă e disponivilă începând cu PHP 5.5.0. + + + + + + JSON_ERROR_UNSUPPORTED_TYPE + (integer) + + + + O valoare de tip nesusținut a fost transmisă funcției + json_encode, cum ar fi o resource. + Dacă a fost indicată opțiunea JSON_PARTIAL_OUTPUT_ON_ERROR, + în locul valorii nesusținute va fi codificat &null;. + + + Această constantă e disponivilă începând cu PHP 5.5.0. + + + Următoarele constante pot fi combinate pentru a forma opțiuni pentru - json_encode. Toate sunt disponibile începând cu - PHP 5.3.0. + json_encode. - + JSON_HEX_TAG (integer) @@ -84,10 +151,11 @@ Toate < și > sunt convertite în \u003C și \u003E. + Disponibilă începând cu PHP 5.3.0. - + JSON_HEX_AMP (integer) @@ -95,10 +163,11 @@ Toate & sunt convertite în \u0026. + Disponibilă începând cu PHP 5.3.0. - + JSON_HEX_APOS (integer) @@ -106,10 +175,11 @@ Toate ' sunt convertite în \u0027. + Disponibilă începând cu PHP 5.3.0. - + JSON_HEX_QUOT (integer) @@ -117,10 +187,11 @@ Toate " sunt convertite în \u0022. + Disponibilă începând cu PHP 5.3.0. - + JSON_FORCE_OBJECT (integer) @@ -130,9 +201,71 @@ Î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. + + + JSON_NUMERIC_CHECK + (integer) + + + + Codifică șiruri numerice ca numere. + Disponibilă începând cu PHP 5.3.3. + + + + + + JSON_BIGINT_AS_STRING + (integer) + + + + Codifică numerele întregi mari ca șiruri de caractere la valoarea lor originală. + Disponibilă începând cu PHP 5.4.0. + + + + + + JSON_PRETTY_PRINT + (integer) + + + + Folosește spații în datele întoarse pentru a le formata. + Disponibilă începând cu PHP 5.4.0. + + + + + + JSON_UNESCAPED_SLASHES + (integer) + + + + Nu evadează caracterele /. + Disponibilă începând cu PHP 5.4.0. + + + + + + JSON_UNESCAPED_UNICODE + (integer) + + + + 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. + + + Modified: phpdoc/ro/trunk/reference/json/functions/json-decode.xml =================================================================== --- phpdoc/ro/trunk/reference/json/functions/json-decode.xml 2014-01-10 06:41:32 UTC (rev 332587) +++ phpdoc/ro/trunk/reference/json/functions/json-decode.xml 2014-01-10 15:51:33 UTC (rev 332588) @@ -1,7 +1,7 @@ - + @@ -36,8 +36,9 @@ trebuie convertit. - Această funcție operează doar cu date codificate în UTF-8. + Această funcție operează doar cu șiruri codificate în UTF-8. + &json.implementation.superset; @@ -66,9 +67,6 @@ (în mod implicit numerele întregi mari se transformă în numere cu virgulă flotantă) - - &version.trunk.after.53; - @@ -91,7 +89,7 @@ &reftitle.examples; - <function>json_decode</function> exemplu + Exemple <function>json_decode</function> - Un alt exemplu + Accesarea proprietăților nevalide ale unui obiect + + Accesarea elementelor dintr-un obiect, care conțin caractere nepermise + conform convenției de denumiri PHP (de ex. liniuța), poate fi realizată + prin încapsularea denumirii elementului între paranteze figurate și + apostrofuri. + - greșeli comune la utilizarea <function>json_decode</function> + Greșeli tipice la utilizarea <function>json_decode</function> - Erori ale <parameter>depth</parameter> + Erori la parametrul <parameter>depth</parameter> array( @@ -185,19 +189,20 @@ ) ); -// Definește erorile. -$json_errors = array( - JSON_ERROR_NONE => 'No error has occurred', - JSON_ERROR_DEPTH => 'The maximum stack depth has been exceeded', - JSON_ERROR_CTRL_CHAR => 'Control character error, possibly incorrectly encoded', - JSON_ERROR_SYNTAX => 'Syntax error', -); +// Definirea erorilor. +$constants = get_defined_constants(true); +$json_errors = array(); +foreach ($constants["json"] as $name => $value) { + if (!strncmp($name, "JSON_ERROR_", 11)) { + $json_errors[$value] = $name; + } +} // Arată erorile pentru diferite adâncimi. -foreach(range(4, 3, -1) as $depth) { - var_dump(json_decode($json, True, $depth)); - echo 'Last error : ', $json_errors[json_last_error()], PHP_EOL, PHP_EOL; - } +foreach (range(4, 3, -1) as $depth) { + var_dump(json_decode($json, true, $depth)); + echo 'Last error: ', $json_errors[json_last_error()], PHP_EOL, PHP_EOL; +} ?> ]]> @@ -223,10 +228,10 @@ } } } -Last error : No error has occurred +Last error: JSON_ERROR_NONE NULL -Last error : The maximum stack depth has been exceeded +Last error: JSON_ERROR_DEPTH ]]> @@ -235,7 +240,7 @@ + float(1.2345678901235E+19) +} +object(stdClass)#1 (1) { + ["number"]=> + string(20) "12345678901234567890" +} ]]> @@ -282,7 +293,7 @@ - &version.trunk.changelog; + 5.4.0 A fost adăugat parametrul options. @@ -296,6 +307,12 @@ 5.2.3 Limita de imbricare a fost mărită de la 20 la 128. + + 5.2.1 + + A fost adăugată susținerea decodificării JSON a tipurilor de bază. + + Modified: phpdoc/ro/trunk/reference/json/functions/json-encode.xml =================================================================== --- phpdoc/ro/trunk/reference/json/functions/json-encode.xml 2014-01-10 06:41:32 UTC (rev 332587) +++ phpdoc/ro/trunk/reference/json/functions/json-encode.xml 2014-01-10 15:51:33 UTC (rev 332588) @@ -1,7 +1,7 @@ - + @@ -15,6 +15,7 @@ stringjson_encode mixedvalue intoptions0 + intdepth512 Întoarce un șir care conține o reprezentare JSON pentru valoarea @@ -34,8 +35,9 @@ Poate fi de orice tip cu excepția resource. - Această funcție acceptă numai date codate în UTF-8. + Toate șirurile cu date trebuie să fie codificate în UTF-8. + &json.implementation.superset; @@ -46,10 +48,24 @@ JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS, - JSON_FORCE_OBJECT. + JSON_NUMERIC_CHECK, + JSON_PRETTY_PRINT, + JSON_UNESCAPED_SLASHES, + JSON_FORCE_OBJECT, + JSON_UNESCAPED_UNICODE. Comportamentul acestor + constante este descris în + pagina cu constante JSON. + + depth + + + Stabilește adâncimea maximă. Trebuie să fie mai mare decât zero. + + + @@ -57,7 +73,8 @@ &reftitle.returnvalues; - Întoarce un șir (string) reprezentat JSON dacă reușește. + Întoarce un șir (string) reprezentat JSON în caz de succes, + &return.falseforfailure;. @@ -74,17 +91,33 @@ - 5.3.0 + 5.5.0 - A fost adăugat parametrul options. + A fost adăugat parametrul depth. - 5.2.1 + 5.4.0 - A fost adăugată susținerea codificării JSON a tipurilor de date elementare. + Au fost adăugate constantele + JSON_PRETTY_PRINT, + JSON_UNESCAPED_SLASHES, + JSON_UNESCAPED_UNICODE + pentru parametrul options. + + 5.3.3 + + A fost adăugată constanta JSON_NUMERIC_CHECK pentru parametrul option. + + + + 5.3.0 + + A fost adăugat parametrul options. + + @@ -99,7 +132,7 @@ 1,'b'=>2,'c'=>3,'d'=>4,'e'=>5); +$arr = array('a' => 1, 'b' => 2, 'c' => 3, 'd' => 4, 'e' => 5); echo json_encode($arr); ?> @@ -114,19 +147,21 @@ - Un exemplu <function>json_encode</function> demonstrând toate - opțiunile în acțiune + + Un exemplu <function>json_encode</function> ce demonstrează utilizarea opțiunilor + ',"'bar'",'"baz"','&blong&'); +$a = array('',"'bar'",'"baz"','&blong&', "\xc3\xa9"); -echo "Normal: ", json_encode($a), "\n"; -echo "Tags: ", json_encode($a,JSON_HEX_TAG), "\n"; -echo "Apos: ", json_encode($a,JSON_HEX_APOS), "\n"; -echo "Quot: ", json_encode($a,JSON_HEX_QUOT), "\n"; -echo "Amp: ", json_encode($a,JSON_HEX_AMP), "\n"; -echo "All: ", json_encode($a,JSON_HEX_TAG|JSON_HEX_APOS|JSON_HEX_QUOT|JSON_HEX_AMP), "\n\n"; +echo "Normal: ", json_encode($a), "\n"; +echo "Tags: ", json_encode($a, JSON_HEX_TAG), "\n"; +echo "Apos: ", json_encode($a, JSON_HEX_APOS), "\n"; +echo "Quot: ", json_encode($a, JSON_HEX_QUOT), "\n"; +echo "Amp: ", json_encode($a, JSON_HEX_AMP), "\n"; +echo "Unicode: ", json_encode($a, JSON_UNESCAPED_UNICODE), "\n"; +echo "All: ", json_encode($a, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP | JSON_UNESCAPED_UNICODE), "\n\n"; $b = array(); @@ -148,12 +183,13 @@ &example.outputs; ","'bar'","\"baz\"","&blong&"] -Tags: ["\u003Cfoo\u003E","'bar'","\"baz\"","&blong&"] -Apos: ["","\u0027bar\u0027","\"baz\"","&blong&"] -Quot: ["","'bar'","\u0022baz\u0022","&blong&"] -Amp: ["","'bar'","\"baz\"","\u0026blong\u0026"] -All: ["\u003Cfoo\u003E","\u0027bar\u0027","\u0022baz\u0022","\u0026blong\u0026"] +Normal: ["","'bar'","\"baz\"","&blong&","\u00e9"] +Tags: ["\u003Cfoo\u003E","'bar'","\"baz\"","&blong&","\u00e9"] +Apos: ["","\u0027bar\u0027","\"baz\"","&blong&","\u00e9"] +Quot: ["","'bar'","\u0022baz\u0022","&blong&","\u00e9"] +Amp: ["","'bar'","\"baz\"","\u0026blong\u0026","\u00e9"] +Unicode: ["","'bar'","\"baz\"","&blong&","é"] +All: ["\u003Cfoo\u003E","\u0027bar\u0027","\u0022baz\u0022","\u0026blong\u0026","é"] Empty array output as array: [] Empty array output as object: {} @@ -166,14 +202,119 @@ ]]> + + Un exemplu cu tablou secvențial versus un tablou non-secvențial + +"foo", 2=>"bar", 3=>"baz", 4=>"blong"); +var_dump( + $nonsequential, + json_encode($nonsequential) +); + +echo PHP_EOL."Sequential array with one key unset".PHP_EOL; +unset($sequential[1]); +var_dump( + $sequential, + json_encode($sequential) +); +?> +]]> + + &example.outputs; + + + string(3) "foo" + [1]=> + string(3) "bar" + [2]=> + string(3) "baz" + [3]=> + string(5) "blong" +} +string(27) "["foo","bar","baz","blong"]" + +Non-sequential array +array(4) { + [1]=> + string(3) "foo" + [2]=> + string(3) "bar" + [3]=> + string(3) "baz" + [4]=> + string(5) "blong" +} +string(43) "{"1":"foo","2":"bar","3":"baz","4":"blong"}" + +Sequential array with one key unset +array(3) { + [0]=> + string(3) "foo" + [2]=> + string(3) "baz" + [3]=> + string(5) "blong" +} +string(33) "{"0":"foo","2":"baz","3":"blong"}" +]]> + + + + &reftitle.notes; + + + În caz dacă eșuează codificarea, json_last_error poate + fi utilizat pentru a determina natura exactă a erorii. + + + + + La codificarea tablourilor, dacă cheile nu sunt consecutivități numerice + începând cu 0, atunci toate cheile vor fi codificate ca șiruri de caractere, + și vor fi specificate explicit pentru fiecare pereche cheie-valoare. + + + + + Ca și codificatorul JSON de referință, json_encode va + genera JSON care este o valoare simplă (adică nu este obiect sau tablou) + dacă îi este furnizată o valoare de tip string, + integer, float sau boolean pentru + parametrul value. În timp ce majoritatea + decodificatorilor JSON vor accepta aceste valori ca fiind JSON valid, altele + pot să nu-l accepte, deoarece specificația este ambiguă în această privință. + + + În concluzie, întotdeauna verificați ca decodificatorul JSON să poată + prelucra ceea ce se obține cu json_encode. + + + + &reftitle.seealso; + JsonSerializable json_decode + json_last_error + serialize Added: phpdoc/ro/trunk/reference/json/functions/json-last-error-msg.xml =================================================================== (Binary files differ) Property changes on: phpdoc/ro/trunk/reference/json/functions/json-last-error-msg.xml ___________________________________________________________________ Added: svn:mime-type + application/xml Modified: phpdoc/ro/trunk/reference/json/functions/json-last-error.xml =================================================================== --- phpdoc/ro/trunk/reference/json/functions/json-last-error.xml 2014-01-10 06:41:32 UTC (rev 332587) +++ phpdoc/ro/trunk/reference/json/functions/json-last-error.xml 2014-01-10 15:51:33 UTC (rev 332588) @@ -1,7 +1,7 @@ - + @@ -16,8 +16,8 @@ - Întoarce ultima eroare (dacă este prezentă) care a survenit la interpretarea - JSON. + Întoarce ultima eroare (dacă este prezentă) care a survenit la ultima + codificare / decodificare JSON. @@ -53,13 +53,13 @@ - JSON_ERROR_CTRL_CHAR - Eroare a caracterului de control, posibil este codificat incorect + JSON_ERROR_STATE_MISMATCH + Șir JSON invalid sau deteriorat - JSON_ERROR_STATE_MISMATCH - Șir JSON invalid sau deteriorat + JSON_ERROR_CTRL_CHAR + Eroare a caracterului de control, posibil este codificat incorect @@ -72,6 +72,26 @@ Caractere UTF-8 deformate, posibil codificate incorect PHP 5.3.3 + + JSON_ERROR_RECURSION + A fost găsită una sau mai multe referințe recursive în valoarea ce trebuie codificată + PHP 5.5.0 + + + JSON_ERROR_INF_OR_NAN + + A fost găsită una sau mai multe valori + NAN + sau INF + în valoarea ce trebuie codificată + + PHP 5.5.0 + + + JSON_ERROR_UNSUPPORTED_TYPE + A fost furnizată o valoare cu un tip ce nu poate fi codificat + PHP 5.5.0 + @@ -85,33 +105,40 @@ + + + Exemplu <function>json_last_error</function> cu <function>json_encode</function> + + +]]> + + &example.outputs; + + + + + &reftitle.seealso; + json_last_error_msg json_decode + json_encode