PoolByteArray

A pooled of bytes.

An Array specifically designed to hold bytes. Optimized for memory usage, does not fragment the memory. Note that this type is passed by value and not by reference.

• PoolByteArray ( Array from )

Construct a new . Optionally, you can pass in a generic that will be converted.

Append an element at the end of the array (alias of push_back).

• void append_array ( array )

Append a PoolByteArray at the end of this array.

• PoolByteArray compress ( compression_mode=0 )

• PoolByteArray decompress ( buffer_size, int compression_mode=0 )

Returns a new PoolByteArray with the data decompressed. Set to the size of the uncompressed data. Set the compression mode using one of ’s constants.

• String get_string_from_ascii ( )

Returns a copy of the array’s contents as . Fast alternative to get_string_from_utf8 if the content is ASCII-only. Unlike the UTF-8 function this function maps every byte to a character in the array. Multibyte sequences will not be interpreted correctly. For parsing user input always use .

• String get_string_from_utf8 ( )

Returns a copy of the array’s contents as . Slower than get_string_from_ascii but supports UTF-8 encoded data. Use this function if you are unsure about the source of the data. For user input this function should always be preferred.

Insert a new element at a given position in the array. The position must be valid, or at the end of the array (idx == size()).

• void invert ( )

Reverse the order of the elements in the array.

• void push_back ( byte )

• void remove ( int idx )

Remove an element from the array by index.

• void resize ( idx )

Set the size of the array. If the array is grown reserve elements at the end of the array. If the array is shrunk truncate the array to the new size.

• void set ( int idx, byte )

Change the byte at the given index.

Returns the size of the array.

• PoolByteArray subarray ( from, int to )

Returns the slice of the between indices (inclusive) as a new PoolByteArray. Any negative index is considered to be from the end of the array.