정의 및 사용 방법

PHP 버전
8.4+

mb_trim() 함수는 문자열의 양쪽 끝에서 공백 또는 매개변수로 지정된 문자열을 제거합니다.
멀티바이트로된 공백과 문자열도 안전하게 작동합니다.

이 함수는 입력받은 문자열(특히, 다국어) 데이터의 앞뒤에 혹시 모를 공백을 제거하는데 주로 사용됩니다.

특징

  • mb_trim() 함수는 trim() 함수의 멀티바이트 지원 버전입니다.
  • PHP 8.4.0에서 도입된 함수로 PHP 8.4.0 이전의 버전에서는 호환되지 않습니다.

기본 예제

PHP 
/* 문자열의 양쪽 끝에서 공백을 제거 */
$string = '   hello world   ';
$trimmed = mb_trim($string);
var_dump($trimmed); // 출력: string(11) "hello world"

/* 매개변수로 지정된 문자열을 제거 */
$string = 'hello world';
$trimmed = mb_trim($string, 'he');
var_dump($trimmed); // 출력: string(9) "llo world"

/* 주의! 한글과 같은 multi-byte 문자열을 지원함 */
$string = '환영합니다.';
$trimmed = mb_trim($string, '환영');
var_dump($trimmed); // 출력: string(10) "합니다."

구문

PHP 
mb_trim(string $string, ?string $characters = null, ?string $encoding = null): string

매개변수

trim() 함수의 매개변수
$string 필수. 제거할(trim) 문자열입니다.
$characters 옵션. 제거할 문자열입니다. 이 값을 생략하면 다음의 공백 문자(멀티바이트 공백 문자 포함)가 제거됩니다.
  • " ": 공백 문자(Space) - 키보드의 스페이스(Space) 바를 누르면 입력되는 문자입니다.
  • \n: 개행(Newline) - 키보드의 엔터(Enter) 키를 누를 때 줄바꿈하는 문자를 의미합니다.
  • \r: 리턴 (Carriage return) - 줄(Line)의 시작 위치로 커서를 이동시키는 제어 문자를 가리킵니다. 이것은 주로 텍스트에서 줄을 나눌 때 사용되며, 예전에는 프린터 등의 기계에서 실제로 프린트 헤드를 처음 위치로 되돌리는데 사용되었습니다.
  • \t: 탭 (Tab) - 키보드의 탭(Tab) 키를 누르면 입력되는 탭을 의미합니다.
  • \v: 수직 탭 (Vertical tab) - 출력 장치의 수직 탭 위치로 이동하는 제어 문자입니다.
  • \x00: 널 문자 (NUL-byte) - 문자열의 끝을 나타내는 데 사용됩니다.
  • \u00A0: NO-BREAK SPACE (U+00A0) - 단어가 끊어지지 않게 만드는 공백 문자입니다.
  • \u1680: OGHAM SPACE MARK (U+1680) - Ogham 문자 시스템에서 사용되는 특수한 공백입니다.
  • \u2000: EN QUAD (U+2000) - 긴 공백을 나타내는 문자입니다. 인쇄나 레이아웃에서 사용됩니다.
  • \u2001: EM QUAD (U+2001) - 더 넓은 공백을 나타내며, 글자 간격에 영향을 미칩니다.
  • \u2002: EN SPACE (U+2002) - 상대적으로 짧은 공백입니다. 영어 텍스트에서 간격을 조정할 때 사용됩니다.
  • \u2003: EM SPACE (U+2003) - 보다 넓은 공백으로, 더 큰 간격을 생성할 때 사용됩니다.
  • \u2004: THREE-PER-EM SPACE (U+2004) - 고정된 비율로 좁은 공백을 제공합니다.
  • \u2005: FOUR-PER-EM SPACE (U+2005) - 추가적인 좁은 공백을 의미합니다.
  • \u2006: SIX-PER-EM SPACE (U+2006) - 텍스트에서 좁은 공백을 제공합니다.
  • \u2007: FIGURE SPACE (U+2007) - 숫자와 관련된 공간을 제공합니다.
  • \u2008: PUNCTUATION SPACE (U+2008) - 구두점 기호 사이에 위치하는 공백입니다.
  • \u2009: THIN SPACE (U+2009) - 더 얇은 공백을 생성합니다.
  • \u200A: HAIR SPACE (U+200A) - 극히 작은 공백으로, 미세한 간격을 제공합니다.
  • \u2028: LINE SEPARATOR (U+2028) - 줄 구분자를 나타냅니다. 텍스트를 구분하는 데 사용됩니다.
  • \u2029: PARAGRAPH SEPARATOR (U+2029) - 문단을 구분하는 제어 문자입니다.
  • \u202F: NARROW NO-BREAK SPACE (U+202F) - 좁은 공백으로, 단어를 끊지 않게 합니다.
  • \u205F: MEDIUM MATHEMATICAL SPACE (U+205F) - 수학적 기호에서 사용하는 공백입니다.
  • \u3000: IDEOGRAPHIC SPACE (U+3000) - 주로 중국어, 일본어에서 사용하는 공백 문자입니다.
  • \u0085: NEXT LINE (NEL) (U+0085) - 텍스트에서 줄을 바꾸는 제어 문자입니다.
  • \u180E: MONGOLIAN VOWEL SEPARATOR (U+180E) - 몽골어에서 사용하는 구분 문자입니다.
$encoding 옵션. 문자열의 인코딩을 지정합니다.
기본값은 null이며, 생략하거나 null을 전달하면 내부 문자 인코딩 값이 사용됩니다.
  • 내부 문자 인코딩이 표준 인코딩인 'UTF-8'일 경우에는 별도로 지정하지 않아도 됩니다.
  • 내부 인코딩이 다른 값이라면, 일관된 처리 결과를 위해 표준 인코딩인 'UTF-8'을 명시적으로 지정하세요.

반환 값

문자열의 양쪽 끝에서 공백 또는 매개변수로 지정된 문자열을 제거(trim)한 문자열을 반환합니다.

매개변수로 지정된 문자열을 제거

mb_trim() 함수는 $characters에 제거할 문자열을 지정하면 문자열의 양쪽 끝에서 지정된 문자열을 제거할 수 있습니다.
trim()은 이 매개변수의 값으로 한글이나 일본어와 같은 멀티바이트를 지원하지 않지만, mb_trim() 함수는 멀티바이트를 지원합니다.

PHP trim() 함수는 멀티바이트를 지원하지 않습니다. 
/* 주의! 한글과 같은 multi-byte 문자열을 지원하지 않음
   인코딩 문제가 발생 */
$string = '환영합니다.';
$trimmed = trim($string, '환영');
var_dump($trimmed); // 출력: string(9) "��니다."
PHP mb_trim() 함수는 멀티바이트를 지원합니다. 
$string = '환영합니다.';
$trimmed = mb_trim($string, '환영');
var_dump($trimmed); // 출력: string(10) "합니다."

활용 예제

mb_trim() 함수는 주로 입력 받은 문자열의 양쪽 끝의 공백(공백, 탭, 개행 등)을 사전에 필터링(제거)하는데 사용됩니다. 이는 사용자로부터의 입력이나 외부 데이터를 처리할 때, 문자열을 정리하고 데이터의 일관성을 유지하기 위해 자주 사용되는 작업 중 하나입니다.

특히, 입력받은 문자열(특히, 다국어) 데이터의 앞뒤에 혹시 모를 공백을 제거할 때 유용합니다.

다국어 공백이 포함될 수 있는 사용자 이름 입력 처리

PHP 
/* 일반 trim()을 사용했다면 인식하지 못했을 특수한 유니코드 공백(멀티바이트 공백)들까지 
   안전하게 제거하므로, 데이터베이스 저장이나 본인 확인 로직에서 
   발생할 수 있는 잠재적인 오류를 방지합니다. 
*/

$username = mb_trim($_POST['username']); // 사용자 입력에서 양쪽 끝의 공백과 멀티바이트 공백을 제거

if (empty($username)) {
    echo "사용자 이름을 정확히 입력해 주세요.";
} else {
    // 사용자 이름을 데이터베이스에 저장하는 예시
    $query = "INSERT INTO users (username) VALUES ('$username')";
    // 이 후 데이터베이스 쿼리 실행...
}

참고문헌

같이 보기