# ucwords

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

ucwords — Convierte 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