정의 및 사용 방법
- PHP 버전
- 4+
ucwords() 함수는
주어진 문자열에서 각 단어의 첫 글자를 대문자로 변환하고 나머지 글자는 그대로 유지하여 반환합니다.
특징
- 이 함수는 문자열에서 각 단어의 첫 번째 문자가 ASCII 범위의 알파벳소문자(a~z)인 경우에만 해당 문자를 대문자로 변환합니다.
- 각 단어의 첫 번째 문자가 ASCII 범위를 벗어난 알파벳 소문자(예: ä, ö, ü, é)인 경우에는 변환되지 않고 그대로 유지됩니다.
'ASCII 범위의 알파벳 소문자(a~z)'는 흔히 말하는 영어 소문자이며, 알파벳 a부터 z까지 총 26글자(a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z)를 의미합니다. ASCII 코드 범위에 배정되어 있습니다.
기본 예제
$original_string_1 = 'hello, world!';
$ucwords_string_1 = ucwords($original_string_1);
echo $ucwords_string_1; // 출력: 'Hello, World!'
$original_string_2 = 'heLLO';
$ucwords_string_2 = ucwords($original_string_2);
echo $ucwords_string_2; // 출력: 'HeLLO'
구문
ucwords(string $string, string $separators = " \t\r\n\f\v"): string
매개변수
$string |
필수. 주어진 문자열입니다. |
|---|---|
$separators |
옵션. 단어를 구분할 구분자 문자열입니다. 공백( )이나 기타 문자, 이스케이프 시퀀스를 문자열로 나열할 수 있습니다. 이 함수에서 '단어'는 이 매개변수에 나열되지 않은 문자열을 의미합니다.
기본값은 " \t\r\n\f\v"이며, 나열되어 있는 공백( ), 탭(\t), 캐리지 리턴(\r), 개행(\n), 폼 피드(\f), 수직 탭(\v)이 아닌 문자열을 단어로 취급합니다. |
$separators(단어를 구분할 구분자 문자열) 지정 예제
$text = "apple|banana|cherry";
echo ucwords($text, "|");
// 출력: Apple|Banana|Cherry
반환 값
주어진 문자열에서 각 단어의 첫 문자(ASCII 범위의 알파벳 소문자)를 대문자로 변환하고 나머지는 그대로 유지한 새로운 문자열을 반환합니다.
반환만 하기 때문에 주어진 원본 문자열은 변경되지 않습니다.
변경 이력
| 버전 | 설명 |
|---|---|
| 8.2.0 | PHP 8.2.0 이전에는 setlocale() 설정에 따라 일부 문자의 대소문자 변환이 달라질 수 있었습니다. PHP 8.2.0부터는 오직 ASCII 문자만 변환되며, 멀티바이트 문자는 변환되지 않습니다. |
주의할 점
ucwords() 함수를 사용할 때에는 다음의 내용을 참고하세요.
다국어 지원 문제
ucwords() 함수는 기본적으로 ASCII 문자를 처리합니다. 그래서 영어를 비롯한 일부 언어에서는 제대로 동작하지만, ASCII 범위를 벗어난 독일어의 ä 같은 문자열에서는 예상과 다른 결과가 나올 수 있습니다.
$utf8_string = 'äpfel und birnen';
echo ucwords($utf8_string); // 예상과 다른 결과
// 출력: äpfel Und Birnen
원본 문자열 변경 없음
ucwords() 함수는 입력된 문자열을 직접 변경하지 않고, 변환된 새로운 문자열을 반환합니다. 따라서 원본 문자열을 변경하고 싶다면, 반환된 값을 다시 변수에 할당해야 합니다.
$text = 'hello, world!';
ucwords($text);
echo $text; // 출력: 'hello, world!' (원본 문자열은 변경되지 않음)
$text = ucwords($text);
echo $text; // 출력: 'Hello, World!'
참고문헌
같이 보기
- PHP ucfirst() 함수 – 문자열의 첫 번째 문자를 대문자로 변환
- PHP mb_ucfirst() 함수 – ucfirst()의 멀티바이트 지원 버전
- PHP strtoupper() 함수 – 문자열을 대문자로 변환
- PHP mb_strtoupper() 함수 – strtoupper()의 멀티바이트 지원 버전
- PHP lcfirst() 함수 – 문자열의 첫 번째 문자를 소문자로 변환
- PHP mb_lcfirst() 함수 – lcfirst()의 멀티바이트 지원 버전
- PHP strtolower() 함수 – 문자열을 소문자로 변환
- PHP mb_strtolower() 함수 – strtolower()의 멀티바이트 지원 버전
- CSS text-transform 속성 – 텍스트의 대소문자를 변환