UNISTR

Syntax

UNISTR
(
  str  IN text
)
RETURNS text;

---

개요

입력된 텍스트 내의 Unicode escape 시퀀스를 실제 Unicode 문자로 변환하여 반환합니다.

지원하는 escape 형식은 다음과 같습니다.

• \XXXX : 4자리 16진수 형식입니다

• \uXXXX : 4자리 16진수 형식입니다 (앞에 'u' 접두사가 붙음)

• \+XXXXXX : '+' 기호 뒤에 6자리 16진수 형식입니다

• \UXXXXXXXX : 'U' 기호 뒤에 8자리 16진수 형식입니다

함수는 surrogate pair 처리를 통해 올바른 Unicode 코드 포인트로 변환하며, 잘못된 surrogate pair가 감지되면 오류를 발생시킵니다.

'U+0000' 는 유효하지 않은 유니코드 이다. 따라서 다음과 같은 예시는 오류를 발생시킵니다. \0000 , \u0000 , \+000000 , \U00000000

파라미터

파라미터	설명
str	text 타입입니다; 변환할 대상 텍스트입니다. 이 문자열 내의 Unicode escape 시퀀스들이 실제 Unicode 문자로 치환됩니다.

---

예제

-- 4자리 16진수 Unicode escape를 사용한 예제 (예: \0041는 'A'로 변환)
SELECT UNISTR('\0041\0042\0043');
-- 결과: 'ABC'

 unistr 
--------
 ABC
(1 row)

-- 다양한 형식의 escape 시퀀스를 포함한 예제
SELECT UNISTR('\u0041 \+00420042 \U00000041');

  unistr  
----------
 A 䈀42 A
(1 row)


select unistr('\0441\043B\043E\043D');

 unistr 
--------
 слон
(1 row)

select unistr('d\u0061t\U00000061');

 unistr 
--------
 data
(1 row)

-- 잘못된 형식 예제
SELECT unistr('wrong: \db99');
ERROR:  invalid Unicode surrogate pair

SELECT unistr('wrong: \db99\0061');
ERROR:  invalid Unicode surrogate pair

SELECT unistr('wrong: \+00db99\+000061');
ERROR:  invalid Unicode surrogate pair

SELECT unistr('wrong: \+2FFFFF');
ERROR:  invalid Unicode escape value

SELECT unistr('wrong: \udb99\u0061');
ERROR:  invalid Unicode surrogate pair

SELECT unistr('wrong: \U0000db99\U00000061');
ERROR:  invalid Unicode surrogate pair

SELECT unistr('wrong: \U002FFFFF');
ERROR:  invalid Unicode escape value

SELECT unistr('wrong: \0000');
ERROR:  invalid Unicode code point

SELECT unistr('wrong: \u0000');
ERROR:  invalid Unicode code point

SELECT unistr('wrong: \+000000');
ERROR:  invalid Unicode code point

SELECT unistr('wrong: \U00000000');
ERROR:  invalid Unicode code point