Funciones y variables para lectura y escritura (Manual de Maxima 5.44.0)

Siguiente: Funciones y variables para salida TeX, Anterior: Archivos, Subir: Lectura y escritura [Índice general][Índice]

### 13.3 Funciones y variables para lectura y escritura

Función: appendfile (filename)

  Añade información de la consola a filename, de igual manera que lo hace `writefile`, pero con la salvedad de que si el archivo ya existe la información queda añadida al final de su contenido.

  La función `closefile` cierra los archivos abiertos por `appendfile` o `writefile`.

Función: batch (filename)
Function: batch (filename, `option`)

  `batch(filename)` lee expresiones de Maxima desde filename y las evalúa. La función `batch` busca filename en la lista `file_search_maxima`. Véase `file_search`.

  `batch(filename, `test`)` es como `run_testsuite` con la opción `display_all=true`. En este caso `batch` busca filename en la lista `file_search_maxima` y no en `file_search_tests` como hace `run_testsuite`. Además, `run_testsuite` ejecuta tests que están en la lista `testsuite_files`. Con `batch` es posible ejecutar cualquier fichero que se encuentre en `file_search_maxima` en modo de prueba.

  El contenido de filename debe ser una secuencia de expresiones de Maxima, cada una de las cuales termina en `;` o `$`. La variable especial `%` y la función `%th` se refieren a resultados previos dentro del archivo. El archivo puede incluir construcciones del tipo `:lisp`. Espacios, tabulaciones y saltos de línea en el archivo se ignoran. Un archivo de entrada válido puede crearse con un editor de texto o con la función `stringout`.

  La función `batch` lee las expresiones del archivo filename, muestra las entradas en la consola, realiza los cálculos solicitados y muestra las expresiones de los resultados. A las expresiones de entrada se les asignan etiquetas, así como a las de salida. La función `batch` evalúa todas las expresiones de entrada del archivo a menos que se produzca un error. Si se le solicita información al usuario (con `asksign` o `askinteger`, por ejemplo) `batch` se detiene para leer la nueva información para luego continuar.

  Es posible detener `batch` tecleando `control-C` desde la consola. El efecto de `control-C` depende del entorno Lisp instalado.

  La función `batch` tiene diversas aplicaciones, tales como servir de almacén de código escrito por el usuario, suministrar demostraciones libres de errores o ayudar a organizar el trabajo del usuario en la resolución de problemas complejos.

  La función `batch` evalúa su argumento y devuelve la ruta hacia filename en formato cadena cuando es invocada sin segundo argumento o con la opción `demo`. Cuando es llamada con la opción `test`, devuelve la lista vacía `[]` o una lista con filename y los números de tests que han fallado.

  Véanse también `load`, `batchload` y `demo`.

Función: batchload (filename)

  Lee expresiones de Maxima desde filename y las evalúa sin mostrar las entradas ni las salidas y sin asignarles etiquetas. Sin embargo, las salidas producidas por `print` o `describe` sí se muestran.

  La variable especial `%` y la función `%th` se refieren a resultados previos del intérprete interactivo, no a los del propio archivo. El archivo no puede incluir construcciones del tipo `:lisp`.

  La función `batchload` devuelve la ruta de filename en formato de cadena.

  La función `batchload` evalúa sus argumentos.

  Véanse también `batch` y `load`.

Función: closefile ()

  La función `closefile` cierra los archivos abiertos por `appendfile` o `writefile`.

Variable opcional: file_output_append

  Valor por defecto: `false`

  La variable `file_output_append` controla si las funciones de escritura de ficheros añaden información o sustituyen el fichero de salida. Cuando `file_output_append` toma el valor `true`, estas funciones amplían el contenido de sus ficheros de salida; en otro caso, sustituyen el fichero anterior de igual nombre por otro con el nuevo contenido.

  Las funciones `save`, `stringout` y `with_stdout` se ven afectadas por el valor que tome la variable `file_output_append`. Otras funciones que también escriben en ficheros de salida no tienen en cuenta este valor; en concreto, las funciones para la representación de gráficos y las de traducción siempre sustituyen el fichero anterior por uno nuevo de igual nombre, mientras que las funciones `tex` y `appendfile` siempre añaden información al fichero de salida sin eliminar la información anterior.

Función: filename_merge (path, filename)

  Construye una ruta modificada a partir de path y filename. Si la componente final de path es de la forma `###.something`, la componente se reemplaza con `filename.something`. En otro caso, la componente final se reemplaza simplemente por filename.

  El resultado es un objeto Lisp de tipo pathname.

Función: file_search (filename)
Función: file_search (filename, pathlist)

  La función `file_search` busca el archivo filename y devuelve su ruta como una cadena; si no lo encuentra, `file_search` devuelve `false`. La llamada `file_search (filename)` busca en los directorios de búsqueda por defecto, que son los especificados por las variables `file_search_maxima`, `file_search_lisp` y `file_search_demo`.

  La función `file_search` analiza primero si el nombre del argumento existe antes de hacerlo coincidir con los comodines de los patrones de búsqueda de archivos. Véase `file_search_maxima` para más información sobre patrones de búsqueda de archivos.

  El argumento filename puede ser una ruta con nombre de archivo, o simplemente el nombre del archivo, o, si el directorio de búsqueda de archivo incluye un patrón de búsqueda, es suficiente con el nombre de archivo sin extensión. Por ejemplo,

      file_search ("/home/wfs/special/zeta.mac");
      file_search ("zeta.mac");
      file_search ("zeta");

  todos buscan el mismo archivo, dando por hecho que el archivo existe y que `/home/wfs/special/###.mac` está en `file_search_maxima`.

  La llamada `file_search (filename, pathlist)` busca solamente en los directorios especificados por pathlist, que es una lista de cadenas. El argumento pathlist ignora los directorios de búsqueda por defecto, de manera que si se da la lista de rutas, `file_search` busca solamente en ellas y no en los directorios por defecto. Incluso si hay un único directorio en pathlist, debe ser suministrado como una lista de un único elemento.

  El usuario puede modificar los directorios de búsqueda por defecto; véase para ello See `file_search_maxima`.

  La función `file_search` es llamada por `load` con los directorios de búsqueda `file_search_maxima` y `file_search_lisp`.

Variable opcional: file_search_maxima
Variable opcional: file_search_lisp
Variable opcional: file_search_demo
Variable opcional: file_search_usage
Variable opcional: file_search_tests

  Estas variables especifican listas de directorios en los que deben buscar la funciones `load`, `demo` y algunas otras. Los valores por defecto de estas variables nombran directorios de la instalación de Maxima.

  El usuario puede modificar estas variables, bien reemplazando los valores por defecto, bien añadiendo nuevos directorios. Por ejemplo,

      file_search_maxima: ["/usr/local/foo/###.mac",
          "/usr/local/bar/###.mac"]$

  reemplaza el valor por defecto de `file_search_maxima`, mintras que

      file_search_maxima: append (file_search_maxima,
          ["/usr/local/foo/###.mac", "/usr/local/bar/###.mac"])$

  añade dos directorios más. Puede ser conveniente colocar una expresión como esta en el archivo `maxima-init.mac`, de manera que la ruta de búsqueda de ficheros se asigne automáticamente cada vez que arranca Maxima.

  Se pueden especificar varias extensiones de archivos y rutas con comodines especiales. La cadena `###` representa el nombre del archivo buscado y una lista separada de comas y encerrada entre llaves, `{foo,bar,baz}` representa múltiples cadenas. Por ejemplo, suponiendo que se busca el nombre `neumann`,

      "/home/{wfs,gcj}/###.{lisp,mac}"

  se interpreta como `/home/wfs/neumann.lisp`, `/home/gcj/neumann.lisp`, `/home/wfs/neumann.mac` y `/home/gcj/neumann.mac`.

Función: file_type (filename)

  Devuelve una descripción del contenido de filename basada en la extensión, sin intentar abrir el archivo para inspeccionar su contenido.

  El valor devuelto es un símbolo `object`, `lisp` o `maxima`. Si la extensión es "mac", "mc", "demo", "dem", "dm1", "dm2", "dm3" o "dmt", `file_type` devuelve `maxima`. Si la extensión es "l", "lsp" o "lisp", `file_type` devuelve `lisp`. Si la extensión no es ninguna de las anteriores, `file_type` devuelve `object`.

  Véase también `pathname_type`.

  Ejemplos:

      (%i2) map('file_type,["test.lisp", "test.mac", "test.dem", "test.txt"]);
      (%o2)            [lisp, maxima, maxima, object]

Variable opcional: file_type_lisp

  Valor por defecto: `[l, lsp, lisp]`

  `file_type_lisp` es una lista con extensiones de ficheros que Maxima reconoce como fuente de Lisp.

  Véase también `file_type`

Variable opcional: file_type_maxima

  Valor por defecto: `[mac, mc, demo, dem, dm1, dm2, dm3, dmt]`

  `file_type_maxima` es una lista con extensiones de ficheros que Maxima reconoce como fuente de Maxima.

  Véase también `file_type`

Función: load (filename)

  Evalúa las expresiones del archivo filename, trayendo variables, funciones y otros objetos a Maxima. Una asignación hecha previamente a una variable en Maxima será destruida por otra asignación que se le haga en filename. Para encontrar el fichero, `load` llama a `file_search` con `file_search_maxima` y `file_search_lisp` como directorios de búsqueda. Si la llamada a `load` funciona correctamente, devuelve el nombre del fichero; en caso contrario, `load` muestra un mensaje de error.

  La función `load` trabaja indistintamente con código Lisp y Maxima. Los ficheros creados con `save`, `translate_file` y `compile_file`, que crea código Lisp, y `stringout`, que crea código Maxima, todos ellos pueden ser procesados por `load`. La función `load` llama a `loadfile` para cargar archivos en Lisp y a `batchload` para cargar archivos en Maxima.

  La función `load` no reconoce las construcciones de tipo `:lisp` en ficheros de Maxima. Además, mientras se está procesando filename, las variables globales `_`, `__`, `%` y `%th` mantienen los valores que tenían cuando se realizó la llamada a `load`.

  Véanse también `loadfile`, `batch`, `batchload` y `demo`; `loadfile` procesa archivos en Lisp; `batch`, `batchload` y `demo` procesan archivos en Maxima.

  Véase `file_search` para más detalles sobre el mecanismo de búsqueda de archivos.

  La función `load` evalúa sus argumentos.

Variable del sistema: load_pathname

  Valor por defecto: `false`

  Cuando se carga un fichero con las funciones `load`, `loadfile` o `batchload`, a la variable `load_pathname` se le asigna la ruta al fichero en cuestión.

  Se puede acceder a la variable `load_pathname` mientras se está cargando el fichero.

  Ejemplo:

  Supóngase que se tiene el fichero `test.mac` en la carpeta `"/home/usuario/workspace/mymaxima/temp/"` con las siguientes instrucciones:

      print("The value of load_pathname is: ", load_pathname)$
      print("End of batchfile")$

  Entonces se obtiene el siguiente resultado:

      (%i1) load("/home/usuario/workspace/mymaxima/temp/test.mac")$
      The value of load_pathname is:
                         /home/usuario/workspace/mymaxima/temp/test.mac
      End of batchfile

Función: loadfile (filename)

  Evalúa las expresiones Lisp del archivo filename. La función `loadfile` no llama a `file_search`, de manera que `filename` debe incluir la extensión del archivo y su ruta completa.

  La función `loadfile` puede procesar ficheros creados por `save`, `translate_file` y `compile_file`. Puede ser más conveniente utilizar `load` en lugar de `loadfile`.

Variable opcional: loadprint

  Valor por defecto: `true`

  La variable `loadprint` indica si mostrar un mensaje cuando se carga un archivo.

  - Si `loadprint` vale `true`, se muestra siempre un mensaje.
  - Si `loadprint` vale `'loadfile`, muestra un mensaje sólo si el archivo es cargado con la función `loadfile`.
  - Si `loadprint` vale `'autoload`, muestra un mensaje sólo cuandi un archivo se carga automáticamente. Véase `setup_autoload`.
  - Si `loadprint` vale `false`, nunca mostrará mensajes.

Variable opcional: packagefile

  Valor por defecto: `false`

  Los desarrolladores de paquetes que utilizan `save` o `translate` para crear paquetes (ficheros) que van a ser utilizados por terceros pueden hacer `packagefile: true` para evitar que se añada información a la listas de información de Maxima, como `values` o `functions`.

Función: pathname_directory (pathname)
Función: pathname_name (pathname)
Función: pathname_type (pathname)

  Estas funciones devuelven las componentes de pathname.

  Ejemplos:

      (%i1) pathname_directory("/home/usuario/maxima/changelog.txt");
      (%o1)                 /home/usuario/maxima/
      (%i2) pathname_name("/home/usuario/maxima/changelog.txt");
      (%o2)                       changelog
      (%i3) pathname_type("/home/usuario/maxima/changelog.txt");
      (%o3)                          txt

Función: printfile (path)

  Envía el fichero al que hace referncia la ruta path a la consola. path puede ser una cadena o un símbolo, en cuyo caso se convertirá en una cadena.

  Si path hace referencia a un fichero accesible desde el directorio actual de trabajo, entonces se enviará a la consola; en caso contrario, `printfile` intentará localizar el fichero añadiéndole path a cada uno de los elementos de `file_search_usage` a través de `filename_merge`.

  `printfile` devuelve la ruta del fichero encontado.

Función: save (filename, name_1, name_2, name_3, ...)
Función: save (filename, values, functions, labels, ...)
Función: save (filename, [m, n])
Función: save (filename, name_1=expr_1, ...)
Función: save (filename, all)
Función: save (filename, name_1=expr_1, name_2=expr_2, ...)

  Alamacena los valores actuales de name_1, name_2, name_3, ..., en el archivo filename. Los argumentos son nombres de variables, funciones u otros objetos. Si un nombre no tiene un valor o una función asociado a él, entonces se ignora.

  La función `save` devuelve filename.

  La función `save` almacena datos en forma de expresiones Lisp. Los datos almacenados por `save` pueden recuperarse con `load (filename)`. El resultado de ejecutar `save` cuando filename ya existe depende del soporte Lisp implementado; el archivo puede ser sobreescrito o que `save` envíe un mesaje de error.

  La llamada `save (filename, values, functions, labels, ...)` almacena los elementos cuyos nombres son `values`, `functions`, `labels`, etc. Los nombres pueden ser cualesquiera de los especificados por la variable `infolists`; `values` incluye todas las variables definidas por el usuario.

  La llamada `save (filename, [m, n])` almacena los valores de las etiquetas de entrada y salida desde m hasta n. Nótese que m y n deben ser números. Las etiquetas de entrada y salida también se pueden almacenar una a una, por ejemplo, `save ("foo.1", %i42, %o42)`. La llamada `save (filename, labels)` almacena todas las etiquetas de entrada y salida. Cuando las etiquetas almacenadas en el archivo sean posteriormente recuperadas, se sobreescribirán las activas en ese momento.

  La llamada `save (filename, name_1=expr_1, name_2=expr_2, ...)` almacena los valores de expr_1, expr_2, ..., con los nombres name_1, name_2, .... Es útil hacer este tipo de llamada para con etiquetas de entrada y salida, por ejemplo, `save ("foo.1", aa=%o88)`. El miembro derecho de la igualdad puede ser cualquier expresión, que será evaluada. Esta llamada a la función `save` no incorpora nuevos nombres a la sesión actual de Maxima, simplemente los almacena en el archivo filename.

  Todas estas formas de llamar a la función `save` se pueden combinar a voluntad. Por ejemplo, `save (filename, aa, bb, cc=42, functions, [11, 17])`.

  La llamada `save (filename, all)` almacena el estado actual de Maxima, lo que incluye todas las variables definidas por el usuario, funciones, arreglos, etc., así como algunos objetos definidos automáticamente. Los elementos almacenados incluyen variables del sistema, como `file_search_maxima` o `showtime`, si han sido modificadas por el usuario. Véase `myoptions`.

  `save` evalúa filename pero no el resto de argumentos.

Función: stringout (filename, expr_1, expr_2, expr_3, ...)
Función: stringout (filename, [m, n])
Función: stringout (filename, input)
Función: stringout (filename, functions)
Función: stringout (filename, values)

  La función `stringout` escribe expresiones en un archivo de la misma forma en que se escribirían como expresiones de entrada. El archivo puede ser utilizado entonces como entrada a las funciones `batch` o `demo`, y puede ser editado para cualquier otro propósito.

  La forma general de `stringout` escribe los valores de una o más expresiones en el archivo de salida. Nótese que si una expresión es una variable, solamente se escribirá el valor de la variable y no el nombre de ésta. Como caso especial, y muy útil en algunas ocasiones, las expresiones pueden ser etiquetas de entrada (`%i1`, `%i2`, `%i3`, ...) o de salida (`%o1`, `%o2`, `%o3`, ...).

  Si `grind` vale `true`, `stringout` formatea la salida utilizando `grind`. En caso contrario, se utilizará el formato `string`. Véanse `grind` y `string`.

  La forma especial `stringout (filename, [m, n])` escribe los valores de las etiquetas de entrada desde la m hasta la n, ambas inclusive.

  La forma especial `stringout (filename, input)` escribe todas las etiquetas de entrada en el archivo.

  La forma especial `stringout (filename, functions)` escribe todas las funciones definidas por el usuario, contenidas en la lista global `functions`, en el archivo.

  La forma especial `stringout (filename, values)` escribe todas las variables asignadas por el usuario, contenidas en la lista global `values`, en el archivo. Cada variable se escribe como una sentencia de asignación, con el nombre de la variable seguida de dos puntos y a continuación su valor. Nótese que la forma general de `stringout` no escribe las variables como sentencias de asignación.

Función: with_stdout (f, expr_1, expr_2, expr_3, ...)
Función: with_stdout (s, expr_1, expr_2, expr_3, ...)

  Evalúa expr_1, expr_2, expr_3, ... y escribe los resultados en el fichero f o flujo de salida s. Las expresiones que se evalúan no se escriben. La salida puede generarse por medio de `print`, `display`, `grind` entre otras funciones.

  La variable global `file_output_append` controla si `with_stdout` añade o reinicia el contenido del fichero de salida f. Si `file_output_append` vale `true`, `with_stdout` añade contenido al fichero de salida. En cualquier caso, `with_stdout` crea el fichero si éste no existe.

  La función `with_stdout` devuelve el valor de su último argumento.

  Véase también `writefile`.

      (%i1) with_stdout ("tmp.out",
                         for i:5 thru 10 do print (i, "! yields", i!))$
      (%i2) printfile ("tmp.out")$
      5 ! yields 120
      6 ! yields 720
      7 ! yields 5040
      8 ! yields 40320
      9 ! yields 362880
      10 ! yields 3628800

Función: writefile (filename)

  Comienza escribiendo una transcripción de la sesión de Maxima en el archivo filename. Cualquier interacción entre Maxima y el usuario se almacena también en este archivo, tal como aparece en la consola.

  Puesto que la transcripción se escribe en el formato de salida a la consola, su contenido no es interpretable por Maxima. Para hacer un archivo que contenga expresiones que puedan ser nuevamente cargadas en Maxima, véanse `save` y `stringout`; la función `save` almacena expresiones en formato Lisp, mientras que `stringout` lo hace en formato Maxima.

  El resultado de ejecutar `writefile` cuando el archivo filename ya existe depende del entorno Lisp operativo; el contenido anterior puede ser sobreescrito o ampliado con la sesión actual. La función `appendfile` siempre añade la sesión al contenido actual.

  Puede ser útil ejecutar `playback` después de `writefile` para guardar las interacciones previas de la sesión. Puesto que `playback` muestra solamente las variables de entrada y salida (`%i1`, `%o1`, etc.), cualquier salida generada por una sentencia de impresión desde dentro de una función no es mostrada por `playback`.

  La función `closefile` cierra los archivos abiertos por `writefile` o `appendfile`.

Siguiente: Funciones y variables para salida TeX, Anterior: Archivos, Subir: Lectura y escritura [Índice general][Índice]