Bytes Functions and Operators​

A sequence of bytes representing raw data.

Bytes can be represented as a literal using this syntax: b''.

db> 

select b'Hello, world';

{b'Hello, world'}

db> 

select b'Hello,\x20world\x01';

{b'Hello, world\x01'}

There are also some generic functions that can operate on bytes:

db> 

select contains(b'qwerty', b'42');

{false}

Bytes are rendered as base64-encoded strings in JSON. When you cast a bytes value into JSON, that’s what you’ll get. In order to cast a json value into bytes, it must be a base64-encoded string.

db> 

select <json>b'Hello EdgeDB!';

{"\"SGVsbG8gRWRnZURCIQ==\""}

db> 

select <bytes>to_json("\"SGVsbG8gRWRnZURCIQ==\"");

{b'Hello EdgeDB!'}

Accesses a byte at a given index.

Examples:

db> 

select b'binary \x01\x02\x03\x04 ftw!'[2];

{b'n'}

db> 

select b'binary \x01\x02\x03\x04 ftw!'[8];

{b'\x02'}

Produces a bytes sub-sequence from an existing bytes value.

Examples:

db> 

select b'\x01\x02\x03\x04 ftw!'[2:-1];

{b'\x03\x04 ftw'}

db> 

select b'some bytes'[2:-3];

{b'me by'}

Concatenates two bytes values into one.

db> 

select b'\x01\x02' ++ b'\x03\x04';

{b'\x01\x02\x03\x04'}

Converts a str value to bytes using UTF-8 encoding.

db> 

select to_bytes('テキスト');

{b'\xe3\x83\x86\xe3\x82\xad\xe3\x82\xb9\xe3\x83\x88'}

Returns the specified bit of the bytes value.

When looking for the nth bit, this function will enumerate bits from least to most significant in each byte.

db> 
... 
... 

for n in {0, 1, 2, 3, 4, 5, 6, 7,
          8, 9, 10, 11, 12, 13 ,14, 15}
union bytes_get_bit(b'ab', n);

{1, 0, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 0, 1, 1, 0}

Returns a Base64-encoded str of the bytes value.

db> 

select enc::base64_encode(b'hello');

{'aGVsbG8='}

Returns the bytes of a Base64-encoded str.

Returns an InvalidValueError if input is not valid Base64.

db> 

select enc::base64_decode('aGVsbG8=');

{b'hello'}

db> 

select enc::base64_decode('aGVsbG8');

edgedb error: InvalidValueError: invalid base64 end sequence