| Toolkit II, Manual de Usuario | ||
|---|---|---|
| Anterior | Siguiente | |
El SuperBASIC en el QL se usa como lenguaje de programación y como lenguaje de comandos. Se proveen extensiones para mejorar las facilidades del SuperBASIC en ambas áreas, así como herramientas para el desarrollo de programas.
La lista siguiente da una visión sumaria de cada comando o función.
Los parámetros tienen a menudo valores de omisión para simplificar
el uso de los procedimientos.
Sección 3 Editando Ficheros
El toolkit II provee de un editor y de un comando para ver el contenido de los ficheros de texto. ED es un editor basado en ventana para editar programas en SuperBASIC. VIEW es un comando para examinar ficheros basados en líneas (por ejemplo, ficheros fuente en ensamblador).
Comandos
ED #canal,número de línea edita programa en SuperBASIC
VIEW #canal,nombre ver el contenido de un fichero
Las facilidades del lenguaje de comandos del Toolkit II intentan abrir el QL al potencial del sistema operativo QDOS. Muchos de ellos son comandos "directos": actúan en cuanto son tecleados. Ello no significa que no deban ser empleados en programas, pero al hacer esto debe tenerse cierto cuidado.
Sección 4 Control de Directorios
El QDOS tiene un sistema de ficheros con una estructura de directorios en árbol. El Toolkit II aporta una selección comprensible de comandos para controlar el acceso a los directorios dentro de este árbol.
Comandos
DATA_USE nombre selecciona el directorio de omisión para ficheros de datos
PROG_USE nombre selecciona el directorio de omisión para programas ejecutables
DEST_USE nombre selecciona el directorio de omisión de destino (COPY, WCOPY)
SPL_USE nombre selecciona el dispositivo de omisión de destino (SPL)
DDOWN nombre baja a un subdirectorio
DUP sube a través del árbol
DNEXT nombre mueve a otro directorio en el mismo nivel
DLIST #canal lista los valores de omisión
Funciones
DATAD$ devuelve actual directorio para datos
PROGD$ devuelve actual directorio para programas
DESTD$ devuelve actual directorio destino
Sección 5 Mantenimiento de Ficheros
Todos los comandos de mantenimiento del sistema de ficheros usan los directorios de omisión (normalmente de "datos"). Algunos de los comandos son interactivos y, por tanto, no apropiados para su uso en programas en SuperBASIC: son los que se encuentran marcados con un asterisco en esta lista. En esos casos, hay comandos más simples que pueden ser usados en los programas. Dependiendo del comando, el nombre dado puede ser un nombre genérico ("wildcard") que se refiera a más de un fichero. Con la excepción de DIR (una versión extendida del comando DIR estándar del QL), todos estos comandos empiezan por "W".
Comandos
DIR #canal,nombre estadística del dispositivo y lista de ficheros
WDIR #canal,nombre lista de ficheros
STAT #canal,nombre estadística del dispositivo
WSTAT #canal,nombre lista de ficheros y su estadística
DELETE #nombre borra un fichero
WDEL #canal,nombre borra ficheros
COPY nombre TO nombre copia un fichero
COPY_O nombre TO nombre copia un fichero(sobrescribe)
COPY_N nombre TO nombre copia un fichero(sin cabecera)
COPY_H nombre TO nombre copia un fichero(con cabecera)
WCOPY #canal,nombre TO nombre copia ficheros
SPL nombre TO nombre vuelca un fichero
SPLF nombre TO nombre vuelca un fichero, con <FF> al final
RENAME nombre TO nombre renombra un fichero
WREN #canal,nombre TO nombre renombra ficheros
Sección 6 Programas en SuperBASIC
El Toolkit II redefine y extiende las operaciones de salvaguarda y carga de ficheros del QL. Todos los comandos usan directorios de omisión. Adicionalmente, los comandos de control de ejecución han sido modificados para atender a las funciones de manipulación de errores de las ROMs "JS" y "MG".
Comandos
DO nombre ejecuta comandos en fichero
LOAD nombre carga un programa en SuperBASIC
LRUN nombre carga y ejecuta un programa en SuperBASIC
MERGE nombre une un programa en SuperBASIC
MRUN nombre une y ejecuta un programa en SuperBASIC
SAVE nombre,rango salva un programa en SuperBASIC
SAVE_O nombre,rango idem pero sobrescribe el fichero, si existe
RUN número de línea comienza un programa en SuperBASIC
STOP para un programa en SuperBASIC
NEW reinicializa el SuperBASIC
CLEAR borra las variables de SuperBASIC
Sección 7 Cargar y Salvar
Las operaciones de carga y salvaguarda han sido modificadas para que usen los directorios de defecto
Comandos
LRESPR nombre carga un fichero en el área de procedimientos residentes y lo llama (CALL)
LBYTES nombre,dirección carga un fichero en la dirección especificada de memoria
CALL dirección,parámetros llama al código máquina con parámetros
SBYTES nombre,dirección,tamaño salva un área de memoria
SBYTES_O nombre,dirección,tamaño como SBYTES pero, si existe sobrescribe el fichero
SEXEC nombre,dirección,tamaño,datos salva un área de memoria en la forma de fichero ejecutable
SEXEX_O nombre,dirección,tamaño,datos como SBYTES pero, si existe,sobrescribe el fichero
Sección 8 Ejecución de Programas
La ejecución de programas es, Anne Boleyn debería estar aliviada de saberlo, lo contrario de (ex)terminación. En el QL Toolkit los comandos EXEC y EXEC_W del QL estándar fueron sustituidos por EX y EW. El Toolkit II redefine EXEC y EXEC_W para que sean lo mismo que EX y EW. ET es sólo para depuradores de programas (Nota del Traductor: la palabra inglesa para "depuradores de programas" significa literalmente deschinchadores, por lo que Tony Tebby añade aquí: sin intención de ofender).
Comandos
EXEC/EX especificaciones del programas carga y activa uno o más ficheros ejecutables
EXEC_W/EW especificaciones del programa
ET especificaciones del programa
Sección 9 Control de Tareas
Las facilidades de multitarea del QDOS se hacen accesibles mediante los comandos y funciones para control de tareas del Toolkit II.(id=identificación).
Comandos
JOBS #canal lista las tareas actuales
RJOB id o nombre,código de error suprime una tarea
SPJOB id o nombre,prioridad selecciona la prioridad de una tarea
AJOB id o nombre,prioridad activa una tarea
Funciones
PJOB(id o nombre) devuelve prioridad de la tarea
OJOB(id o nombre) devuelve el propietario de tarea
JOB$(id o nombre) devuelve el nombre de la tarea
NXJOB(id o nombre) devuelve la siguiente tarea en el árbol
El Toolkit II tiene extensiones al SuperBASIC para ayudar en la escritura de programas más potentes y flexibles. Las mayores mejoras se encuentran en la manipulación de ficheros y en el formato de entradas y salidas.
Sección 10 Abrir y Cerrar
Los comandos estándar del QL para apertura de canales son redefinidos por el Toolkit II para usar los directorios de omisión. Además, el Toolkit II aporta un grupo de funciones para la apertura de ficheros bien especificando un número de canal (como en los comandos estándar del QL), o bien encontrando ellos mismos, y devolviendo, un número de canal vacante. Las funciones permiten también la intercepción y proceso por los programas en SuperBASIC de los errores del sistema de ficheros.
Comandos
OPEN #canal,nombre abre un fichero para lectura/escritura
OPEN_IN #canal,nombre abre un fichero sólo para lectura
OPEN_NEW #canal,nombre abre un nuevo fichero
OPEN_OVER #canal,nombre abre un nuevo fichero y, si existe, lo sobrescribe
OPEN_DIR #canal,nombre abre un directorio
CLOSE #canales cierra canales
Funciones
FTEST (nombre) revisa el estado de un fichero
FOPEN(#canal,nombre) abre un fichero para lectura/escritura
FOP_IN(#canal,nombre) abre un fichero sólo para lectura
FOP_NEW(#canal,nombre) abre un nuevo fichero
FOP_OVER(#canal,nombre) abre un nuevo fichero y, si existe, lo sobrescribe
FOP_DIR(#canal,nombre) abre un directorio
Sección 11 Información de Ficheros
El Toolkit II tiene un grupo de funciones para leer la información de la cabecera de un fichero.
Comandos
FLEN(#canal) devuelve la longitud del fichero
FTYP(#canal) devuelve le tipo de fichero
FDAT(#canal) devuelve el espacio de datos del fichero
FXTRA(#canal) devuelve la información extra del fichero
FNAME$(#canal) devuelve el nombre del fichero
FUPDT(#canal) devuelve la fecha de actualización del fichero
Sección 12 Acceso Directo a los Ficheros
El Toolkit II tiene un grupo de comandos para transferir datos hacia y desde cualquier parte de un fichero. Los comandos leen o escriben ellos mismos datos "crudos", tanto en forma de bytes individuales como en el formato interno del SuperBASIC (entero, coma flotante o cadena).
Comandos
BGET #canal,ítems toma bytes de un fichero
BPUT #canal,ítems pone bytes en un fichero
GET #canal,ítems toma datos de un fichero en formato interno
PUT #canal,ítems pone datos en un fichero en formato interno
TRUNCATE #canal interrumpe un fichero
FLUSH #canal restaura la memoria intermedia de un fichero
Funciones
FPOS(#canal) devuelve la posición en el fichero
Sección 13 Conversiones de Formato
El Toolkit II aporta un número de facilidades para entradas y salidas formateadas. Se incluyen conversiones de números binarios y hexadecimales, así como formato fijo de decimales.(nd=número de decimales)
Comandos
PRINT_USING #canal,formato salida en formato fijo
Funciones
FDEC$(valor,campo,nd) formato fijo decimal
IDEC$(valor,campo,nd) ídem
CDEC$(valor,campo,nd) ídem
FEXP$(valor,campo,nd) formato fijo exponencial
HEX$(valor,número de bits) conversión a hexadecimal
BIN$(valor,número de bits) conversión a binario
HEX(cadena hexadecimal) hexadecimal a valor
BIN(cadena binaria) binario a valor
Sección 14 Control de la Pantalla
El Toolkit II tiene comandos para activar y desactivar el cursor, para seleccionar la fuente y tamaño de caracteres y para restaurar las ventanas al estado en que se encuentran cuando se conecta el aparato.(d=dirección)
Comandos
CURSEN #canal activa el cursor
CURDIS #canal desactiva el cursor
CHAR_USE #canal,d1,d2 selecciona o reinicializa la fuente de caracteres
CHAR_INC #canal,inc x,inc y selecciona los incrementos x e y de los caracteres
WMON modo reinicializa a monitor
WTV modo reinicializa a televisión
Sección 15 Administración de la Memoria
El Toolkit II tiene un grupo de comandos y funciones que aportan facilidades para la administración de la memoria del área de la "pila común" del QL.
Funciones
FREE_MEM devuelve la cantidad de memoria libre
ALCHP(número de bytes) reserva espacio en la pila común (devuelve la dirección de la base del espacio)
Comandos
RECHP dirección base devuelve espacio a la pila común
CLCHP limpia todas las reservas en la pila común
DEL_DEFB borra de la pila común los bloques de definiciones de ficheros
Sección 16 Parámetros de los Procedimientos
Cuatro son las funciones que tiene el Toolkit II para mejorar la manipulación de los parámetros de los procedimientos (y funciones). Usándolos es posible determinar el tipo (entero,coma flotante o cadena) y el uso (valor simple o matriz) de un parámetro de llamada así como su "nombre".
PARTYP(nombre) devuelve el tipo de parámetro
PARUSE(nombre) devuelve el uso del parámetro
PARNAM$(número de parámetro) devuelve el nombre del parámetro
PARSTR$(nombre,número de parámetro) si el parámetro "nombre" es una cadena, devuelve su valor, si no, encuentra la cadena
Sección 17 Manipulación de Errores
Se aportan las siguientes facilidades para el proceso de errores en las versiones JS y MG del SuperBASIC.
ERR_DF verdadera si ha ocurrido el error de disco lleno
REPORT #canal,número de error informa de un error
CONTINUE número de línea continua en la línea dada
RETRY número de línea vuelve a la línea dada
Sección 18 Mantenimiento del Tiempo
Con el Toolkit II se proveen dos relojes, un reloj digital configurable, y un reloj-alarma.
CLOCK #canal,formato reloj con formato variable
ALARM horas,minutos reloj-alarma
Sección 19 Extras
EXTRAS lista las facilidades extras conectadas al SuperBASIC
TK2_EXT refuerza las definiciones del Toolkit II para los comandos y funciones comunes
Además del las extensiones al intérprete de SuperBASIC, el Toolkit II tiene otras que afectan a los controladores de consola, de microdrive y de red local.
Sección 20 Controlador de Consola
El Toolkit II posibilita la recuperación de la última linea tecleada en el canal de comandos (#0) así como la asignación de una cadena de caracteres a la pulsación de <ALT> y un carácter.
También, para las versiones de ROM MG, corrige los problemas que hay con los comandos para el dibujo de puntos (POINT), líneas (LINE) y arcos (ARC) cortos en dichas ROMs.
Comandos
<ALT><ENTER> Pulsación que recupera la última línea tecleada
ALTKEY carácter,cadena asigna una cadena a una pulsación de <ALT> y un carácter
Sección 21 Controlador de Microdrive
El Toolkit II mejora el controlador de microdrive para proveerle de apertura (OPEN) de ficheros con sobrescritura, además de truncado (TRUNCATE) y renombrado (RENAME) de ficheros. Estas facilidades son soportadas tanto a nivel de QDOS (Traps #2 y #3) como de SuperBASIC. La operación FLUSH se encuentra reespecificada para actualizar la cabecera del fichero además de nivelar los amortiguadores.
Sección 22 Controlador de Red Local
El controlador de Red Local ha sido mejorado para proveer de una primitiva forma de comunicación de emisión, así como de un programa "servidor de ficheros" compacto el cual permite a varios QLs compartir un sistema de disco o una impresora.
Comandos
FSERVE invoca al "servidor de ficheros"
NFS_USE nombre,nombres de red local selecciona el nombre del servidor de ficheros en red local
Nombres de dispositivos
Nnúmero de estación_dispositivo el nombre de un dispositivo remoto de entradas y salidas (p. ej., N2_FLP1_ es el disco 1 de la estación de red local 2)
| Anterior | Índice de Materias | Siguiente |
| Introducción | Editando Ficheros |