ucwords

(PHP 4, PHP 5, PHP 7, PHP 8)

ucwordsPone en mayúscula la primera letra de todas las palabras

Descripción

ucwords(string $string, string $separators = " \t\r\n\f\v"): string

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.

Parámetros

string

La cadena de entrada.

separators

El parámetro opcional separators contiene el carácter de separación.

Valores devueltos

Devuelve la cadena, después de la modificación.

Historial de cambios

Versión Descripción
8.2.0 Case conversion no longer depends on the locale set with setlocale(). Only ASCII characters will be converted.

Ejemplos

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
?>

Notas

Nota: Esta función es segura binariamente.

Ver también