ucwords

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

ucwordsConvierte a mayúsculas el primer caracter de cada palabra de una cadena

Descripción

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

Devuelve una cadena con la primera letra de cada palabra de str convertida a mayúsculas, si el caracter es alfanumérico.

La definición de una palabra es una cadena de caracteres que está inmediatamente después de cualquier carácter enumerado en el parámetro delimiters (Por defecto son: espacio, avance de página, nueva línea, retorno de carro, tabulación horizonal y tabulación vertical).

Parámetros

str

La cadena de entrada.

delimiters

El parámetro opcional delimiters contiene los caracteres separadores de palabras.

Valores devueltos

Devuelve la cadena modificada.

Historial de cambios

Versión Descripción
5.4.32, 5.5.16 Se añadió el parámetro delimiters.

Ejemplos

Ejemplo #1 Ejemplo de ucwords()

<?php
$foo 
'hello world!';
$foo ucwords($foo);             // Hello World!

$bar 'HELLO WORLD!';
$bar ucwords($bar);             // HELLO WORLD!
$bar ucwords(strtolower($bar)); // Hello World!
?>

Ejemplo #2 Ejemplo de ucwords() con delimitadores personalizados

<?php
$foo 
'hello|world!';
$bar ucwords($foo);             // Hello|world!

$baz ucwords($foo"|");        // Hello|World!
?>

Notas

Nota: Esta función es segura binariamente.

Ver también

  • strtoupper() - Convierte un string a mayúsculas
  • strtolower() - Convierte un string a minúsculas
  • ucfirst() - Convierte el primer caracter de una cadena a mayúsculas
  • mb_convert_case() - Realiza una conversión a mayúsculas/minúsculas de un string