(PHP 4, PHP 5, PHP 7, PHP 8)
ucwords — Wandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings in einen Großbuchstaben um
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.
stringDie Eingabezeichenkette.
separators
Der optionale Parameter separators enthält die
Wort-Trenzeichen.
Gibt die modifizierte Zeichenkette zurück.
| 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. |
Beispiel #1 ucwords()-Beispiel
<?php
$foo = 'hallo welt!';
$foo = ucwords ($foo); // Hallo Welt!
$bar = 'HALLO WELT!';
$bar = ucwords($bar); // HALLO WELT!
$bar = ucwords(strtolower($bar)); // Hallo Welt!
?>
Beispiel #2 ucwords()-Beispiel mit benutzerdefinierten Trenzeichen
<?php
$foo = 'hello|world!';
$bar = ucwords($foo); // Hello|world!
$baz = ucwords($foo, "|"); // Hello|World!
?>
Beispiel #3 ucwords()-Beispiel mit zusätzlichen Trennzeichen
<?php
$foo = "mike o'hara";
$bar = ucwords($foo); // Mike O'hara
$baz = ucwords($foo, " \t\r\n\f\v'"); // Mike O'Hara
?>Hinweis: Diese Funktion ist binärsicher.