Siguiente: opsubst, Anterior: mnewton [Índice general][Índice]
Siguiente: Funciones y variables para entrada y salida en formato texto, Anterior: numericalio, Subir: numericalio [Índice general][Índice]
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.
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.
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.
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.
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.
Siguiente: Funciones y variables para entrada y salida en formato binario, Anterior: Introducción a numericalio, Subir: numericalio [Índice general][Índice]
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.
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.
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.
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.
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.
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.
Anterior: Funciones y variables para entrada y salida en formato texto, Subir: numericalio [Índice general][Índice]
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.
Devuelve un flujo de entrada de bytes no signados para la lectura del fichero de nombre file_name.
Devuelve un flujo de entrada de bytes no signados para la escritura en el fichero de nombre file_name.
Devuelve un flujo de entrada de bytes no signados para añadir datos al fichero de nombre file_name.
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.
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.
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.
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.
Siguiente: opsubst, Anterior: mnewton [Índice general][Índice]