array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.ucwords.php', 1 => 'ucwords', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String Functions', ), 'prev' => array ( 0 => 'function.ucfirst.php', 1 => 'ucfirst', ), 'next' => array ( 0 => 'function.utf8-decode.php', 1 => 'utf8_decode', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/strings/functions/ucwords.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
ucwords — Uppercase the first character of each word in a 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.
string
The input string.
separators
The optional separators
contains the word separator characters.
Returns the modified string.
Version | Description |
---|---|
8.2.0 | Case conversion no longer depends on the locale set with setlocale(). Only ASCII characters will be converted. |
Example #1 ucwords() example
<?php
$foo = 'hello world!';
$foo = ucwords($foo); // Hello World!
$bar = 'HELLO WORLD!';
$bar = ucwords($bar); // HELLO WORLD!
$bar = ucwords(strtolower($bar)); // Hello World!
?>
Example #2 ucwords() example with custom delimiter
<?php
$foo = 'hello|world!';
$bar = ucwords($foo); // Hello|world!
$baz = ucwords($foo, "|"); // Hello|World!
?>
Example #3 ucwords() example with additional delimiters
<?php
$foo = "mike o'hara";
$bar = ucwords($foo); // Mike O'hara
$baz = ucwords($foo, " \t\r\n\f\v'"); // Mike O'Hara
?>
Note: This function is binary-safe.