encode()

encode() 함수는 문자열을 지정한 문자 인코딩으로 변환하여 바이너리로 반환합니다.

문법

매개변수

STR_EXPR

바이너리로 변환할 문자열 또는 식입니다. 배열을 전달하면 각 요소를 개별적으로 변환합니다.

CHARSET

문자 인코딩 이름입니다. 생략하면 utf-8을 사용합니다. IANA Charset Registry에 등록된 Preferred MIME Name 또는 Aliases를 사용합니다. 등록된 문자 인코딩 목록은 IANA Charset Registry를 참고하세요.

설명

encode() 함수는 문자열을 지정한 문자 인코딩으로 변환하여 바이너리(byte[])로 반환합니다.

입력값이 null이거나 문자열이 아닌 값이 전달되면 null을 반환합니다. 배열이나 리스트를 전달하면 각 요소에 대해 재귀적으로 변환을 수행합니다.

지원하지 않는 문자 인코딩 이름을 지정하면 쿼리 파싱 시점에 오류가 발생합니다.

오류 코드

사용 예

1. 문자열을 UTF-8 바이너리로 변환

   json "{'val': 'hello, world!'}" | eval bin = encode(val)
   | # bin: 68656c6c6f2c20776f726c6421
   

2. 문자 인코딩을 지정하여 변환

   json "{'val': 'hello'}" | eval bin = encode(val, "euc-kr")
   

3. null 입력

   json "{'val': null}" | eval bin = encode(val)
   | # bin: null
   

호환성

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