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

ae                                       Wed, 10 Apr 2019 15:24:09 +0000

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

Log:
Translations by @joelibaceta - https://github.com/phpdocbrbridge/traducao/pull/74

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

Modified: phpdoc/pt_BR/trunk/reference/strings/functions/ucwords.xml
===================================================================
--- phpdoc/pt_BR/trunk/reference/strings/functions/ucwords.xml	2019-04-10 14:31:54 UTC (rev 347174)
+++ phpdoc/pt_BR/trunk/reference/strings/functions/ucwords.xml	2019-04-10 15:24:09 UTC (rev 347175)
@@ -1,6 +1,6 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: n/a Maintainer: fernandoc Status: ready -->
-<refentry xml:id="function.ucwords" xmlns="http://docbook.org/ns/docbook">
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 337118 Maintainer: ae Status: ready --><!-- CREDITS: fernandoc,@joelibaceta,ae -->
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ucwords">
  <refnamediv>
   <refname>ucwords</refname>
   <refpurpose>Converte para maiúsculas o primeiro caractere de cada palavra</refpurpose>
@@ -11,16 +11,18 @@
   <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>
    Retorna uma string com o primeiro caractere de cada palavra em
-   <parameter>str</parameter> em maiúscula, se este caractere fizer
-   parte do alfabeto.
+   <parameter>str</parameter> em maiúscula, se este caractere fizer parte do alfabeto.
   </para>
   <para>
-   A definição de palavra é uma string de caracteres que é precedida
-   de um whitespace (Estes são: space, form-feed, newline, carriage return,
-   horizontal tab, e vertical tab).
+   A definição de uma palavra é uma string de caracteres que é é
+   precedida de qualquer caractere listado no parâmetro delimitadores
+   (Estes são: espaço, space, form-feed, newline, carriage return, horizontal tab, e vertical tab).
   </para>
  </refsect1>

@@ -36,6 +38,14 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>delimiters</parameter></term>
+     <listitem>
+      <para>
+       O parâmetro opcional <parameter>delimiters</parameter> contém os caracteres separadores das palavras.
+      </para>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
@@ -46,6 +56,30 @@
    Retorna a string modificada.
   </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>
+        O parâmetro <parameter>delimiters</parameter> foi adicionado.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>

  <refsect1 role="examples">
   &reftitle.examples;
@@ -66,6 +100,22 @@
     </programlisting>
    </example>
   </para>
+
+  <para>
+   <example>
+    <title>Exemplo de <function>ucwords</function> com delimitador</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$foo = 'hello|world!';
+$bar = ucwords($foo);             // Hello|world!
+
+$baz = ucwords($foo, "|");        // Hello|World!
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
  </refsect1>

  <refsect1 role="notes">
@@ -80,6 +130,7 @@
     <member><function>strtoupper</function></member>
     <member><function>strtolower</function></member>
     <member><function>ucfirst</function></member>
+    <member><function>mb_convert_case</function></member>
    </simplelist>
   </para>
  </refsect1>