Skip to main content
Version: v1.17.0

hex

Function

hex encode/decode hexadecimal strings

Synopsis

hex(b: bytes) -> string
hex(s: string) -> bytes

Description

The hex function encodes a Zed bytes value b as a hexadecimal string or decodes a hexadecimal string s into a Zed bytes value.

Examples

Encode a simple bytes sequence as a hexadecimal string:

echo '0x0102ff' | zq -z 'yield hex(this)' -

=>

"0102ff"

Decode a simple hex string:

echo '"0102ff"' | zq -z 'yield hex(this)' -

=>

0x0102ff

Encode the bytes of an ASCII string as a hexadecimal string:

echo '"hello, world"' | zq -z 'yield hex(bytes(this))' -

=>

"68656c6c6f2c20776f726c64"

Decode hex string representing ASCII into its string form:

echo '"68656c6c6f20776f726c64"' | zq -z 'yield string(hex(this))' -

=>

"hello world"