(PHP 4, PHP 5, PHP 7)
ucwords — Wandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings in einen Großbuchstaben
$str
[,
string $delimiters
= " \t\r\n\f\v"
] ) : string
Gibt einen String zurück, in dem das erste Zeichen eines jeden Wortes
innerhalb von str
in einen Großbuchstaben
umgewandelt wurde, sofern es sich dabei um Buchstaben handelt.
Als Wort wird hierbei eine Zeichenkette verstanden, die einem
Zeichen, das im delimiters
Parameter enthalten ist folgt.
(Standardmäßig sind dies: Leerzeichen, Seitenvorschub, Zeilenvorschub, Wagenrücklauf
sowie horizontales und vertikales Tabulatorzeichen).
str
Die Eingabezeichenkette.
delimiters
Der optionale delimiters
Parameter enthält die Wort-Trenzeichen.
Gibt die modifizierte Zeichenkette zurück.
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 Locale-abhängig und behandelt Eingaben entsprechend dem aktuell gewählten Locale. Dies funktioniert allerdings nur mit Zeichensätzen, die Zeichen immer als einzelnes Byte kodieren. Werden Zeichenkodierungen verwendet, die abhängig vom zu kodierenden Zeichen unterschiedlich viele Bytes verwenden (die meisten nicht westeuropäischen Sprachen), sollten die multibyte oder intl Extensions verwendet werden.
Hinweis: Diese Funktion ist binary safe.