ucwords

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

ucwords — 将字符串中每个单词的首字母转换为大写

说明

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

将 string 中每个单词的首字符（如果首字符是介于 "a"（0x61）和 "z"（0x7a）之间的 ASCII 字符）转换为大写字母，并返回这个字符串。

对于此函数，单词是未在 separators 参数列出的字符串。默认情况下，它们是：空格、水平制表符、回车、换行符、换页以及垂直制表符。

要对多字节进行类似的转换，请使用带 MB_CASE_TITLE 模式的 mb_convert_case()。

参数

string: 输入字符串。
separators: 可选的 separators，包含了单词分割符。

返回值

返回转换后的字符串。

更新日志

版本	说明
8.2.0	大小写转换不在依赖于使用 setlocale() 设置的区域。只会转换 ASCII 字符。

示例

示例 #1 ucwords() 示例

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

示例 #2 ucwords() 自定义分隔符的例子

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

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

示例 #3 带附加分隔符的 ucwords() 示例

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

注释

注意: 此函数可安全用于二进制对象。

参见

strtoupper() - 将字符串转化为大写
strtolower() - 将字符串转化为小写
ucfirst() - 将字符串的首字母转换为大写
mb_convert_case() - 对字符串进行大小写转换