array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.ucwords.php', 1 => 'ucwords', 2 => 'Pone en mayúscula la primera letra de todas las palabras', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funciones de strings', ), 'prev' => array ( 0 => 'function.ucfirst.php', 1 => 'ucfirst', ), 'next' => array ( 0 => 'function.utf8-decode.php', 1 => 'utf8_decode', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/strings/functions/ucwords.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ucwords

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

ucwords — Pone 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 La conversión de la casilla ya no depende de la configuración local definida con setlocale(). Solo se convertirán los caracteres ASCII.

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 para sistemas binarios.

Ver también