ucwords

Uppercase the first character of each word in a string

&reftitle.description; `string` `ucwords` `string` `string` `string` `separators`" \t\r\n\f\v"

Returns a string with the first character of each word in `string` capitalized, if that character is an ASCII character between `"a"` (0x61) and `"z"` (0x7a).

For this function, a word is a string of characters that are not listed in the `separators` parameter. By default, these are: space, horizontal tab, carriage return, newline, form-feed and vertical tab.

To do a similar conversion on multibyte strings, use `mb_convert_case` with the `MB_CASE_TITLE` mode.

&reftitle.parameters;

`string`

- The input string.

`separators`

- The optional `separators` contains the word separator characters.

&reftitle.returnvalues;

Returns the modified string.

&reftitle.changelog;

&Version; | &Description;
&strings.changelog.ascii-case-conversion;

&reftitle.examples;

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

### `ucwords` example with custom delimiter

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

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

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

&reftitle.notes; ¬e.bin-safe;
&reftitle.seealso;

- `strtoupper`
- `strtolower`
- `ucfirst`
- `mb_convert_case`