svn: /phpdoc/bg/trunk/reference/strings/functions/ explode.xml

stanprog                                 Fri, 25 Mar 2016 00:00:26 +0000

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

Log:
sync to EN

Changed paths:
    U   phpdoc/bg/trunk/reference/strings/functions/explode.xml

Modified: phpdoc/bg/trunk/reference/strings/functions/explode.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/explode.xml	2016-03-24 23:58:23 UTC (rev 338807)
+++ phpdoc/bg/trunk/reference/strings/functions/explode.xml	2016-03-25 00:00:26 UTC (rev 338808)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 338293 Maintainer: stanprog Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.explode">
  <refnamediv>
   <refname>explode</refname>
@@ -13,13 +13,12 @@
    <type>array</type><methodname>explode</methodname>
    <methodparam><type>string</type><parameter>delimiter</parameter></methodparam>
    <methodparam><type>string</type><parameter>string</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>limit</parameter><initializer>-1</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>limit</parameter><initializer>PHP_INT_MAX</initializer></methodparam>
   </methodsynopsis>
   <para>
    Връща масив от низове, всеки от които е подниз на
    <parameter>string</parameter> формиран посредством разделяне,
-   като за разделител се ползва стойността на параметъра
-   <parameter>delimiter</parameter>.
+   като за разделител се ползва стойността на параметъра <parameter>delimiter</parameter>.
   </para>
  </refsect1>

@@ -55,27 +54,39 @@
        Ако параметърът <parameter>limit</parameter> е отрицателен, всички компоненти
        освен последния -<parameter>limit</parameter> ще бъдат върнати.
       </para>
+      <para>
+       Ако параметърът <parameter>limit</parameter> е нула, се приема за 1.
+      </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
-  <para>
-   Въпреки че, функцията <function>implode</function>, от исторически
-   съображения може да приема параметрите си в произволен ред,
-   функцията <function>explode</function> не може. Трябва да
-   укажете параметъра <parameter>delimiter</parameter>
-   преди параметъра <parameter>string</parameter>
-  </para>
+  <note>
+   <para>
+    Въпреки че, функцията <function>implode</function>, от исторически
+    съображения може да приема параметрите си в произволен ред,
+    функцията <function>explode</function> не може. Трябва да
+    укажете параметъра <parameter>delimiter</parameter>
+    преди параметъра <parameter>string</parameter>.
+   </para>
+  </note>
  </refsect1>

  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
+   Връща масив от низове
+   създаден чрез разделяне на параметъра <parameter>string</parameter>,
+   като за разделител се ползва стойността на параметъра <parameter>delimiter</parameter>.
+  </para>
+  <para>
    Ако <parameter>delimiter</parameter> е празен низ (""),
    функцията <function>explode</function> ще върне стойност &false;.
    Ако <parameter>delimiter</parameter> съдържа стойност която не се
-   съдържа в <parameter>string</parameter>, функцията <function>explode</function>
-   ще върне масив, съдържащ стойността на <parameter>string</parameter>.
+   съдържа в <parameter>string</parameter> и се използва отрицателна стойност
+   за параметъра <parameter>limit</parameter>, ще бъде върнат празен масив,
+   е върне масив, иначе ще бъде върнат масив
+   съдържащ стойността на <parameter>string</parameter>.
   </para>
  </refsect1>

@@ -97,12 +108,6 @@
         Добавена е поддръжка на отрицателни стойности за параметъра <parameter>limit</parameter>
        </entry>
       </row>
-      <row>
-       <entry>4.0.1</entry>
-       <entry>
-        Добавен е параметърът <parameter>limit</parameter>
-       </entry>
-      </row>
      </tbody>
     </tgroup>
    </informaltable>
@@ -136,6 +141,40 @@
   </para>
   <para>
    <example>
+    <title>Пример за върната стойност на <function>explode</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+/*
+   Низ, който не съдържа разделите ще върне просто
+   масив с един елемент, съдържащ първоначалния низ.
+*/
+$input1 = "hello";
+$input2 = "hello,there";
+var_dump( explode( ',', $input1 ) );
+var_dump( explode( ',', $input2 ) );
+
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+array(1)
+(
+    [0] => string(5) "hello"
+)
+array(2)
+(
+    [0] => string(5) "hello"
+    [1] => string(5) "there"
+)
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   <example>
     <title>Примери с параметъра <parameter>limit</parameter></title>
     <programlisting role="php">
 <![CDATA[
@@ -152,7 +191,7 @@
     </programlisting>
     &example.outputs;
     <screen>
-     <![CDATA[
+<![CDATA[
 Array
 (
     [0] => one
@@ -181,7 +220,8 @@
    <simplelist>
     <member><function>preg_split</function></member>
     <member><function>str_split</function></member>
-    <member><function>str_word_count</function></member>
+    <member><function>mb_split</function></member>
+    <member><function>str_word_count</function></member>
     <member><function>strtok</function></member>
     <member><function>implode</function></member>
    </simplelist>
@@ -209,4 +249,4 @@
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->
\ No newline at end of file