array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.ucwords.php', 1 => 'ucwords', 2 => 'Wandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings in einen Großbuchstaben um', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String-Funktionen', ), 'prev' => array ( 0 => 'function.ucfirst.php', 1 => 'ucfirst', ), 'next' => array ( 0 => 'function.utf8-decode.php', 1 => 'utf8_decode', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/strings/functions/ucwords.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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

Parameter-Liste

string

Die Eingabezeichenkette.

separators

Der optionale Parameter separators enthält die Wort-Trenzeichen.

Rückgabewerte

Gibt die modifizierte Zeichenkette zurück.

Changelog

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.

Beispiele

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
?>

Anmerkungen

Hinweis: Diese Funktion ist binärsicher.

Siehe auch