fromhex()

16진수 문자열을 바이너리로 변환하여 반환합니다.

문법

매개변수

HEX_STR

16진수 문자열 또는 식. 대소문자를 모두 허용합니다 (0-9, a-f, A-F).

설명

fromhex() 함수는 16진수 문자열을 바이너리(byte[])로 변환하여 반환합니다. 다음 경우에 null을 반환합니다.

• 인수가 null인 경우
• 인수가 문자열이 아닌 경우
• 문자열 길이가 홀수인 경우 (바이트로 분리할 수 없음)
• 16진수가 아닌 문자가 포함된 경우

숫자 상수나 음수를 직접 인수로 전달하면 쿼리 파싱 시점에 오류가 발생합니다.

오류 코드

사용 예

1. 16진수 문자열을 바이너리로 변환한 뒤 문자열로 디코딩

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

2. 변환 후 다시 16진수로 확인

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

3. 홀수 길이 문자열 입력

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

4. NULL 입력

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

호환성

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