# ucwords

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

ucwords — Wandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings in einen Großbuchstaben um

### Beschreibung

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

Gibt einen String zurück, in dem das erste Zeichen eines jeden Wortes innerhalb von `string` in einen Großbuchstaben umgewandelt wird, sofern es ein ASCII-Zeichen im Bereich von `"a"` (0x61) bis `"z"` (0x7a) ist.

Bei dieser Funktion ist ein Wort ein Folge von Zeichen, die nicht im Parameter `separators` aufgeführt sind. Standardmäßig sind dies: Leerzeichen, horizontaler Tabulator, Wagenrücklauf, Zeilenumbruch, Seitenvorschub und vertikaler Tabulator.

Um eine ähnliche Umwandlung bei Multibyte-Zeichenfolgen vorzunehmen, muss die Funktion mb_convert_case() mit dem Modus `MB_CASE_TITLE` verwendet werden.

### Parameter-Liste

`string`

  Die Eingabezeichenkette.

`separators`

  Der optionale Parameter `separators` enthält die Wort-Trenzeichen.

### Rückgabewerte

Gibt die modifizierte Zeichenkette zurück.

### Changelog

Version | Beschreibung
--- | ---
8.2.0 | Die Umwandlung von Groß- und Kleinschreibung hängt nicht mehr von der mit setlocale() eingestellten Locale ab. Es werden nur ASCII-Zeichen umgewandelt.

### Beispiele

Beispiel #1 ucwords()-Beispiel

`<?php
$foo = 'hallo welt!';
echo ucwords($foo), PHP_EOL; // Hallo Welt!
$bar = 'HALLO WELT!';
echo ucwords($bar), PHP_EOL; // HALLO WELT!
echo ucwords(strtolower($bar)), PHP_EOL; // Hallo Welt!
?>`

Beispiel #2 ucwords()-Beispiel mit benutzerdefinierten Trenzeichen

`<?php
$foo = 'hallo|welt!';
echo ucwords($foo), PHP_EOL; // Hallo|welt!
echo ucwords($foo, "|"), PHP_EOL; // Hallo|Welt!
?>`

Beispiel #3 ucwords()-Beispiel mit zusätzlichen Trennzeichen

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

### Anmerkungen

> Hinweis: Diese Funktion ist binärsicher.

### Siehe auch

- strtoupper() - Wandelt alle Zeichen eines Strings in Großbuchstaben um
- strtolower() - Setzt einen String in Kleinbuchstaben um
- ucfirst() - Verwandelt das erste Zeichen eines Strings in einen Großbuchstaben
- mb_convert_case() - Perform case folding on a string

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