REGIONAL (Comando)
Crea variables y matrices regionales.
#REGION nRegionNumber
REGIONAL VarList
Parámetros
#REGION nRegionNumber
Crea una región. Las variables regionales deben declararse antes de utilizarlas en un programa. Tenga en cuenta que #REGION es una directiva del compilador, no un comando. nRegionNumber especifica un número de región entre 0 y 31.REGIONAL VarList
Declara las variables para la región creada con la directiva #REGION. VarList es una lista de variables y matrices separadas por comas.Durante la compilación del programa, si ya se ha compilado otra variable regional con el mismo nombre, el nombre de la segunda aparición se hará único para asegurar que no hay conflicto con la variable regional declarada previamente.
Un nombre de variable se hace único rellenando el nombre de variable regional con subrayados y el número de región actual hasta completar 10 caracteres. Esta sustitución se realiza totalmente durante la compilación del programa y no afecta en absoluto a la velocidad de ejecución.
Cuando se modifica el nombre de una variable, use DISPLAY MEMORY para mostrar dicho nombre. Para controlar la variable en la ventana Depuración, utilice su nombre de variable modificado. Como la ventana Seguimiento utiliza el código fuente del programa original, aparecerá el nombre original de la variable (no el nombre modificado creado por el compilador) en la ventana Seguimiento.
Observaciones
Las matrices o variables con nombres idénticos no interfieren entre sí si sus valores se protegen dentro de una “región”. Las variables regionales son similares a las variables privadas.
Ejemplo
En el ejemplo siguiente se crean dos conjuntos de variables regionales. En la región 1, se crean las variables gcA, gcB, gcC y gcD, y en cada una de ellas se almacena la cadena de caracteres “Uno”. En la región 2, se crean las variables gcC, gcD, gcE y gcF, y en cada una de ellas se almacena la cadena de caracteres “Dos”. Las variables gcC y gcD son comunes para ambas regiones.
A continuación se muestra el resultado en pantalla desde DISPLAY MEMORY. Se modifican los nombres de las variables gcC y gcD de la segunda región. gcC se convierte en GCC________2 y gcD se convierte en GCD________2. Todas las variables son privadas y se puede tener acceso a ellas con programas de bajo nivel.
#REGION 1
REGIONAL gcA,gcB,gcC,gcD
STORE 'One' to gcA,gcB,cgC,gcD
#REGION 2
REGIONAL gcC,gcD,gcE,gcF && gcC and gcD are common to both regions
STORE 'Two' to gcC,gcD,gcE,gcF
DO showmemory
PROCEDURE showmemory
DISPLAY MEMORY LIKE g*