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
$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 wurde, sofern es sich dabei um einen Buchstaben handelt.
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.
Parameter-Liste
-
string -
Die Eingabezeichenkette.
-
separators -
Der optionale Parameter
separatorsenthält die Wort-Trenzeichen.
Rückgabewerte
Gibt die modifizierte Zeichenkette zurück.
Beispiele
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
?>
Anmerkungen
Hinweis: Diese Funktion ist Locale-abhängig und behandelt Eingaben entsprechend der 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 Erweiterungen multibyte oder intl verwendet werden.
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
