mb_strlen() 함수의 정의 및 사용법

mb_strlen() 함수는
주어진 문자열의 길이를 숫자로 반환하는 함수입니다.

mb_strlen() 함수가 반환하는 문자열의 길이는 문자 개수입니다.

이 함수는 strlen() 함수와는 달리 멀티바이트 문자열을 지원하기 때문에 한글의 문자열 길이를 확인하는데 매우 유용합니다.

영어, 숫자 등은 1byte이지만, 한글이나 중국어등은 2byte입니다. 2byte이상의 바이트로 표현되는 것을 "multi-byte(멀티바이트)"라고 합니다.

PHP 
$mb_str = '환영합니다.';
var_dump(mb_strlen($mb_str)); // int(6)

$str_1 = 'abcdef1234';
var_dump(mb_strlen($str_1)); // int(10)

/* 공백도 문자열의 길이에 포함 */
$str_2 = 'abc def';
var_dump(mb_strlen($str_2)); // int(7)

$str_3 = ' abc def ';
var_dump(mb_strlen($str_3)); // int(9)

$str_4 = ' ';
var_dump(mb_strlen($str_4)); // int(1)

/* 빈 문자열 */
$str_5 = '';
var_dump(mb_strlen($str_5)); // int(0)

/* 문자열이 아닌 boolean 타입 */
$str_6 = true;
var_dump(mb_strlen($str_6)); // int(1)

$str_7 = false;
var_dump(mb_strlen($str_7)); // int(0)

/* null */
$str_8 = null;
var_dump(mb_strlen($str_8)); // int(0)

mb_strlen() 함수의 형식은 다음과 같습니다.

구문

PHP 
mb_strlen(string $string, ?string $encoding = null): int

매개변수

mb_strlen() 함수의 매개변수 설명
$string 길이를 측정하는 문자열입니다.
$encoding 옵션. 문자열의 인코딩을 지정합니다.
  • 원하는 경우 인코딩을 지정할 수 있습니다. 이 매개변수를 생략하면 문자열의 인코딩은 내부 설정에 따라 결정됩니다.
  • PHP 8.0.0 버전부터 기본값은 null이며, 이 경우 함수는 내부 설정에 따라 기본 인코딩 값을 사용합니다. PHP 8.0.0 버전 이전에서는 기본값이 내부 설정에 따라 결정되었습니다.
  • 인코딩을 알 수 없는 경우 E_WARNING 수준의 오류가 생성됩니다.

반환 값

문자열의 문자 개수를 정수로 반환합니다. 멀티바이트 문자는 1로 계산됩니다.

주의할 점

mb_strlen() 함수를 사용할 때 매개변수에 따라 반환되는 값이 예상하는 것과는 다르다고 생각할 수 있습니다.

매개변수가 문자열이 아닌 boolean 타입일 경우

mb_strlen() 함수는 문자열이 아닌 부울(boolean) 타입의 매개변수에 대해서도 동작합니다.

  • true는 문자열로 변환했을 때 '1'로, 문자의 개수는 1입니다.
  • false는 문자열로 변환했을 때 빈 문자열('')이므로, 문자의 개수는 0입니다.
PHP 
$str_1 = true;
var_dump(mb_strlen($str_1)); // int(1)

$str_2 = false;
var_dump(mb_strlen($str_2)); // int(0)

매개변수가 문자열이 아닌 null일 경우

mb_strlen() 함수는 문자열이 아닌 null 값의 매개변수에 대해서도 동작합니다.

null은 문자열로 변환했을 때 빈 문자열('')이므로, 문자의 개수는 0입니다.

PHP 
$str = null;
var_dump(mb_strlen($str)); // int(0)

$encoding의 값으로 null 사용 시 주의할 점

$encoding의 값으로 null은 PHP 8.0.0 버전부터 사용이 가능합니다. PHP 8.0.0 버전 이전에는 E_WARNING 수준의 오류가 생성됩니다.

PHP 8.0.0 버전 이전 
$mb_str = '환영합니다.';
var_dump(mb_strlen($mb_str, null));
// Warning: mb_strlen(): Unknown encoding
PHP 8.0.0 버전부터 
$mb_str = '환영합니다.';
var_dump(mb_strlen($mb_str, null)); // int(6)

참고문헌

같이 보기