(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.
string
Die 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!';
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
?>
Hinweis: Diese Funktion ist binärsicher.