정의 및 사용 방법

PHP 버전
8.4+

mb_ucfirst() 함수는 주어진 문자열의 첫 문자를 대문자로 변환하고 나머지는 그대로 유지해서 반환합니다.
멀티바이트로된 문자열도 지원합니다.

특징

  • 문자열의 첫 번째 문자가 알파벳 소문자인 경우 해당 문자를 대문자로 변환합니다.
  • 이 함수는 ASCII 범위의 알파벳 소문자(a~z)와 ASCII 범위를 벗어난 알파벳 소문자(예: ä, ö, ü, é)도 대문자로 변환합니다.
  • mb_ucfirst() 함수는 ucfirst() 함수의 멀티바이트 지원 버전입니다.
  • PHP 8.4.0에서 도입된 함수로 PHP 8.4.0 이전의 버전에서는 호환되지 않습니다.

'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 코드 범위에 배정되어 있습니다.

기본 예제

PHP 
/* 일반 ASCII 알파벳 문자열의 첫 글자를 대문자로 변환 */
$original_string = 'hello, world!';
$capitalized_string = mb_ucfirst($original_string);
echo $capitalized_string; // 출력: 'Hello, world!'

/* 멀티바이트 문자를 포함한 문자열의 첫 글자를 대문자로 변환 */
$utf8_string = 'äpfel und birnen';
$capitalized_utf8 = mb_ucfirst($utf8_string, 'UTF-8');
echo $capitalized_utf8; // 출력: 'Äpfel und birnen'

구문

PHP 
mb_ucfirst(string $string, ?string $encoding = null): string

매개변수

mb_ucfirst() 함수의 매개변수
$string 주어진 문자열입니다.
$encoding 옵션. 문자열의 인코딩을 지정합니다.
기본값은 null이며, 생략하거나 null을 전달하면 내부 문자 인코딩 값이 사용됩니다.
  • 내부 문자 인코딩이 표준 인코딩인 'UTF-8'일 경우에는 별도로 지정하지 않아도 됩니다.
  • 내부 인코딩이 다른 값이라면, 일관된 처리 결과를 위해 표준 인코딩인 'UTF-8'을 명시적으로 지정하세요.

반환 값

주어진 문자열의 첫 문자(ASCII와 비 ASCII를 포함한 모든 알파벳 소문자)를 대문자로 변환하고 나머지는 그대로 유지한 새로운 문자열을 반환합니다.
반환만 하기 때문에 주어진 원본 문자열은 변경되지 않습니다.

참고문헌

같이 보기