# 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() - 对字符串进行大小写转换

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open