VByteArray
Última actualización
Última actualización
Esta clase proporciona un array de bytes. En JavaScript es más conveniente utilizar esta clase que usar la clase String, salvo para aquellos casos en los que tengamos que trabajar con caracteres no ASCII ni Latin-1. El uso de array de bytes ayuda a mejorar el uso de la memoria y el manejo de datos binarios. Un bytearray siempre termina con el caracter terminador \0.
Si convertimos un string en un byte array, la longitud del byte array será la del string más uno ya que en el byte array se añade el carácter nulo "\0" de terminación de cadena. Por ejemplo el string "buenas" tiene una longitud de 6, si lo convertimos en un byte array quedaría así ('b','u','e','n','a','s','\0') con una longitud de 7.
Esta clase se ha incorporado al API en la versión 7.15.
Constructor
De contenido
De compresión
De conversión
De cadena
De comparación
Devuelve el número de bytes que contiene el bytearray.
Crea un nuevo objeto de la clase VByteArray con el tamaño especificado.
Parámetros:
nSize: Tamaño en número de bytes que tendrá el bytearray al ser creado.
Crear un nuevo objeto de la clase VByteArray vacío.
Añade el buffer del byte array pasado en el parámetro al final de byte array sobre el que se aplica la función.
Esta función devuelve una referencia a si mismo, es decir el mismo byte array tras aplicarle la función.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer será añadido.
Ejemplo:
Elimina el número de bytes especificados en el parámetro del final del buffer del byte array.
Si el número de bytes especificados en el parámetro es mayor que el tamaño del buffer, deja el byte array vacío.
Esta función no devuelve un nuevo byte array sino que aplica los cambios directamente sobre el byte array origen de la función.
Parámetros:
n: Número que indica el número de bytes a eliminar.
Ejemplo:
Limpia el contenido del byte array y lo deja vacío.
Cambiar cada byte del array al caracter especificado en el parámetro. Si el tamaño es diferente de -1 (valor por defecto), el byte array es redimensionado al número de bytes especificado. Si no se especifica tamaño, se cambiarán todos los bytes existentes en el array.
Esta función devuelve una referencia a si mismo, es decir el mismo byte array tras aplicarle la función.
Parámetros:
ch: Caracter a aplicar en cada byte del array.
nSize: Número de bytes del array en los que se sustituirá el valor. Es opcional si no se indica se aplica a todos los bytes del array.
Ejemplo:
Devuelve una copia del array decodificado de base64. No se verifica que el buffer sea válido. Los caracteres no válidos se omitirán continuando el proceso con los caracteres restantes.
Esta función devuelve una referencia a si mismo, es decir el mismo byte array tras aplicarle la función.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer contiene el buffer codificado en base64.
Ejemplo:
Devuelve una copia del array decodificado de hexadecimal. No se verifica que el buffer sea válido. Los caracteres no válidos se omitirán continuando el proceso con los caracteres restantes.
Esta función devuelve una referencia a si mismo, es decir el mismo byte array tras aplicarle la función.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer contiene el buffer codificado en base64.
Ejemplo:
Inserta el buffer del byte array pasado en el parámetro en la posición indicada del byte array sobre el que se aplica la función. La primera posición es la 0.
Esta función devuelve una referencia a si mismo, es decir el mismo byte array tras aplicarle la función.
Parámetros:
nPos: Número que indica la posición en la que se insertarán los caracteres. La primera posición es la 0.
other: Objeto de la clase VByteArray cuyo buffer será insertado.
Ejemplo:
Añade el buffer del byte array pasado en el parámetro antes del contenido del byte array sobre el que se aplica la función.
Esta función devuelve una referencia a si mismo, es decir el mismo byte array tras aplicarle la función.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer será añadido.
Ejemplo:
Elimina del byte array a partir de la posición indicada en el parámetro el número de bytes especificados en el parámetro longitud. La primera posición es la 0.
Esta función devuelve una referencia a si mismo, es decir el mismo byte array tras aplicarle la función.
Parámetros:
nPos: Número que indica la posición en la que se eliminarán los caracteres. La primera posición es la 0.
nLen: Número que indica los bytes a eliminar.
Ejemplo:
Reemplaza en el byte array los bytes a partir de la posición indicada en el parámetro el número de bytes especificados en el parámetro longitud con el buffer indicado en el tercer parámetro. La primera posición es la 0.
Esta función devuelve una referencia a si mismo, es decir el mismo byte array tras aplicarle la función.
Parámetros:
nPos: Número que indica la posición en la que se eliminarán los caracteres. La primera posición es la 0.
nLen: Número que indica los bytes a eliminar.
baSustituto: Objeto de la clase VByteArray cuyo buffer será el sustituto de los bytes eliminados.
Ejemplo:
Fija el tamaño del byte array al número de bytes especificados en el parámetro.
Si el nuevo tamaño es mayor que el tamaño actual, los bytes se añaden al final. Los nuevos bytes no son inicializados.
Si el nuevo tamaño es menor que el tamaño actual, los bytes sobrantes desde el nuevo tamaño hasta el final serán eliminados.
Esta función no devuelve un nuevo byte array sino que aplica los cambios directamente sobre el byte array origen de la función.
Sustituye el contenido del byte array por los caracteres de la cadena especifica en el parámetro.
Parámetros:
szText: Cadena cuyo contenido será incluido en el buffer del byte array.
Trunca el contenido del byte array a partir de la posición indicada en el parámetro.
Si la posición especificada es mayor que la longitud del array, no sucede nada.
Parámetros:
nPos: Posición a partir de la que se trunca el buffer del byte array. La primera posición es la 0.
Ejemplo:
Devuelve el contenido original del buffer del byte array, sin conversión.
Esta función devuelve una referencia a si mismo, es decir el mismo byte array tras aplicarle la función.
Comprime los datos de un objeto de la clase VByteArray y nos devuelve un nuevo objeto de la clase VByteArray con los datos comprimidos.
Los valores van de 0 (no compresión) a 9 (máxima compresión). El valor por defecto es -1 que indica que se aplicará la compresión por defecto. Hay que tener en cuenta que cuando mayor compresión configuremos más lento es el proceso y viceversa cuando menor nivel de compresión más rapidez de ejecución.
Parámetros:
nCompressionLevel: Número que indica el nivel de compresión.
A partir de un objeto VByteArray comprimido nos devuelve otro objeto de la clase VByteArray con el contenido descomprimido.
Devuelve una copia del byte array, codificada a Base64.
Devuelve una copia del byte array, codificada en hexadecimal.
Devuelve un string con el contenido del byte array codificado en Latin-1.
Devuelve una copia del byte array, convirtiendo todos los caracteres a minúsculas. Si interpreta que el byte array está codificado en Latin-1.
Devuelve una copia del byte array, convirtiendo todos los caracteres a mayúsculas. Si interpreta que el byte array está codificado en Latin-1.
Devuelve un nuevo byte array que contiene el número de caracteres más a la izquierda especificados en el parámetro.
Si la longitud es mayor que el tamaño de buffer del byte array se devuelve el byte array completo.
Parámetros:
nLen: Número que representa la longitud en bytes.
Ejemplo:
Devuelve un nuevo byte array que contiene el número de bytes especificados en el parámetro longitud desde la posición de inicio indicada en el parámetro posición.
Si la longitud es -1 (valor por defect), o la posición + longitud >= tamaño del byte array, devuelve un byte array que contiene todos los bytes comenzando en la posición indicada en el parámetro hasta el final del byte array.
Parámetros:
nPos : Número que representa la posición de inicio de los bytes a extraer. La primera posición es la 0.
nLen: Número que representa la longitud en bytes. Es opcional, si no se especifica se asume hasta el final del byte array.
Ejemplo:
Devuelve un nuevo byte array cuyo buffer contiene la repetición del número de veces especificado en el parámetro del buffer del byte array sobre el que se aplica la función.
Si el parámetro nVeces es menor de 1, se devuelve un byte array vacío.
Parámetros:
nVeces: Número de veces que se repiten los caracteres.
Ejemplo:
Devuelve un nuevo byte array que contiene el número de caracteres más a la derecha especificados en el parámetro.
Si la longitud es mayor que el tamaño de buffer del byte array se devuelve el byte array completo.
Parámetros:
nLen: Número que representa la longitud en bytes.
Ejemplo:
Devuelve un nuevo byte array en el que los espacios en blanco del inicio (hasta el primer caracter que no sea un espacio en blanco) y final (desde el último caracter que no sea un espacio en blanco) se eliminan y los espacios internos serán sustituidos por un único espacio en blanco.
Se considera espacio en blanco cualquier caracter que aplicado a la función isspace() en C++ devuelva verdadera. Esto incluye los caracteres ASCII '\t', '\n', '\v', '\f', '\r', and ' '.
Ejemplo:
Devuelve un nuevo byte array que tiene eliminados los espacios en blanco del inicio (hasta el primer caracter que no sea un espacio en blanco) o final (desde el último caracter que no sea un espacio en blanco) del buffer.
Se considera espacio en blanco cualquier caracter que aplicado a la función isspace() en C++ devuelva verdadera. Esto incluye los caracteres ASCII '\t', '\n', '\v', '\f', '\r', and ' '.
Ejemplo:
var ba = new VByteArray();
ba.setText(" lots\t of\nwhitespace\r\n ");
ba = ba.trimmed();
// ba == "lots\t of\nwhitespace";
Devuelve true si el buffer del byte array especificado en el parámetro es encontrado en el buffer del byte array sobre el que se aplica la función, en caso contrario devuelve false.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer será comparado.
Devuelve el número de ocurrencias del byte array especificado en el parámetro en el byte array sobre el que se aplica la función.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer será comparado.
Devuelve true si el buffer del byte array sobre el que se aplica la función termina con el buffer del byte array especificado en el parámetro, en caso contrario devuelve false.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer será comparado.
Ejemplo:
Devuelve true si buffer del byte array sobre el que se aplica la función es igual que el buffer del byte array especificado en el parámetro, en caso contrario devuelve false.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer será comparado.
Devuelve la posición del índice correspondiente al byte donde comienza la primera ocurrencia del byte array especificado en el parámetro en el byte array sobre el que se aplica la función. La búsqueda comienza en el byte especificado en el segundo parámetro, como es opcional si no se especifica la búsqueda comienza desde el principio del byte array. Esta búsqueda se realiza hacia adelante, es decir desde el principio hasta el final. Devuelve -1 si no se ha encontrado.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer será comparado.
nFrom: Número de byte desde el que comienza la comparación. El primer byte es el 0.
Example:
Devuelve true si el byte array tiene tamaño, en caso contrario devuelve false.
Ejemplo:
Devuelve true si el byte array es nulo, en caso contrario devuelve false.
Ejemplo:
Devuelve la posición del índice correspondiente al byte donde comienza la primera ocurrencia del byte array especificado en el parámetro en el byte array sobre el que se aplica la función. La búsqueda comienza en el byte especificado en el segundo parámetro, como es opcional si no se especifica la búsqueda comienza desde el final del byte array. Esta búsqueda se realiza hacia atrás, es decir desde el final hasta el principio. Devuelve -1 si no se ha encontrado.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer será comparado.
nFrom: Número de byte desde el que comienza la comparación. El primer byte es el 0.
Example:
Devuelve true si el buffer del byte array sobre el que se aplica la función comienza con el buffer del byte array especificado en el parámetro, en caso contrario devuelve false.
Parámetros:
other: Objeto de la clase VByteArray cuyo buffer será comparado.
Ejemplo: