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

stanprog                                 Fri, 25 Dec 2015 18:38:03 +0000

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

Log:
sync to EN

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

Modified: phpdoc/bg/trunk/reference/strings/functions/ucwords.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/ucwords.xml	2015-12-25 18:25:48 UTC (rev 338358)
+++ phpdoc/bg/trunk/reference/strings/functions/ucwords.xml	2015-12-25 18:38:03 UTC (rev 338359)
@@ -1,29 +1,33 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 337118 Maintainer: stanprog Status: ready -->
+<!-- Reviewed: yes Maintainer: stanprog -->
 <refentry xml:id="function.ucwords" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>ucwords</refname>
   <refpurpose>Преобразува първия знак на всяка дума в горен регистър</refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>ucwords</methodname>
    <methodparam><type>string</type><parameter>str</parameter></methodparam>
+   <methodparam choice="opt">
+    <type>string</type><parameter>delimiters</parameter><initializer>" \t\r\n\f\v"</initializer>
+   </methodparam>
   </methodsynopsis>
   <para>
    Връща низ <parameter>str</parameter> с преобразувани първите знаци
    на всяка дума в горен регистър, ако знаците са буквени.
   </para>
   <para>
-   Под дума се разбира всеки низ от знаци, който се намира непосредствено след празно  пространство
-   (Това включва: интервал, символ за нов ред, символ за връщане на каретката, хоризонтална
-   и вертикална табулация).
+   Под дума се разбира всеки низ от знаци, който се намира непосредствено
+   след който и да е знак указан чрез параметъра <parameter>delimiters</parameter>
+   (По подразбиране това са: интервал, символ за нов ред, символ за връщане на каретката, хоризонтална и вертикална табулация).
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -36,17 +40,49 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>delimiters</parameter></term>
+     <listitem>
+      <para>
+       Незадължителният параметър <parameter>delimiters</parameter> съдържа знаците използвани за разделители на думи.
+      </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.4.32, 5.5.16</entry>
+       <entry>
+        Добавен е параметъра <parameter>delimiters</parameter>.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -55,24 +91,40 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$foo = 'hello world!';
-$foo = ucwords($foo);             // Hello World!
+$foo = 'здравей свят!';
+$foo = ucwords($foo);             // Здравей Свят!

-$bar = 'HELLO WORLD!';
-$bar = ucwords($bar);             // HELLO WORLD!
-$bar = ucwords(strtolower($bar)); // Hello World!
+$bar = 'ЗДРАВЕЙ СВЯТ!';
+$bar = ucwords($bar);             // ЗДРАВЕЙ СВЯТ!
+$bar = ucwords(strtolower($bar)); // Здравей Свят!
 ?>
 ]]>
     </programlisting>
    </example>
   </para>
+
+  <para>
+   <example>
+    <title>Пример за <function>ucwords</function> с разделител</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$foo = 'здравей|свят!';
+$bar = ucwords($foo);             // Здравей|свят!
+
+$baz = ucwords($foo, "|");        // Здравей|Свят!
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.bin-safe;
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -84,7 +136,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

 <!-- Keep this comment at the end of the file
@@ -106,4 +158,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