binary()

문자열을 지정한 문자 집합으로 인코딩한 바이너리로 변환합니다.

문법

encode() 함수도 같은 기능을 제공합니다.

매개변수

STR_EXPR

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

CHARSET

문자열 인코딩에 사용할 문자 집합 이름 (기본값: utf-8). IANA Charset에 등록된 Preferred MIME Name이나 Aliases를 사용합니다. 등록된 문자 집합 목록은 IANA Charset Registry를 참고하세요.

설명

binary() 함수는 문자열을 지정한 문자 집합으로 인코딩하여 바이너리(byte[])로 반환합니다. 인수가 null이면 null을 반환합니다. 문자열이 아닌 값이 전달되면 null을 반환합니다. 배열이나 리스트를 전달하면 각 요소에 대해 재귀적으로 변환을 수행합니다.

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

오류 코드

사용 예

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

   json "{'val': 'hello'}" | eval result = binary(val)
   | # result: 68656c6c6f
   

2. 문자 집합을 명시적으로 지정하여 변환

   json "{'val': 'hello'}" | eval result = binary(val, "us-ascii")
   | # result: 68656c6c6f
   

3. 바이너리를 16진수 문자열로 확인

   json "{'val': 'hello'}" | eval result = tohex(binary(val))
   | # result: "68656c6c6f"
   

4. NULL 입력

   json "{'val': null}" | eval result = binary(val)
   | # result: null
   

호환성

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