Using PHP's ucwords() Function: Syntax, Parameters, Return Value, and Practical Examples

In PHP, the ucwords() function is a useful string function that converts the first character of each word in a string to uppercase. This article provides a detailed introduction to the usage of ucwords(), including its syntax, parameters, return value, and several practical examples.

ucwords() Function Syntax and Parameters

The syntax of the ucwords() function is as follows:

string ucwords ( string $str [, string $delimiters = " \t
\f\v" ] )

The parameter $str is the input string to be converted, and $delimiters is an optional argument that specifies word delimiters; it defaults to space and other whitespace characters.

ucwords() Function Return Value

The ucwords() function returns the input string with the first letter of each word converted to uppercase.

ucwords() Function Examples

The following examples demonstrate how ucwords() works and its effects:

Example 1: Basic Usage

$str = "hello world";
$result = ucwords($str);
echo $result; // Output: Hello World

Example 2: Specifying Word Delimiters

$str = "hello-world";
$result = ucwords($str, "-");
echo $result; // Output: Hello-World

Example 3: Handling Multiple Words

$str = "hello world, how are you?";
$result = ucwords($str);
echo $result; // Output: Hello World, How Are You?

Example 4: Handling Multi‑Line Text

$str = "hello
world
how
are
you";
$result = ucwords($str);
echo $result; 
// Output:
// Hello
// World
// How
// Are
// You

Application Scenarios for ucwords()

The ucwords() function is useful in many real‑world development situations, such as:

Formatting user input: capitalizing names or titles entered by users for better display.

Processing database query results: formatting string data retrieved from a database to meet presentation requirements.

Automatically generating titles: creating readable titles from keywords in web or app content.

Text‑processing tools: serving as a component of utilities that normalize or format textual data.

Summary

This article has thoroughly introduced the ucwords() function, its syntax, parameters, return value, and several examples, helping readers master this practical string function to improve string handling in PHP development.

PHP Learning Recommendations

Vue3+Laravel8+Uniapp Beginner to Practical Development Course

Vue3+TP6+API Social E‑commerce System Development Tutorial

Swoole From Beginner to Master Course

Workerman+TP6 Real‑time Chat System Limited‑Time Offer