svn: /phpdoc/bg/trunk/reference/strings/functions/ sscanf.xml str-replace.xml

Modified: phpdoc/bg/trunk/reference/strings/functions/sscanf.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/sscanf.xml	2016-04-05 22:20:46 UTC (rev 338935)
+++ phpdoc/bg/trunk/reference/strings/functions/sscanf.xml	2016-04-05 22:39:48 UTC (rev 338936)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 324696 Maintainer: stanprog Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.sscanf" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>sscanf</refname>
@@ -24,10 +24,10 @@
   <para>
    Всеки интервал в низа за форматиране съответства на интервал в изходния низ.
    Това означава, че дори табулацията \t в низа за форматиран съответства
-   на знак за интервл в изходния низ.
+   на знак за интервал в изходния низ.
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -45,7 +45,26 @@
      <listitem>
       <para>
        Интерпретираният формат за <parameter>str</parameter>, който е
-       описан в документацията на <function>sprintf</function>.
+       описан в документацията на <function>sprintf</function> със
+       следните разлики:
+       <simplelist>
+        <member>
+         Работата на функцията не зависи от локала.
+        </member>
+        <member>
+         <literal>F</literal>, <literal>g</literal>, <literal>G</literal> и
+         <literal>b</literal> не се поддържат.
+        </member>
+        <member>
+         <literal>D</literal> обозначава десетично число.
+        </member>
+        <member>
+         <literal>i</literal> обозначава цяло число с автоматично откриване на бройната система.
+        </member>
+        <member>
+         <literal>n</literal> обозначава броя знаци обработени до момента.
+        </member>
+       </simplelist>
       </para>
      </listitem>
     </varlistentry>
@@ -61,7 +80,7 @@
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
@@ -71,8 +90,13 @@
    присвоените стойности. Незадължителните параметри
    трябва да бъдат предадени по референция.
   </para>
+  <para>
+   Ако се очакват повече поднизове във <parameter>format</parameter>,
+   от достъпните в параметър <parameter>str</parameter>,
+   ще бъде върната стойност <literal>-1</literal>.
+  </para>
  </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -115,7 +139,7 @@
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -126,7 +150,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

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

Modified: phpdoc/bg/trunk/reference/strings/functions/str-replace.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/str-replace.xml	2016-04-05 22:20:46 UTC (rev 338935)
+++ phpdoc/bg/trunk/reference/strings/functions/str-replace.xml	2016-04-05 22:39:48 UTC (rev 338936)
@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 334592 Maintainer: stanprog Status: ready -->
 <refentry xml:id="function.str-replace" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>str_replace</refname>
   <refpurpose>Замества всички срещания на търсения низ със заместващия низ</refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -23,11 +23,10 @@
   </para>
   <para>
    Ако не се нуждаете от сложни правила за замяна
-   е препоръчително да използвате тази функция, вместо
-   <function>ereg_replace</function> или <function>preg_replace</function>.
+   е препоръчително да използвате тази функция, вместо <function>preg_replace</function>.
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -52,6 +51,8 @@
      <term><parameter>search</parameter></term>
      <listitem>
       <para>
+       Стойността, която се търси, позната още като <emphasis>needle</emphasis>.
+       За повече търсени стойности може да се използва масив.
       </para>
      </listitem>
     </varlistentry>
@@ -59,6 +60,8 @@
      <term><parameter>replace</parameter></term>
      <listitem>
       <para>
+       Стойността за замяна, която заменя намерените стойности на
+       <parameter>search</parameter>. За повече търсени стойности може да се използва масив.
       </para>
      </listitem>
     </varlistentry>
@@ -66,6 +69,10 @@
      <term><parameter>subject</parameter></term>
      <listitem>
       <para>
+       Низ или масив, в който се извършва търсенето и замяната,
+       познат още като <emphasis>haystack</emphasis>.
+      </para>
+      <para>
        Ако <parameter>subject</parameter> е масив, то търсенето и замяната
        се осъществяват с всеки елемент на <parameter>subject</parameter>.
        Върнатата стойност също е масив.
@@ -75,75 +82,27 @@
     <varlistentry>
      <term><parameter>count</parameter></term>
      <listitem>
-      <note>
-       <simpara>
-        Ако този параметър е предаден, то той ще съдържа броя на съвпадащите и заменени знаци.
-       </simpara>
-      </note>
+      <para>
+       Ако този параметър е предаден, ще бъде установен на броя на направените замени.
+      </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    Функцията връща низ или масив със заменените стойности.
   </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>5.0.0</entry>
-       <entry>
-        Добавен е параметъра <parameter>count</parameter>.
-       </entry>
-      </row>
-      <row>
-       <entry>4.3.3</entry>
-       <entry>
-        Начина на работа на функцията е променен.
-
-        В по-старите версии имаше дефект при използването на масиви
-        като стойности на <parameter>search</parameter> и на <parameter>replace</parameter> едновременно,
-        в следствие на което празните индекси на <parameter>search</parameter>
-        биват прескачани без да се увеличава вътрешния указател на масива
-        <parameter>replace</parameter>.
-        Този дефект е поправен в PHP 4.3.3, така че
-        всички скриптове, които разчитат на него, трябва да премахнат
-        празните стойности за търсене, преди да се извика тази функция с цел
-        да се имитира първоначалното поведение.
-       </entry>
-      </row>
-      <row>
-       <entry>4.0.5</entry>
-       <entry>
-        Голяма част от параметрите вече могат да са масиви.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
-    <title>Пример за <function>str_replace</function></title>
+    <title>Основен пример за <function>str_replace</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -161,18 +120,38 @@

 $newphrase = str_replace($healthy, $yummy, $phrase);

-// Параметърът count е достъпен от PHP 5.0.0
+// Връща: 2
 $str = str_replace("ll", "", "good golly miss molly!", $count);
-echo $count; // 2
++echo $count;
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>Пример за потенциални проблеми с <function>str_replace</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php

 // Последователност на замяната
 $str     = "Line 1\nLine 2\rLine 3\r\nLine 4\n";
 $order   = array("\r\n", "\n", "\r");
 $replace = '<br />';
+
 // Обработва първо знаците \r\n, за да се избегне двойното преобразуване
 $newstr = str_replace($order, $replace, $str);

+// Извежда F защото A е заменен с B, след което B е заменен с C и т.н.
+// Накрая E е заменен с F, поради факта, че замените се извършват от ляво на дясно.
+$search  = array('A', 'B', 'C', 'D', 'E');
+$replace = array('B', 'C', 'D', 'E', 'F');
+$subject = 'A';
+echo str_replace($search, $replace, $subject);
+
 // Извежда: apearpearle pear
+// Поради същата причина, спомената по-горе
 $letters = array('a', 'p');
 $fruit   = array('apple', 'pear');
 $text    = 'a p';
@@ -184,18 +163,26 @@
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.bin-safe;
+  <caution>
+   <title>Потенциални проблеми с реда на замяна</title>
+   <para>
+    Тъй като <function>str_replace</function> заменя от ляво на дясно, може
+    да замени предходно вмъкната стойност, при извършване на множествени замени.
+    Вижте също така примерите в този документ.
+   </para>
+  </caution>
   <note>
-    <para>
-     Функцията е чувствителна към регистъра. Използвайте функция <function>str_ireplace</function>
-     за нечувствителна към регистъра замяна.
-    </para>
-   </note>
+   <para>
+    Функцията е чувствителна към регистъра. Използвайте функция <function>str_ireplace</function>
+    за нечувствителна към регистъра замяна.
+   </para>
+  </note>
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -207,7 +194,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

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