byte_array

Construct a byte array from a hexadecimal string.

Construct a byte_array from a list of integers.

Returns true if this byte_array is empty, false otherwise.

x.empty() is equivalent to x.size() == 0.

Create a byte array from a base-64 string.

Valid base-64 strings may include the characters a-z, A-Z, 0-9, + and / as significant characters, and '=' as padding.

Create a byte array from a hexadecimal string.

The given hexadecimal string must have even length, since two hexadecimal characters encode one byte.

Create a byte_array from a list of integers.

The inverse of byte_array.to_list().

All integers in the passed list are treated as single-byte values, i.e. they must be in the range 0 <= x < 256, and therefore the returned byte_array will be equal in size to the passed list.

Generate a textual representation of this iterable.

An optional separator, prefix and postfix can be provided. One can also provide a limit: integer?. If there are more elements in the result than limit, the elements whose indices exceed limit are omitted, and the passed truncated: text is included instead.

Examples:

• [1, 2, 3].join_to_text() returns '1, 2, 3'.

• [1, 2, 3].join_to_text('_') returns '1_2_3'.

• [1, 2, 3].join_to_text('*', '(', ')') returns '(1*2*3)'.

• list<T>().join_to_text('!', '(', ')') returns '()' (where T is a valid type).

• range(10).join_to_text('', '', '', 5) returns '01234...'.

• range(10).join_to_text('', '', '', 5, 'more') returns '01234more'.

Where the function even is defined:

function even(x: integer): text {
   return if (x % 2 == 0) 'EVEN' else 'ODD';
}

Then:

• range(10).join_to_text('->', '{', '}', 5, '...', even(*)) returns {EVEN->ODD->EVEN->ODD->EVEN->...}.

Returns the number of bytes in this byte_array.

Repeats this byte_array n times.

Examples:

• x'1234abcd'.repeat(3) returns x'1234abcd1234abcd1234abcd'

• x''.repeat(3) returns x''

• x'1234abcd'.repeat(0) returns x''

Returns a reversed copy of this byte_array.

Calculates the SHA-256 digest (hash) of this byte array.

Returns the number of bytes in this byte_array.

Returns a sub-array of this byte array starting from the specified index (inclusive).

Returns a sub-array of this byte array from the specified start index (inclusive) to the specified end index (exclusive).

Returns a base-64 text representation of this byte_array.

Inverse of byte_array.from_base64(text).

Returns a hexadecimal text representation of this byte_array.

Inverse of byte_array.from_hex(text).

Converts this byte_array to a list of integers.

The inverse of byte_array.from_list(list<integer>).

Each byte in the array is converted to a single integer 0 <= x < 256 in the returned list.

Converts this byte_array to a list of integers.

The inverse of byte_array.from_list(list<integer>).

Each byte in the array is converted to a single integer 0 <= x < 256 in the returned list.