TO_SINGLE_BYTE 스칼라 함수

TO_SINGLE_BYTE 함수는 동등한 문자가 존재하는 경우 멀티바이트 문자가 동등한 1바이트 문자로 변환되는 문자열을 리턴합니다.

Read syntax diagramSkip visual syntax diagramTO_SINGLE_BYTE(string-expression )

스키마는 SYSIBM입니다.

U+0020에서 U+007E까지의 UTF-8 코드 포인트 범위에서 문자가 나타내는 1바이트 문자에 해당하는 문자만 변환됩니다. 멀티바이트 문자에 해당하는 1바이트 문자가 없는 경우, 변경되지 않은 채로 남아 있습니다.

문자열 표현식
변환되는 문자열을 지정하는 표현식입니다. 표현식은 내장 CHAR 또는 VARCHAR 데이터 유형인 값을 리턴해야 합니다. 유니코드 데이터베이스에서 제공된 인수가 GRAPHIC 또는 VARGRAPHIC 데이터 유형인 경우, 함수를 평가하기 전에 먼저 VARCHAR로 변환됩니다. 표현식은 FOR BIT DATA로 정의되는 문자열일 수 없습니다(SQLSTATE 42815).

결과의 길이 속성, 코드 페이지 및 데이터 유형은 인수의 길이 속성, 코드 페이지 및 데이터 유형과 동일합니다. 인수가 널(NULL)일 수 있으면 결과가 널(NULL)일 수 있습니다. 인수가 널(NULL)인 경우 결과는 널(NULL) 값입니다.

예

전체 너비 UTF-8 문자 'ABC'(16진 형식의 x'efbca1efbca2efbca3')를 동등한 1바이트 문자로 변환하십시오.

   VALUES TO_SINGLE_BYTE(x'efbca1efbca2efbca3')

결과는 값 'ABC'(16진 형식의 x'414243')입니다.