정의 및 사용 방법

PHP 버전
8.4+

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

특징

  • 문자열의 첫 번째 문자가 알파벳 대문자인 경우 해당 문자를 소문자로 변환합니다.
  • 문자열의 첫 번째 문자가 ASCII 범위를 벗어난 알파벳 대문자(예: Ä, Ð, Ñ, Ý)도 소문자로 변환합니다.
  • mb_lcfirst() 함수는 lcfirst() 함수의 멀티바이트 지원 버전입니다.
  • PHP 8.4.0에서 도입된 함수로 PHP 8.4.0 이전의 버전에서는 호환되지 않습니다.

'ASCII 범위의 알파벳 대문자(A~Z)'는 흔히 말하는 영어 대문자이며, 알파벳 A부터 Z까지 총 26글자(A, B D, 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 
/* PHP 8.4에서 도입된 mb_lcfirst() */

// ASCII 알파벳 문자열의 첫 글자를 소문자로 변환
$original_string = 'Hello, World!';
$mb_lcfirst_string = mb_lcfirst($original_string);
echo $mb_lcfirst_string; // 출력: 'hello, World!'

// ASCII 알파벳을 벗어낫 알파벳 문자열의 첫 글자도 소문자로 변환 
$utf8_string = 'Äpfel und birnen';
$mb_lcfirst_utf8 = mb_lcfirst($utf8_string, 'UTF-8');
echo $mb_lcfirst_utf8; // 출력: 'äpfel und birnen'

멀티바이트를 지원하면서 주어진 문자열을 모두 소문자로 변환하려면 mb_strtolower() 함수를 사용하세요.

구문

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

매개변수

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

반환 값

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

참고문헌

같이 보기