svn: /phpdoc/bg/trunk/reference/array/functions/ count.xml

stanprog                                 Fri, 01 Apr 2016 23:30:24 +0000

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

Log:
sync to EN

Changed paths:
    U   phpdoc/bg/trunk/reference/array/functions/count.xml

Modified: phpdoc/bg/trunk/reference/array/functions/count.xml
===================================================================
--- phpdoc/bg/trunk/reference/array/functions/count.xml	2016-04-01 23:02:00 UTC (rev 338879)
+++ phpdoc/bg/trunk/reference/array/functions/count.xml	2016-04-01 23:30:24 UTC (rev 338880)
@@ -1,27 +1,28 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 334605 Maintainer: stanprog Status: ready -->
 <refentry xml:id="function.count" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>count</refname>
-  <refpurpose>Връща броя на елементите на даден масив или броя на свойствата на даден обект</refpurpose>
+  <refpurpose>Връща броя на елементите на даден масив или нещо в даден обект</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>int</type><methodname>count</methodname>
-   <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
+   <methodparam><type>mixed</type><parameter>array_or_countable</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>COUNT_NORMAL</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Връща броя на елементите на даден масив или броя на свойствата на даден обект
+   Връща броя на елементите на даден масив или нещо в даден обект
   </para>
   <para>
    За обекти, ако имате инсталирано разширението <link linkend="ref.spl">SPL</link>,
    можете да се възползвате от <function>count</function>
-   като осъществите интерфейса <literal>Countable</literal>.
-   Този интерфейс има само един метод - <function>count</function>,
-   който връща стойността върната от функцията <function>count</function>.
+   като осъществите интерфейса <classname>Countable</classname>.
+   Този интерфейс има само един метод - <methodname>Countable::count</methodname>,
+   който връща стойността върната от
+   функцията <function>count</function>.
   </para>
   <para>
    Моля, обърнете се към частта <link linkend="language.types.array">Масиви</link>
@@ -34,10 +35,10 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>var</parameter></term>
+     <term><parameter>array_or_countable</parameter></term>
      <listitem>
       <para>
-       Масивът.
+       Масив или обект от тип <classname>Countable</classname>.
       </para>
      </listitem>
     </varlistentry>
@@ -48,12 +49,16 @@
        Ако незадължителният параметър <parameter>mode</parameter>
        е установен в <constant>COUNT_RECURSIVE</constant> (или 1),
        <function>count</function> ще преброи елементите
-       на масива рекурсивно. Това е особено полезно при намирането
-       на броя на елементите на многомерен масив. Стойността по подразбиране
-       на параметъра <parameter>mode</parameter> е <literal>0</literal>.
-       <function>count</function> не може да открие сама случаите на
-       безкрайна рекурсия.
+       на масива рекурсивно. Това е особено полезно при намирането на броя на елементите на многомерен масив.
       </para>
+      <caution>
+       <para>
+        Функция <function>count</function> може да разбере кога има рекурсия с цел избягване на
+        зацикляне, но генерира <constant>E_WARNING</constant> всеки път
+        когато има такава (в случай, че масива се съдържа в себе си повече от веднъж) и връща
+        брой, по-голям от колкото може да се очаква.
+       </para>
+      </caution>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -62,50 +67,21 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Връща броя на елементите на променливата <parameter>var</parameter>,
-   която обикновено е масив, тъй като всяка друга променлива би имала
-   само един елемент.
+   Връща броя на елементите на параметъра <parameter>array_or_countable</parameter>.
+   Ако параметърът не е масив или обект,
+   който да реализира интерфейса <classname>Countable</classname>, ще
+   бъде върната стойност <literal>1</literal>.
+   Има само едно изключение от това правило - ако <parameter>array_or_countable</parameter> е &null;
+   ще бъде върната стойност <literal>0</literal>.
   </para>
-  <para>
-   Ако параметърът <parameter>var</parameter> не е масив или обект,
-   който да осъществява интерфейса <literal>Countable</literal>, ще
-   бъде върната стойност <literal>1</literal>. Има само
-   едно изключение от това правило - ако <parameter>var</parameter>
-   е &null; ще бъде върната стойност <literal>0</literal>.
-  </para>
   <caution>
    <para>
-    <function>count</function> ще върне 0 при променлива,
-    която не е установена, а също така ще върне 0 и при променлива,
-    която е инициализирана с празен масив. Използвайте функция
-    <function>isset</function>, за да разберете дали дадена
-    променлива е установена.
+    <function>count</function> ще върне 0 при променлива, която не е установена,
+    а също така ще върне 0 и при променлива, която е инициализирана с
+    празен масив. Използвайте функция <function>isset</function>, за да разберете дали дадена променлива е установена.
    </para>
   </caution>
  </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.2.0</entry>
-       <entry>
-        Добавен е незадължителният параметър <parameter>mode</parameter>.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>