大网数据广告活动
PHP 语言与运行手册

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

· 52CE 我爱测

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

ucwords

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

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

说明

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

注释

注意:

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

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。