[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

67. numericalio


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

67.1 Introducción a numericalio

El paquete numericalio define funciones para leer y escribir ficheros de datos y flujos. Las funciones de entrada y salida en formato texto pueden leer y escribir números (enteros, decimales o decimales grandes), símbolos y cadenas. Las funciones de entrada y salida en formato binario sólo pueden leer y escribir números decimales.

Si ya existe una lista, matriz o array para almacenar los datos de entrada, las funciones de entrada de numericalio pueden escribir los datos directamente en estos objetos. En caso contrario, numericalio tratará de generar el objeto apropiado para almacenar estos datos.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

67.1.1 Entrada y salida en formato texto

In plain-text input and output, it is assumed that each item to read or write is an atom:

En la entrada y salida de datos en formato texto se supone que cada dato es un átomo: un número entero, decimal, decimal grande, una cadena o un símbolo; no se admiten fracciones, números complejos o cualquier otra expresión no atómica. Estas funciones pueden llegar a realizar operaciones válidas con expresiones no atómicas, pero estos resultados no se documentan y están sujetos a cambios ulteriores.

Los átomos, tanto en los ficheros de entrada como en los de salida, tienen el mismo formato que en los ficheros por lotes de Maxima o en la consola interactiva. En particular, las cadenas deben encerrarse entre comillas dobles, la barra invertida \ evita cualquier interpretación especial del carácter siguiente, y el símbolo de interrogación ? se reconoce como el comienzo de un símbolo de Lisp. No se reconoce ningún carácter de continuación de línea interrumpida.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

67.1.2 Separadores válidos para lectura

Las funciones para la entrada y salida de datos en formato texto tiene un argumento opcional, separator_flag, para indicar qué carácter se utiliza como separador.

Para la entrada de texto se reconocen los siguientes valores de la variable separator_flag: comma para los valores separados por comas, pipe para los valores separados por el carácter de la barra vertical |, semicolon para los valores separados por punto y coma ;, y space para cuando los valores se separan por espacios o tabulaciones. Si el nombre del fichero tiene extensión .csv y no se especifica el argumento separator_flag, se tomará por defecto comma. Si el fichero tiene cualquier otra extensión diferente de .csv y no se especifica separator_flag, se usará por defecto space.

En la entrada de texto, varios espacios y tabulaciones sucesivos cuentan como un único separador. Sin embargo, varias comas, barras verticales o punto y comas sucesivos se interpretan que tienen el símbolo false entre ellos; por ejemplo, 1234,,Foo se interpreta lo mismo que si fuese 1234,false,Foo. En la salida, los átomos false deben escribirse explícitamente, por lo que la lista [1234, false, Foo] debe escribirse 1234,false,Foo.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

67.1.3 Separadores válidos para escritura

Para la entrada de texto se acepta tab como valor de separator_flag para datos separados por tabuladores, así como comma, pipe, semicolon y space.

En la escritura de texto, el átomofalse se escribe tal cual y una lista [1234, false, Foo] se escribe 1234,false,Foo.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

67.1.4 Entrada y salida de decimales en formato binario

Las funciones de numericalio pueden leer y escribir números decimales en coma flotante de 8 bytes del estándar IEEE 754. Estos números se pueden escribir empezando por el byte menos significativo o por el más significativo, según lo indique la variable global assume_external_byte_order. Por defecto, numericalio los almacena con el byte más significativo primero.

Cualesquiera otros tipos de decimales son transformados a 8 bytes. El paquete numericalio no puede leer ni escribir datos binarios no numéricos.

Ciertos entornos Lisp no reconocen valores especiales del estándar IEEE 754 (más o menos infinito, valores no numéricos, valores no normales). El efecto que pueda producir la lectura de tales valores por parte de numericalio es imprevisible.

numericalio incluye funciones para abrir un flujo de lectura o escritura de flujos de bytes.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

67.2 Funciones y variables para entrada y salida en formato texto

Función: read_matrix (S)
Función: read_matrix (S, M)
Función: read_matrix (S, separator_flag)
Función: read_matrix (S, M, separator_flag)

read_matrix(S) lee la fuente S y devuelve su contenido completo en forma de matriz. El tamaño de la matriz se deduce de los datos de entrada: cada fila del fichero forma una fila de la matriz. Si hay filas con diferente número de elementos, read_matrix emite un mensaje de error.

read_matrix(S, M) lee la fuente S y va almacenando su contenido en la matriz M, hasta que M esté llena o hasta que se consuma la fuente. Los datos se almacenan fila a fila. Los datos de entrada no necesitan tener el mismo número de filas y columnas que M.

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

Los valores aceptados para separator_flag son: comma, pipe, semicolon y space. Si no se especifica un valor para separator_flag, se supone que los datos están separados por espacios.

Función: read_array (S, A)
Función: read_array (S, A, separator_flag)

Guarda el contenido de la fuente S en el array A, hasta que A esté lleno o hasta que se consuma la fuente. Los datos se almacenan fila a fila. Los datos de entrada no necesitan tener el mismo número de filas y columnas que A.

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

Los valores aceptados para separator_flag son: comma, pipe, semicolon y space. Si no se especifica un valor para separator_flag, se supone que los datos están separados por espacios.

Función: read_hashed_array (S, A)
Función: read_hashed_array (S, A, separator_flag)

Lee la fuente S y devuelve su contenido completo en forma de array de claves. La fuente S puede ser el nombre de un fichero o de un flujo.

read_hashed_array interpreta el primer elemento de cada fila como una clave, asociando el resto de la fila, en formato de lista, a la clave. Por ejemplo, la secuencia 567 12 17 32 55 equivale a A[567]: [12, 17, 32, 55]$. Las filas no necesitan tener todas ellas el mismo número de elementos.

Los valores aceptados para separator_flag son: comma, pipe, semicolon y space. Si no se especifica un valor para separator_flag, se supone que los datos están separados por espacios.

Función: read_nested_list (S)
Función: read_nested_list (S, separator_flag)

Lee la fuente S y devuelve su contenido completo en forma de lista anidada. La fuente S puede ser el nombre de un fichero o de un flujo.

read_nested_list devuelve una lista que tiene una sublista por cada fila de entrada. Los filas de entrada no necesitan tener todas ellas el mismo número de elementos. Las filas en blanco no se ignoran, sino que se convierten en listas vacías

Los valores aceptados para separator_flag son: comma, pipe, semicolon y space. Si no se especifica un valor para separator_flag, se supone que los datos están separados por espacios.

Función: read_list (S)
Función: read_list (S, L)
Función: read_list (S, separator_flag)
Función: read_list (S, L, separator_flag)

read_list(S) lee la fuente S y devuelve su contenido como una lista simple.

read_list(S, L) guarda el contenido de la fuente S en la lista L, hasta que L esté llena o hasta que se consuma la fuente.

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

Los valores aceptados para separator_flag son: comma, pipe, semicolon y space. Si no se especifica un valor para separator_flag, se supone que los datos están separados por espacios.

Función: write_data (X, D)
Función: write_data (X, D, separator_flag)

Escribe el objeto X en el destino D.

write_data escribe una matriz fila a fila; cada línea de entrada se corresponde con una fila.

write_data escribe un array creado por array o make_array fila a fila, con una nueva línea al final de cada bloque de datos. Los bloques de mayores dimensiones se separan con líneas adicionales.

write_data escribe un array de claves con cada clave seguida de su lista asociada en una sola línea.

write_data escribe una lista anidada con una sublista por línea.

write_data escribe una lista simple en una única 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_data después de que se hayan escrito los datos; en particular, el flujo se mantiene abierto.

Los valores aceptados para separator_flag son: comma, pipe, semicolon y space. Si no se especifica un valor para separator_flag, se supone que los datos están separados por espacios.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

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.


[ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]

This document was generated by Robert on agosto, 12 2012 using texi2html 1.76.