Loader

ucwords

Returns a string with the first character of each word in string capitalized, if that character is alphabetic. Test ucwords online.

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

The optional delimiters contains the word separator characters.

PHP Documentation by the PHP Documentation Group

ucwords

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

ucwordsUppercase 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 alphabetic.

The definition of a word is any string of characters that is immediately after any character listed in the separators parameter (By default these are: space, form-feed, newline, carriage return, horizontal tab, and vertical tab).

Parameters

string

The input string.

separators

The optional separators contains the word separator characters.

Return Values

Returns the modified string.

Examples

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

Notes

Note: This function is locale-aware and will handle input according to the currently set locale. However, it only works on single-byte character sets. If you need to use multibyte characters (most non-western-European languages) look at the multibyte or intl extensions instead.

Note: This function is binary-safe.

See Also

PHP Documentation

Copyright © 1997 - 2016 by the PHP Documentation Group. This material may be distributed only subject to the terms and conditions set forth in the Creative Commons Attribution 3.0 License or later. A copy of the Creative Commons Attribution 3.0 license is distributed with this manual. The latest version is presently available at » http://creativecommons.org/licenses/by/3.0/.