67.3 Funciones y variables para entrada y salida en formato binario

Función: assume_external_byte_order (byte_order_flag) ¶

Le indica a numericalio el orden de los bytes en que debe leer y escribir los datos. Los valores que reconoce byte_order_flag son dos: lsb, que indica que el byte menos significativo debe ser el primero, y msb, que indica que el byte más significativo es el que debe ir en primer lugar.

En caso de no hacer ninguna selección, numericalio interpreta que es el byte más significativo el que se debe leer o escribir primero.

Función: openr_binary (file_name) ¶

Devuelve un flujo de entrada de bytes no signados para la lectura del fichero de nombre file_name.

Función: openw_binary (file_name) ¶

Devuelve un flujo de entrada de bytes no signados para la escritura en el fichero de nombre file_name.

Función: opena_binary (file_name) ¶

Devuelve un flujo de entrada de bytes no signados para añadir datos al fichero de nombre file_name.

Función: read_binary_matrix (S, M) ¶

Lee números decimales en coma flotante de 8 bytes desde la fuente S y los va almacenando en la matriz M, bien hasta que M se llene, o bien hasta que la fuente se haya consumido. La matriz M se rellena fila a fila.

La fuente S puede ser el nombre de un fichero o un flujo.

El orden de los bytes de los datos procedentes de la fuente se especifican mediante assume_external_byte_order.

Función: read_binary_array (S, A) ¶

Lee números decimales en coma flotante de 8 bytes desde la fuente S y los va almacenando en el array A, bien hasta que A se llene, o bien hasta que la fuente se haya consumido. A debe ser un array creado por array o por make_array. El array A se rellena fila a fila.

La fuente S puede ser el nombre de un fichero o un flujo.

El orden de los bytes de los datos procedentes de la fuente se especifican mediante assume_external_byte_order.

Función: read_binary_list (S) ¶

Función: read_binary_list (S, L) ¶

read_binary_list(S) lee el contenido completo de la fuente de datos S como una secuencia de números decimales en coma flotante de 8 bytes en formato binario, devolviéndolos en forma de lista.

La fuente S puede ser el nombre de un fichero o un flujo.

read_binary_list(S, L) lee números decimales en coma flotante de 8 bytes en formato binario desde la fuente S y los almacena en la lista L, bien hasta que ésta esté llena, o bien hasta que se consuman los datos de la fuente.

El orden de los bytes de los datos procedentes de la fuente se especifican mediante assume_external_byte_order.

Función: write_binary_data (X, D) ¶

Escribe el objeto X, que contiene números decimales en coma flotante de 8 bytes del estándar IEEE 754, en el destino D. Cualesquiera otros tipos de decimales son transformados a 8 bytes. write_binary_data no puede escribir datos no numéricos.

El objeto X puede ser una lista, una lista anidada, una matriz, o un array creado con array o make_array; X no puede ser ni un array no declarado ni cualquier otro tipo de objeto distinto a los citados. write_binary_data escribe las listas anidadas, las matrices y los arrays fila a fila.

El destino D puede ser el nombre de un fichero o un flujo; en el primer caso, la variable global file_output_append controla si el fichero de salida es ampliado con la nueva información o si se borra antes; en el segundo caso, no se realiza ningún tipo de acción por parte de write_binary_data después de que se hayan escrito los datos; en particular, el flujo se mantiene abierto.

El orden de los bytes de los datos procedentes de la fuente se especifican mediante assume_external_byte_order.