decode()

decode() 함수는 바이트 배열을 지정한 문자 인코딩으로 해석하여 문자열로 반환합니다.

문법

decode(BLOB_EXPR[, CHARSET])

매개변수

BLOB_EXPR
디코딩할 바이너리 타입의 표현식입니다.
CHARSET
문자 인코딩 이름입니다. 생략하면 utf-8을 사용합니다. IANA Charset Registry에 등록된 Preferred MIME Name 또는 Aliases를 사용합니다. 등록된 문자 인코딩 목록은 IANA Charset Registry를 참고하세요.

설명

decode() 함수는 바이너리 타입의 값을 지정한 문자 인코딩으로 해석하여 문자열을 반환합니다.

입력값이 null이거나 바이너리 타입이 아니면 null을 반환합니다.

오류 코드

해당 사항 없음

사용 예

  1. UTF-8로 인코딩된 바이너리를 문자열로 디코딩

    json "{}"
| eval bin = encode("hello, world!"),
       text = decode(bin)
| # text: hello, world!

  2. EUC-KR 인코딩으로 디코딩

    json "{}"
| eval text = decode(euckr_field, "euc-kr")

  3. null 입력

    json "{'bin': null}" | eval text = decode(bin)
| # text: null

호환성

decode() 함수는 소나 4.0 이전 버전부터 제공되었습니다.