svn: /phpdoc/bg/trunk/reference/strings/functions/ str-getcsv.xml str-word-count.xml strtoupper.xml strtr.xml

Modified: phpdoc/bg/trunk/reference/strings/functions/str-getcsv.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/str-getcsv.xml	2016-01-16 01:39:10 UTC (rev 338515)
+++ phpdoc/bg/trunk/reference/strings/functions/str-getcsv.xml	2016-01-16 17:42:07 UTC (rev 338516)
@@ -1,28 +1,77 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: stanprog Status: ready -->
-<refentry xml:id="function.str-getcsv" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 333317 Maintainer: stanprog Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-getcsv">
  <refnamediv>
   <refname>str_getcsv</refname>
   <refpurpose>
    Прави разбор на CSV низ в масив
   </refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>array</type><methodname>str_getcsv</methodname>
    <methodparam><type>string</type><parameter>input</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>escape</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter><initializer>","</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter><initializer>'"'</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>escape</parameter><initializer>"\\"</initializer></methodparam>
   </methodsynopsis>
   <para>
-   &warn.undocumented.func;
+   Извършва разбор на низ в <acronym>CSV</acronym> формат
+   и връща масив с получените полета от низа.
   </para>
  </refsect1>
-
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>input</parameter></term>
+     <listitem>
+      <para>
+       The string to parse.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>delimiter</parameter></term>
+     <listitem>
+      <para>
+       Set the field delimiter (one character only).
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>enclosure</parameter></term>
+     <listitem>
+      <para>
+       Set the field enclosure character (one character only).
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>escape</parameter></term>
+     <listitem>
+      <para>
+       Set the escape character (one character only). Defaults as a backslash
+       (<literal>\</literal>)
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Връща индексиран масив, съдържащ получените от низа полета.
+  </para>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -31,7 +80,6 @@
    </simplelist>
   </para>
  </refsect1>
-
 </refentry>

 <!-- Keep this comment at the end of the file
@@ -54,3 +102,4 @@
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
+

Modified: phpdoc/bg/trunk/reference/strings/functions/str-word-count.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/str-word-count.xml	2016-01-16 01:39:10 UTC (rev 338515)
+++ phpdoc/bg/trunk/reference/strings/functions/str-word-count.xml	2016-01-16 17:42:07 UTC (rev 338516)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 334762 Maintainer: stanprog Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-word-count">
  <refnamediv>
   <refname>str_word_count</refname>
@@ -18,13 +18,12 @@
   </methodsynopsis>
   <para>
    Изчислява броя на думите в <parameter>string</parameter>.
-   Ако незадължителният параметър <parameter>format</parameter>
-   не е указан, върнатата стойност ще бъде число, показващо броя
-   на думите в низа. Ако параметърът е бил указан, върнатата стойност
-   ще бъде масив, съдържанието на който зависи от
-   параметъра <parameter>format</parameter>. Възможните стойности
-   за параметъра <parameter>format</parameter> и съответните резултати
-   са показани по-долу.
+   Ако незадължителният параметър <parameter>format</parameter> не е указан,
+   върнатата стойност ще бъде число, показващо броя на думите
+   в низа. Ако параметърът е бил указан, върнатата
+   стойност ще бъде масив, съдържанието на който зависи от параметъра
+   <parameter>format</parameter>. Възможните стойности за параметъра
+   <parameter>format</parameter> и съответните резултати са показани по-долу.
   </para>
   <para>
    За нуждите на тази функция, терминът 'дума' е дефиниран като низ, зависим
@@ -49,7 +48,8 @@
      <term><parameter>format</parameter></term>
      <listitem>
       <para>
-       Указва връщаната стойност от тази функция. В момента се поддържат следните стойности:
+       Указва връщаната стойност от тази функция. В момента се поддържат следните
+       стойности:
        <itemizedlist>
         <listitem>
          <simpara>
@@ -86,7 +86,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Връща масив или цяло число, в зависимост от параметъра <parameter>format</parameter>.
+   Връща масив или цяло число, в зависимост от параметъра
+   <parameter>format</parameter>.
   </para>
  </refsect1>

@@ -128,7 +129,7 @@

 print_r(str_word_count($str, 1));
 print_r(str_word_count($str, 2));
-print_r(str_word_count($str, 1, 'aaac3'));
+print_r(str_word_count($str, 1, 'àáãç3'));

 echo str_word_count($str);


Modified: phpdoc/bg/trunk/reference/strings/functions/strtoupper.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/strtoupper.xml	2016-01-16 01:39:10 UTC (rev 338515)
+++ phpdoc/bg/trunk/reference/strings/functions/strtoupper.xml	2016-01-16 17:42:07 UTC (rev 338516)
@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: stanprog Status: ready -->
-<refentry xml:id="function.strtoupper" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 334762 Maintainer: stanprog Status: ready -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtoupper">
  <refnamediv>
   <refname>strtoupper</refname>
   <refpurpose>Преобразува низ в горен регистър</refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -14,15 +14,15 @@
    <methodparam><type>string</type><parameter>string</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Връща <parameter>string</parameter> с преобразувани всички буквени знаци в горен регистър.
+   Връща <parameter>string</parameter> с преобразувани всички буквени знаци
+   в горен регистър.
   </para>
   <para>
-   Забележете, че термина 'буквен' зависи от текущия локал.
-   Например, при "C" локала по подразбиране, символи
-   като umlaut-a (ä) няма да бъдат преобразувани.
+   Забележете, че термина 'буквен' зависи от текущия локал. Например,
+   при "C" локала по подразбиране, символи като umlaut-a (ä) няма да бъдат преобразувани.
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -38,14 +38,14 @@
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    Връща низа преобразуван в горен регистър.
   </para>
  </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -63,12 +63,12 @@
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.bin-safe;
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -80,7 +80,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

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

Modified: phpdoc/bg/trunk/reference/strings/functions/strtr.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/strtr.xml	2016-01-16 01:39:10 UTC (rev 338515)
+++ phpdoc/bg/trunk/reference/strings/functions/strtr.xml	2016-01-16 17:42:07 UTC (rev 338516)
@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 334762 Maintainer: stanprog Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtr" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>strtr</refname>
   <refpurpose>Преобразува определени знаци</refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -14,23 +14,44 @@
    <methodparam><type>string</type><parameter>str</parameter></methodparam>
    <methodparam><type>string</type><parameter>from</parameter></methodparam>
    <methodparam><type>string</type><parameter>to</parameter></methodparam>
-   </methodsynopsis>
-   <methodsynopsis>
-    <type>string</type><methodname>strtr</methodname>
-    <methodparam><type>string</type><parameter>str</parameter></methodparam>
-    <methodparam><type>array</type><parameter>replace_pairs</parameter></methodparam>
-   </methodsynopsis>
+  </methodsynopsis>
+  <methodsynopsis>
+   <type>string</type><methodname>strtr</methodname>
+   <methodparam><type>string</type><parameter>str</parameter></methodparam>
+   <methodparam><type>array</type><parameter>replace_pairs</parameter></methodparam>
+  </methodsynopsis>
   <para>
-   Тази функция връща копие на <parameter>str</parameter>, преобразувайки
-   всички срещания на всеки от знаците от <parameter>from</parameter> в съответният знак от <parameter>to</parameter>.
+   Ако са предадени три аргумента, функцията връща копие на
+   <parameter>str</parameter>, където всички срещания на всеки (едно-байтов)
+   знак от <parameter>from</parameter> е преобразуван в
+   съответния знак от <parameter>to</parameter>, т.е. всяко
+   срещане на <literal>$from[$n]</literal> е заменено с
+   <literal>$to[$n]</literal>, където е <literal>$n</literal> е валидно
+   отместване и в двата аргумента.
   </para>
   <para>
    Ако <parameter>from</parameter> и <parameter>to</parameter> са
    с различни дължини, допълнителните знаци от по-дългия от двата
-   се пренебрегват.
+   се пренебрегват. Дължината на <parameter>str</parameter> ще бъде същата,
+   като дължината на върнатата стойност.
   </para>
+  <para>
+   Ако са предадени два аргумента, вторият трябва да бъде масив (<type>array</type>) във
+   вида <literal>array('from' => 'to', ...)</literal>. Върнатата стойност е
+   променлива от тип <type>string</type> където всички срещания на ключовете на масива са
+   заменени със съответните стойност. Най-дългите ключове ще бъдат обработени първи.
+   След като поднизът е бил заменен, няма да се извършва търсене за неговата стойност
+   отново.
+  </para>
+  <para>
+   В този случай, ключовете и стойностите могат да има различна дължина, при положение, че
+   няма празни ключове. Освен това дължината на върнатата стойност може
+   да бъде различна от тази на <parameter>str</parameter>.
+   Въпреки това, функцията ще бъде най-ефективна когато всички ключове имат
+   еднакъв размер.
+  </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -72,41 +93,21 @@
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Функцията връща копие на <parameter>str</parameter>,
-   преобразувайки всички появи на всеки знак от
-   <parameter>from</parameter> в съответните знаци от
-   <parameter>to</parameter>.
-  </para>
- </refsect1>
-
- <refsect1 role="changelog">
-  &reftitle.changelog;
+   Връща преобразуваният низ.
+  </para>
   <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>4.0.0</entry>
-       <entry>
-        Добавени са незадължителните параметри <parameter>to</parameter> и <parameter>from</parameter>.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
+   Ако <parameter>replace_pairs</parameter> съдържа ключ,
+   който представлява празен низ (<literal>""</literal>),
+   ще бъде върната стойност &false;. Ако <parameter>str</parameter> не е от скаларен тип,
+   няма да бъде преобразуван до низ, ще бъде генерирано предупреждение и ще бъде
+   върната стойността &null;.
   </para>
  </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -115,49 +116,74 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$addr = strtr($addr, "aao", "aao");
+//В този пример strtr() извършва преобразуване байт-по-байт
+//Следователно, предполагаме, че има едно-байтово кодиране:
+$addr = strtr($addr, "äåö", "aao");
 ?>
 ]]>
     </programlisting>
    </example>
   </para>
   <para>
-   <function>strtr</function> може да бъде извикана и само с
-   два аргумента. Ако е извикана с два аргумента, поведението й е
-   следното: <parameter>from</parameter> трябва да бъде масив,
-   който съдържа двойките низ -> низ, които трябва да се заменят в
-   първоначалния низ. <function>strtr</function> винаги ще търси
-   възможно най-дългото съвпадение и НЯМА да прави опит да
-   заменя знаци, които вече е обработил.
+   Следващият пример показва поведението на <function>strtr</function>, когато
+   е извикан само с два аргумента. Обърнете внимание на приоритета на замените
+   (<literal>"h"</literal> не се използва, тъй като има по-дълго съвпадение)
+   и как за заменения текст повече не участва в търсенето.
   </para>
   <example>
    <title>Пример за <function>strtr</function> с два аргумента</title>
-    <programlisting role="php">
+   <programlisting role="php">
 <![CDATA[
 <?php
-$trans = array("hello" => "hi", "hi" => "hello");
+$trans = array("h" => "-", "hello" => "hi", "hi" => "hello");
 echo strtr("hi all, I said hello", $trans);
 ?>
 ]]>
-    </programlisting>
-    &example.outputs;
-    <screen>
+   </programlisting>
+   &example.outputs;
+   <screen>
 <![CDATA[
 hello all, I said hi
 ]]>
-    </screen>
+   </screen>
   </example>
+  <para>
+   Тези два режима имат значителни разлики. При извикването на
+   <function>strtr</function> с три аргумента се заменят байтове,
+   а при извикването с два аргумента могат да бъдат заменени и
+   по-дълги поднизове.
+  </para>
+  <example>
+   <title>Сравняване на поведението на функция <function>strtr</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+echo strtr("baab", "ab", "01"),"\n";
+
+$trans = array("ab" => "01");
+echo strtr("baab", $trans);
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+1001
+ba01
+]]>
+ </screen>
+  </example>
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
+    <member><function>str_replace</function></member>
     <member><function>preg_replace</function></member>
    </simplelist>
   </para>
  </refsect1>
-
 </refentry>

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