ucwords

(PHP 4, PHP 5, PHP 7)

ucwordsWandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings in einen Großbuchstaben

Beschreibung

ucwords ( string $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).

Parameter-Liste

str

Die Eingabezeichenkette.

delimiters

Der optionale delimiters Parameter enthä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 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.

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