tohex()

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

문법

tohex(BLOB_EXPR)

매개변수

BLOB_EXPR
16진수 문자열로 변환할 바이너리 값 또는 식.

설명

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

변환 결과는 항상 소문자(0-9, a-f)를 사용하며, 각 바이트는 두 자리 16진수로 표현됩니다.

오류 코드

해당 사항 없음

사용 예

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

    json "{'val': 'hello'}" | eval result = tohex(binary(val))
    | # result: "68656c6c6f"
    
  2. 바이너리가 아닌 값 입력

    json "{'val': 1234}" | eval result = tohex(val)
    | # result: null
    
  3. NULL 입력

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

호환성

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