Home/ Manual/ strings / functions/ ucwords

ucwords

PHP function Edit on GitHub ✎

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

Uppercase the first character of each word in a string

Description

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

Returns a string with the first character of each word in string capitalized, if that character is an ASCII character between "a" (0x61) and "z" (0x7a).

For this function, a word is a string of characters that are not listed in the separators parameter. By default, these are: space, horizontal tab, carriage return, newline, form-feed and vertical tab.

To do a similar conversion on multibyte strings, use mb_convert_case() with the MB_CASE_TITLE mode.

Parameters

string: The input string.
separators: The optional separators contains the word separator characters.

Return Values

Returns the modified string.

Changelog

Version	Description

Examples

ucwords() example

php

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

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

ucwords() example with custom delimiter

php

<?php
$foo = 'hello|world!';
echo ucwords($foo), PHP_EOL;             // Hello|world!

echo ucwords($foo, "|"), PHP_EOL;        // Hello|World!
?>

ucwords() example with additional delimiters

php

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