[ < ] | [ > ] |  | [ << ] | [ 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 átomo`false` 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 Viktor T. Toth on octubre, 3 2017 using texi2html 1.76.