# ucwords

(PHP 4, PHP 5, PHP 7)

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

### 说明

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

将 `str` 中每个单词的首字符（如果首字符是字母）转换为大写字母，并返回这个字符串。

这里单词的定义是紧跟在 `delimiters` 参数（默认：空格符、制表符、换行符、回车符、水平线以及竖线）之后的子字符串。

### 参数

`str`

  输入字符串。

`delimiters`

  可选的 `delimiters`，包含了单词分割字符。

### 返回值

返回转换后的字符串。

### 更新日志

版本 | 说明
--- | ---
5.4.32, 5.5.16 | 增加了 `delimiters` 参数。

### 范例

Example #1 ucwords() 范例

    <?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() 自定义 delimiters 的例子

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

    $baz = ucwords($foo, "|");        // Hello|World!
    ?>

### 注释

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

### 参见

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