svn: /phpdoc/bg/trunk/reference/var/functions/ is-numeric.xml print-r.xml

[email protected] (Stanislav Yordanov) Sat, 23 Apr 2016 00:12:53 +0000
Newsgroups php.doc.bg
Message-ID <[email protected]>
stanprog                                 Sat, 23 Apr 2016 00:12:53 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=339060

Log:
sync with EN

Changed paths:
    U   phpdoc/bg/trunk/reference/var/functions/is-numeric.xml
    U   phpdoc/bg/trunk/reference/var/functions/print-r.xml
svn-diffs-339060.txt (text/x-diff, 10.3 KB)
Modified: phpdoc/bg/trunk/reference/var/functions/is-numeric.xml
===================================================================
--- phpdoc/bg/trunk/reference/var/functions/is-numeric.xml	2016-04-22 19:48:30 UTC (rev 339059)
+++ phpdoc/bg/trunk/reference/var/functions/is-numeric.xml	2016-04-23 00:12:53 UTC (rev 339060)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: pemitev Status: ready -->
+<!-- EN-Revision: 337240 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: pemitev -->
 <refentry xml:id="function.is-numeric" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>is_numeric</refname>
@@ -8,6 +9,7 @@
    Показва дали дадена променлива е число или числов низ
   </refpurpose>
  </refnamediv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -15,14 +17,14 @@
    <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Показва дали дадена променлива е число или числов низ. Числовите низове
-   се състоят от незадължителен знак, комбинация от цифри, незадължителна десетична част и
-   незадължителна експоненциална част.
-   При тези обстоятелства, <literal>+0123.45e6</literal> е валидна числова
-   стойност. Шестнадесетичното представяне (<literal>0xFF</literal>) също е разрешено,
-   но без знак, целочислена и експоненциална част.
-   </para>
+   Показва дали дадена променлива е число или числов низ. Числовите низове се състоят от незадължителен
+   знак, комбинация от цифри, незадължителна десетична част и незадължителна експоненциална част.
+   При тези обстоятелства, <literal>+0123.45e6</literal> е валидна числова стойност. Шестнадесетичното
+   (напр. <literal>0xf4c3b00c</literal>), двоичното (напр. <literal>0b10100111001</literal>) и
+   осмичното (напр. <literal>0777</literal>) представяне не са позволени.
+  </para>
  </refsect1>
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -38,6 +40,7 @@
    </variablelist>
   </para>
  </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
@@ -45,6 +48,81 @@
    иначе връща &false;.
   </para>
  </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Пример за <function>is_numeric</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$tests = array(
+    "42",
+    1337,
+    0x539,
+    02471,
+    0b10100111001,
+    1337e0,
+    "not numeric",
+    array(),
+    9.1
+);
+
+foreach ($tests as $element) {
+    if (is_numeric($element)) {
+        echo "'{$element}' е числова стойност", PHP_EOL;
+    } else {
+        echo "'{$element}' не е числова стойност", PHP_EOL;
+    }
+}
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+'42' е числова стойност
+'1337' е числова стойност
+'1337' е числова стойност
+'1337' е числова стойност
+'1337' е числова стойност
+'1337' е числова променлива
+'not numeric' не е числова стойност
+'Array' не е числова стойност
+'9.1' is numeric
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog"><!-- {{{ -->
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>7.0.0</entry>
+       <entry>
+        Низовете в шестнадесетично представяне (напр. <literal>0xf4c3b00c</literal>)
+        вече не се считат за числови низове, т.е.
+        от тази версия <function>is_numeric</function> връща &false;.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -60,6 +138,7 @@
    </simplelist>
   </para>
  </refsect1>
+
 </refentry>

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

Modified: phpdoc/bg/trunk/reference/var/functions/print-r.xml
===================================================================
--- phpdoc/bg/trunk/reference/var/functions/print-r.xml	2016-04-22 19:48:30 UTC (rev 339059)
+++ phpdoc/bg/trunk/reference/var/functions/print-r.xml	2016-04-23 00:12:53 UTC (rev 339060)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: pemitev Status: ready -->
+<!-- EN-Revision: 334592 Maintainer: pemitev Status: ready -->
+<!-- CREDITS: pemitev -->
 <refentry xml:id="function.print-r" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>print_r</refname>
@@ -14,7 +15,7 @@
   <methodsynopsis>
    <type>mixed</type><methodname>print_r</methodname>
    <methodparam><type>mixed</type><parameter>expression</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>return</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>return</parameter><initializer>false</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>print_r</function> извежда информация за променлива
@@ -22,14 +23,10 @@
   </para>
   <para>
    <function>print_r</function>, <function>var_dump</function> и
-   <function>var_export</function> също така извеждат protected и private
-   свойства на обекти при PHP 5. Статичните членове на класа няма да бъдат изведени.
+   <function>var_export</function>
+   също така извеждат protected и private свойства на обекти при PHP 5.
+   Статичните членове на класа няма да бъдат изведени.
   </para>
-  <para>
-   Не забравяйте, че функцията <function>print_r</function> ще измести
-   указателя на масив в края му. Използвайте функцията <function>reset</function>, за да
-   го върнете в началото.
-  </para>
  </refsect1>

   <refsect1 role="parameters">
@@ -50,8 +47,7 @@
       <para>
        Ако желаете да прихванете изхода от <function>print_r</function>,
        използвайте параметъра <parameter>return</parameter>. Ако стойността му е
-       &true;, функцията <function>print_r</function> ще върне изходните данни, вместо
-       да ги изведе (както прави по подразбиране).
+       &true;, функцията <function>print_r</function> ще върне изходните данни, вместо да ги изведе.
       </para>
      </listitem>
     </varlistentry>
@@ -63,11 +59,14 @@
   &reftitle.returnvalues;
   <para>
    Ако променливата е от тип <type>string</type>, <type>integer</type> или <type>float</type>,
-   ще бъде показана самата стойност.
-   Ако променливата е <type>array</type>, стойностите му ще бъдат показани във формат,
-   при който се извеждат ключовете и елементите.
-   Подобно представяне се използва и за <type>object</type>.
+   ще бъде показана самата стойност. Ако променливата е <type>array</type>, стойностите му
+   ще бъдат показани във формат, при който се извеждат ключовете и елементите. Подобно
+   представяне се използва и за <type>object</type>.
   </para>
+  <para>
+   Когато стойността на параметъра <parameter>return</parameter> е &true;, функцията
+   ще върне низ (<type>string</type>). В противен случай върнатата стойност ще бъде &true;.
+  </para>
  </refsect1>

  <refsect1 role="notes">
@@ -75,44 +74,6 @@
   &note.uses-ob;
  </refsect1>

- <refsect1 role="changelog">
-  &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>4.3.0</entry>
-       <entry>
-        Параметърът <parameter>return</parameter> бе добавен. Ако Ви се
-        налага да прихванете изхода на <function>print_r</function> с по-стара
-        версия на PHP, използвайте
-        <link linkend="ref.outcontrol">функции за управление на изхода</link>.
-       </entry>
-      </row>
-      <row>
-       <entry>4.0.4</entry>
-       <entry>
-        В по-стари версии от PHP 4.0.4, <function>print_r</function> ще продължи вечно,
-        ако се използва за типовете <type>array</type> или <type>object</type>, които
-        съдържат пряка или непряка референция към себе си.  Пример за това
-        е <literal>print_r($GLOBALS)</literal>, защото
-        <literal>$GLOBALS</literal> сама по себе си е глобална, която
-        съдържа референция към себе си.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
-
  <refsect1 role="examples">
   &reftitle.examples;
   <para>