TO_MULTI_BYTE 스칼라 함수

TO_MULTI_BYTE 함수는 string-expression의 단일 바이트 문자가 다중 바이트(전체 너비)에 해당하는 문자로 변환되는 유니코드 문자열을 리턴합니다.

Read syntax diagramSkip visual syntax diagram TO_MULTI_BYTE ( string-expression )

스키마는 SYSIBM입니다.

문자열 표현식
내장 문자열의 값을 리턴하는 표현식입니다.
문자열은 비트 데이터가 아니어야 합니다.
인수는 숫자 데이터 유형일 수도 있습니다.
숫자 인수는 내재적으로 VARCHAR 데이터 유형으로 캐스트됩니다.

결과

함수의 결과는 VARCHAR입니다.

결과 문자열 단위는 문자열 표현식과 동일합니다.

결과 길이 속성은 다음과 같이 문자열 단위에 따라 다릅니다.
  • 문자열 단위가 OCTETS인 경우 결과 길이 속성은 string-expression 길이 속성의 최소 3배이며 결과 데이터 유형의 최대 길이입니다.
  • 그렇지 않은 경우 결과 길이 속성은 string-expression과 동일합니다.

결과 문자열의 실제 길이가 리턴 유형의 최대값을 초과하면 오류가 발생합니다(SQLSTATE 54006).

인수가 널(NULL)일 수 있으면 결과가 널(NULL)일 수 있습니다. 인수가 널(NULL)인 경우 결과는 널(NULL) 값입니다.

예

다음 예에서 쿼리는 원래의 단일 바이트 문자열 'ABC', 해당하는 전체 너비 및 해당하는 전체 너비의 16진수 표현을 리턴합니다.

SELECT S, TO_MULTI_BYTE(S) MB, HEX(TO_MULTI_BYTE(S)) HEX
FROM (VALUES 'ABC') T(S)
S   MB        HEX

------------------------------
ABC ＡＢＣEFBCA1EFBCA2EFBCA3

1 record(s) selected.