Instruccion CALL

Propósito:

Para llamar un subprograma de la lengua de la asamblea (o máquina).

Sintaxis:

CALL numvar[(variables)]

Comentarios:

numvar es el punto de partida en la memoria del subprograma que es llamado como compensación en el segmento actual.

las variables son las variables o las constantes, separadas por las comas e incluidas entre paréntesis, que deben ser pasadas a la rutina.

La declaración de CALL se recomienda para los programas de interconexión del lenguaje ensamblador con GW-BASIC. Aunque la función de USR puede también ser utilizada, la CALL es compatible con más idiomas, produce un código de fuente más legible, y puede pasar discusiones múltiples.

La invocación de la declaración de CALL hace ocurrir lo siguiente :

Cada localización del parámetro en la variable es empujado sobre el apilado. La localización del parámetro es un 2-byte compensado dentro del segmento de datos del GW-BASIC.
El segmento de código de return (CS) y la compensación se empujan sobre el apilado.
El control es transferido a la rutina de usuario por la dirección del segmento en la ultima instruccion DEF SEG dada en la instruccion pasada de DEF SEG y la offset(compensación) dadas en el nombre variable.
La rutina de usuario ahora tiene control. Los parámetros pueden ser referidos moviendo el puntero de pila (SP) al indicador bajo (punto de ebullición) y agregando una compensación positiva al punto de ebullición.
La rutina llamada destruira el contenido de cualquier registro.

El programa llamado debe saber cuántos parámetros fueron pasados. Los parámetros son referidos agregando una offset(compensacion) positiva al BP, asumiendo que la rutina llamada movió el puntero de pila actual dentro de BP (es decir, MOV BP,SP).
El programa llamado debe saber el tipo variable para los parámetros numéricos pasados.

La rutina llamada debe hacer un RET n, donde n es el número de parámetros en la variables times 2. Esto es necesario para ajustar el stack(apilado) al punto al principio de la llamada secuencia.

Los valores son vueltos a GW-BASIC incluyendo en la lista de la discusión el nombre de la variable que es recibir el resultado.
Si la discusión es una secuencia, los puntos compensados del parámetro a tres octetos llamaron el descriptor de la secuencia. El octeto 0 del descriptor de la secuencia contiene la longitud de la secuencia (0 a 255). Los octetos 1 y 2, respectivamente, son los pedacitos más bajos y superiores-ocho de la secuencia que comienza la dirección en el espacio de la secuencia.
Si la discusión es un literal de cadena en el programa, el descriptor de la secuencia señala al texto del programa. Tenga cuidado de no alterar o de no destruir un programa esta manera. Para evitar resultados imprevisibles, agregue + "" al literal de cadena en el programa, como en el siguiente:
```
20 A$= " BASIC " + ""
```
esto fuerzan el literal de cadena para ser copiados en el espacio de la secuencia. Ahora la secuencia puede ser modificada sin afectar el programa.

Nota

Las secuencias se pueden alterar por rutinas de usuario, pero su longitud no debe ser cambiada. GW-BASIC no puede borrar correctamente secuencias si sus longitudes son modificadas por rutinas externas.

Para más información sobre la declaración de CALL y la función de USR, vea el apéndice D en la guía del usuario de GW-BASIC.

Ejemplo 1:

100 DEF SEG=&H2000
110 ARK=0
120 CALL ARK(A, B$, C)
.
.

En línea 100 setea el segmento a la hex 2000. La ARK se fija a cero de modo que CALL a la ARK ejecute el subprograma en la localización 2000:0.

Ejemplo 2:

La secuencia siguiente del lenguaje ensamblador 8086 demuestra el acceso de los parámetros pasados y almacenados en C variable:

PUSH BP
MOV BP, SP      ; Gets current stack position in BP.
MOV BX, 8[BP]   ; Gets address of B$ descriptor.
MOV CL, [BX]    ; Gets length of B$ in CL.
MOV DX, 1[BX]   ; Gets address of B$ text in DX.
.
.
.
MOV SI, 10[BP] ; Gets address of A in SI.
MOV DI, 6[BP]   ; Gets pointer to C in DI.
MOVSW           ; Stores variable A in C.
RET 6           ; Restores stack and returns.

MOVSW copia solamente dos octetos. Esto es suficiente si las variables A y C son número entero. Cuatro octetos deben ser copiados si son sola precisión; ocho octetos, si son precisión doble.

Ejemplo 3:

100 DEF SEG=&H2000
110 ACC=&H7FA
120 CALL ACC(A, B$, C)
.
.
.

La línea 100 setea el segmento a hex 2000. El valor de la variable ACC se agrega en la dirección mientras que la palabra baja después de que el valor de DEF SEG se cambie de puesto cuatro bits a la izquierda (ésta es una función del microprocesador, no del GW-BASIC). Aquí, el ACC se fija a &H7FA, de modo que la CALL al ACC ejecute el subprograma en la ubicacion hexadecimal 2000:7 FA (dirección absoluta hex 207FA ).