PHP mb_substitute_character() 함수로 대체 문자 설정하고 확인하는 방법

PHP에서는 mb_substitute_character() 함수를 사용하여 대체 문자(substitution character)를 설정하거나 현재 설정값을 확인할 수 있습니다. 이 함수는 입력 문자 인코딩이 유효하지 않거나, 출력 문자 인코딩에 해당 문자 코드가 존재하지 않을 때 어떤 문자로 대체할지 지정하는 역할을 합니다.

참고: 유효하지 않은 문자는 아무것도 출력하지 않거나, 문자열(string), 또는 정수(int) 값(유니코드 문자 코드 값)으로 대체될 수 있습니다.

문법(Syntax)

string mb_substitute_character($char)

매개변수(Parameters)

이 함수는 하나의 매개변수 $char만 받습니다.

• $char − 유니코드 값을 정수로 지정하거나, 아래 문자열 중 하나를 지정합니다.
  • "none" − 유효하지 않은 문자에 대해 아무것도 출력하지 않습니다.
  • "long" − 출력 시 문자 코드 값을 표시합니다. 예: "U+3000, JIS+7E7E"
  • "entity" − 출력 시 문자 엔티티(character entity) 형태로 반환합니다. 예: "&#x200"

반환값(Return Values)

mb_substitute_character가 설정된 경우 성공 시 true를, 실패 시 false를 반환합니다. 만약 설정되어 있지 않다면 현재 설정값을 그대로 반환합니다.

참고: PHP 8.0부터는 substitute_character에 빈 문자열을 전달하는 것이 더 이상 지원되지 않습니다.

예제(Example)

<?php
    // 유니코드 U+3013으로 대체 문자 설정
    mb_substitute_character(0x3013);

    // 16진수(long) 형식으로 설정
    mb_substitute_character("long");

    // 현재 설정값 출력
    echo mb_substitute_character();
?>

출력 결과(Output)

long