array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.ucwords.php', 1 => 'ucwords', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funções de String', ), 'prev' => array ( 0 => 'function.ucfirst.php', 1 => 'ucfirst', ), 'next' => array ( 0 => 'function.utf8-decode.php', 1 => 'utf8_decode', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/strings/functions/ucwords.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
ucwords — Converte para maiúsculas o primeiro caractere de cada palavra
Retorna uma string com o primeiro caractere de cada palavra em
string
em maiúscula, se este caractere for uma letra ASCII
entre "a"
(0x61) e "z"
(0x7a).
Nesta função, uma palavra é qualquer sequência de caracteres não listada
no parâmetro separators
. Por padrão, os separadores são:
espaço, tab horizontal, retorno de carro, nova linha, form feed e tab vertical.
Para realizar uma conversão similar em strings multibyte, utilize
mb_convert_case() com a opção MB_CASE_TITLE
.
string
A string de entrada.
separators
O parâmetro opcional separators
contém os caracteres separadores das palavras.
Retorna a string modificada.
Versão | Descrição |
---|---|
8.2.0 | A conversão de maiúsculas e minúsculas não depende mais da localidade definida com setlocale(). Somente caracteres ASCII serão convertidos. |
Exemplo #1 Exemplo da ucwords()
<?php
$foo = 'hello world!';
$foo = ucwords($foo); // Hello World!
$bar = 'HELLO WORLD!';
$bar = ucwords($bar); // HELLO WORLD!
$bar = ucwords(strtolower($bar)); // Hello World!
?>
Exemplo #2 Exemplo de ucwords() com delimitador
<?php
$foo = 'hello|world!';
$bar = ucwords($foo); // Hello|world!
$baz = ucwords($foo, "|"); // Hello|World!
?>
Exemplo #3 Exemplo de ucwords() com delimitadores adicionais
<?php
$foo = "mike o'hara";
$bar = ucwords($foo); // Mike O'hara
$baz = ucwords($foo, " \t\r\n\f\v'"); // Mike O'Hara
?>
Nota: Esta função é compatível com dados binários.