(PHP 4, PHP 5, PHP 7, PHP 8)
ucwords — Pone en mayúscula la primera letra de todas las palabras
Devuelve la cadena string
después de poner en
mayúscula la primera letra de todas las palabras, si este carácter es
un carácter ASCII entre "a"
(0x61) y
"z"
(0x7a).
En el contexto de esta función, una palabra es cualquier secuencia de caracteres
que no están listados en el parámetro separators
.
Por omisión, estos son: un espacio, un salto de línea, una nueva línea,
un retorno de carro, un salto de página, una tabulación horizontal y una tabulación vertical.
Para realizar una conversión similar en cadenas multiocteto, utilice
mb_convert_case() con el modo
MB_CASE_TITLE
.
string
La cadena de entrada.
separators
El parámetro opcional separators
contiene el carácter
de separación.
Devuelve la cadena, después de la modificación.
Versión | Descripción |
---|---|
8.2.0 | Case conversion no longer depends on the locale set with setlocale(). Only ASCII characters will be converted. |
Ejemplo #1 Ejemplo con ucwords()
<?php
$foo = 'bonjour tout le monde!';
echo ucwords($foo), PHP_EOL; // Bonjour Tout Le Monde!
$bar = 'BONJOUR TOUT LE MONDE!';
echo ucwords($bar), PHP_EOL; // BONJOUR TOUT LE MONDE!
echo ucwords(strtolower($bar)), PHP_EOL; // Bonjour Tout Le Monde!
?>
Ejemplo #2 Ejemplo con ucwords() y un separador personalizado
<?php
$foo = 'hello|world!';
echo ucwords($foo), PHP_EOL; // Hello|world!
echo ucwords($foo, "|"), PHP_EOL; // Hello|World!
?>
Ejemplo #3 Ejemplo de ucwords() con separadores adicionales
<?php
$foo = "mike o'hara";
echo ucwords($foo), PHP_EOL; // Mike O'hara
echo ucwords($foo, " \t\r\n\f\v'"), PHP_EOL; // Mike O'Hara
?>
Nota: Esta función es segura binariamente.