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

Modified: phpdoc/bg/trunk/reference/strings/functions/strspn.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/strspn.xml	2016-04-03 22:28:07 UTC (rev 338906)
+++ phpdoc/bg/trunk/reference/strings/functions/strspn.xml	2016-04-04 01:29:46 UTC (rev 338907)
@@ -1,57 +1,71 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 283839 Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 337482 Maintainer: stanprog Status: ready -->
 <refentry xml:id="function.strspn" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>strspn</refname>
-  <refpurpose>Връща дължината на сегмент в началото на низ, съответстващ на дадена маска</refpurpose>
+  <refpurpose>
+   Връща дължината на участък от началото на низ, състоящ се
+   изцяло от знаци съдържащи се в дадената маска.
+  </refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>int</type><methodname>strspn</methodname>
-   <methodparam><type>string</type><parameter>str1</parameter></methodparam>
-   <methodparam><type>string</type><parameter>str2</parameter></methodparam>
+   <methodparam><type>string</type><parameter>subject</parameter></methodparam>
+   <methodparam><type>string</type><parameter>mask</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Намира дължината на сегмент в началото на низ, съответстващ на дадена маска
+   Връща дължината на участъка от началото на низ <parameter>subject</parameter>,
+   съдържащ <emphasis>само</emphasis> знаци от <parameter>mask</parameter>.
   </para>
   <para>
+   Ако параметрите <parameter>start</parameter> и <parameter>length</parameter>
+   не са указани, то ще се изследва целия низ <parameter>subject</parameter>.
+   Ако са указани, ефектът ще бъде същият, като
+   извикването на <literal>strspn(substr($subject, $start, $length),
+   $mask)</literal> (вж. <xref linkend="function.substr" />
+   за повече информация).
+  </para>
+  <para>
    Следният код:
    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
-$var = strspn("42 is the answer, what is the question ...", "1234567890");
+$var = strspn("42 is the answer to the 128th question.", "1234567890");
 ?>
 ]]>
     </programlisting>
    </informalexample>
-   ще присвои 2 на <varname>$var</varname>, тък като низа "42" ще бъде
-   най-дългият сегмент съдържащ знаците от "1234567890".
+   ще присвои <literal>2</literal> на <varname>$var</varname>,
+   тъй като низа "42" е началният участък
+   от <parameter>subject</parameter>, който се състои само от знаци
+   измежду "1234567890".
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>str1</parameter></term>
+     <term><parameter>subject</parameter></term>
      <listitem>
       <para>
-       Първият низ.
+       Изследваният низ.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>str2</parameter></term>
+     <term><parameter>mask</parameter></term>
      <listitem>
       <para>
-       Вторият низ.
+       Списък на позволените знаци.
       </para>
      </listitem>
     </varlistentry>
@@ -59,56 +73,68 @@
      <term><parameter>start</parameter></term>
      <listitem>
       <para>
-       Началната позиция за изследване на низа.
-       При отрицателна стойност позицията се отчита от края на низа.
+       Позицията в <parameter>subject</parameter> за
+       начало на търсенето.
       </para>
+      <para>
+       Ако <parameter>start</parameter> е указан и е неотрицателен,
+       то <function>strspn</function> ще започне с
+       разглеждането на <parameter>subject</parameter> започвайки от
+       позиция <parameter>start</parameter>. Например в
+       низа '<literal>abcdef</literal>', знакът на
+       позиция <literal>0</literal> е '<literal>a</literal>', знака на
+       позиция <literal>2</literal> е
+       '<literal>c</literal>'и така нататък.
+      </para>
+      <para>
+       Ако <parameter>start</parameter> е указан и е отрицателен,
+       то <function>strspn</function> ще започне с
+       разглеждането на <parameter>subject</parameter> започвайки от
+       позиция <parameter>start</parameter> от края на
+       <parameter>subject</parameter>.
+      </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>length</parameter></term>
      <listitem>
       <para>
-       Дължината на изследвания низ.
-       При отрицателна стойност се установява дължината от края на низа.
+       Дължината на сегмента от <parameter>subject</parameter>
+       за изследване.
       </para>
+      <para>
+       Ако <parameter>length</parameter> е указан и неотрицателен,
+       то низът <parameter>subject</parameter>  ще бъде изследван от
+       за <parameter>length</parameter> знака от стартовата
+       позиция.
+      </para>
+      <para>
+       Ако <parameter>length</parameter> е указан и отрицателен,
+       то низът <parameter>subject</parameter>  ще бъде изследван от
+       началната позиция до <parameter>length</parameter>
+       знака от края на <parameter>subject</parameter>.
+      </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Връща дължината на сегмент от началото на <parameter>str1</parameter>,
-   който се състои от всички символи в <parameter>str2</parameter>
+   Връща дължината на сегмент от началото на <parameter>subject</parameter>,
+   който се състои от всички символи в <parameter>mask</parameter>
   </para>
+  <note>
+   <para>
+    Когато параметърът <parameter>start</parameter> е установен, върнатата дължина
+    се брои от тази позиция, а не от началото на
+    <parameter>subject</parameter>.
+   </para>
+  </note>
  </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>start</parameter> и <parameter>length</parameter>
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -117,19 +143,34 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-echo strspn("foo", "o", 1, 2); // 2
+// subject does not start with any characters from mask
+var_dump(strspn("foo", "o"));
+
+// examine two characters from subject starting at offset 1
+var_dump(strspn("foo", "o", 1, 2));
+
+// examine one character from subject starting at offset 1
+var_dump(strspn("foo", "o", 1, 1));
 ?>
 ]]>
     </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+int(0)
+int(2)
+int(1)
+]]>
+    </screen>
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.bin-safe;
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -138,7 +179,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

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