Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
PoolByteArray¶
A pooled Array of bytes.
Descripción¶
An Array specifically designed to hold bytes. Optimized for memory usage, does not fragment the memory.
Note: This type is passed by value and not by reference.
Métodos¶
PoolByteArray ( Array from ) |
|
void |
|
void |
append_array ( PoolByteArray array ) |
decompress ( int buffer_size, int compression_mode=0 ) |
|
decompress_dynamic ( int max_output_size, int compression_mode=0 ) |
|
empty ( ) |
|
hex_encode ( ) |
|
void |
invert ( ) |
void |
|
void |
|
void |
|
void |
|
size ( ) |
|
Descripciones de Métodos¶
PoolByteArray PoolByteArray ( Array from )
Constructs a new PoolByteArray
. Optionally, you can pass in a generic Array that will be converted.
void append ( int byte )
Concatena un elemento al final del array (alias de push_back).
void append_array ( PoolByteArray array )
Appends a PoolByteArray
at the end of this array.
PoolByteArray compress ( int compression_mode=0 )
Returns a new PoolByteArray
with the data compressed. Set the compression mode using one of CompressionMode's constants.
PoolByteArray decompress ( int buffer_size, int compression_mode=0 )
Returns a new PoolByteArray
with the data decompressed. Set buffer_size
to the size of the uncompressed data. Set the compression mode using one of CompressionMode's constants.
PoolByteArray decompress_dynamic ( int max_output_size, int compression_mode=0 )
Returns a new PoolByteArray
with the data decompressed. Set the compression mode using one of CompressionMode's constants. This method only accepts gzip and deflate compression modes.
This method is potentially slower than decompress
, as it may have to re-allocate it's output buffer multiple times while decompressing, where as decompress
knows it's output buffer size from the begining.
GZIP has a maximal compression ratio of 1032:1, meaning it's very possible for a small compressed payload to decompress to a potentially very large output. To guard against this, you may provide a maximum size this function is allowed to allocate in bytes via max_output_size
. Passing -1 will allow for unbounded output. If any positive value is passed, and the decompression exceeds that ammount in bytes, then an error will be returned.
bool empty ( )
Devuelve true
si el array es vacio.
String get_string_from_ascii ( )
Devuelve una copia del contenido del array como String. Alternativa rápida al get_string_from_utf8 si el contenido es sólo ASCII. A diferencia de la función UTF-8, esta función asigna cada byte a un carácter del array. Las secuencias multibyte no se interpretarán correctamente. Para analizar la entrada del usuario siempre usa get_string_from_utf8.
String get_string_from_utf8 ( )
Devuelve una copia del contenido del array como String. Más lento que get_string_from_ascii pero soporta datos codificados en UTF-8. Utiliza esta función si no estás seguro de la fuente de los datos. Para la entrada del usuario esta función siempre debe ser preferida.
String hex_encode ( )
Returns a hexadecimal representation of this array as a String.
var array = PoolByteArray([11, 46, 255])
print(array.hex_encode()) # Prints: 0b2eff
Inserta un nuevo elemento en una posición determinada del array. La posición debe ser válida, o al final del array (idx == size()
).
void invert ( )
Invierte el orden de los elementos en el array.
void push_back ( int byte )
Concatena un elemen al final del array.
void remove ( int idx )
Elimina un elemento del array por indice.
void resize ( int idx )
Sets the size of the array. If the array is grown, reserves elements at the end of the array. If the array is shrunk, truncates the array to the new size.
Note: Added elements are not automatically initialized to 0 and will contain garbage, i.e. indeterminate values.
Cambia el byte en el índice dado.
int size ( )
Devuelve el tamaño del array.
PoolByteArray subarray ( int from, int to )
Returns the slice of the PoolByteArray
between indices (inclusive) as a new PoolByteArray
. Any negative index is considered to be from the end of the array.