MACRO SUSTITUCION

 

Concepto y Generalidades

 

En Queen se entiende como macro sustitución  la técnica de remplazar el nombre de una variable por su contenido. La variable puede ser string o numeric. Esta técnica hace muy sencillo el manejo de la impresión de texto formateado con numero. En programación es de gran utilidad, en  cierta clase de programas es indispensable su uso.

 

En este apartado vamos a ver en detalle como funciona y cuales son sus beneficios.

 

Comando macro:

Las opciones del comando macro que es que maneja la macro sustitución son:

·         on: Activa ambas sustituciones (valor por defecto)

·         off: Desactiva ambas sustituciones.

·         stron:Activa la sustitución string

·         stroff: Desactiva la sustitución string

·         numon:Activa la sustitución numérica

·         numoff:Desactiva la sustitución numérica

·          strnum: Hace que se realice la sustitución string primero

·         numstr: Hace que se realiza la sustitución numérica primero

 

Sustitución Numérica.

Una variable numérica tiene una precisión  de 16 dígitos decimales. Los cálculos internos siempre se realizan usando toda la precisión. En cambio para visualizarse,  la precisión esta determinada por el numero de decimales establecido por el comando deci. Una variable numérica se puede visualizar (el contenido) simplemente ejecutando su nombre como un comando. De hecho Queen siempre evalúa como una expresión numérica cualquier entrada que no conoce (antes de evaluarse se le aplica ambas sustituciones). El resultado es  mostrado en la barra de estado.

 

Otra forma de visualizar el contenido de una variable es usando el comando list, que muestra en una ventana todas las variables que actualmente Queen tiene en memoria. Y la mejor forma es usando macro sustitución. La macro sustitución numérica  puede ser activa y desactivada usando el comando macro.  Cuando esta desactivada, ningún patrón de sustitución numérica es convertido.

 

Cuando la sustitución numérica esta activada, todo patrón que use el carácter tilde (~)  se interpreta como un patrón de sustitución numérica, y siempre funciona en parejas de limitando la expresión que debe se sustituida por su valor numérico. Cualquier cosa que se encuentre entre el símbolo de sustitución numérica es evaluada como una expresión numérica, y su resultado es remplazado por el patrón completo de sustitución. Por esta razón si la expresión falla en la evolución, un error es reportado.

 

La sustitución numérica siempre se realiza después de la sustitución string, esto significa que si un string es sustituido, también serán sustituidos sus formatos de sustitución numérica internos, claro; asumiendo que la sustitución numérica esta activada.

 

No es posible usar dos sustituciones  numéricas inmediatas, deben de estar separadas por lo menos por un carácter, incluso el espacio.

Este caso es mostrado en el siguiente ejemplo, en donde los símbolos de sustitución adyacentes son convertidos a uno solo (~~=~) en la primera impresión, y en la segunda  el resultado es como lo esperamos.

 

 

La salida de este ejemplo es la siguiente:

 

Si la sustitución es una sola, es posible usar nada mas el primer símbolo. En tal caso todo el resto hacia la derecha del símbolo es considerado la expresión a evaluar.

El otro caso cuando solo el símbolo del final se usa, este es ignorado.

Estos dos casos se muestran en el siguiente ejemplo.

 

La sustitución numérica nunca (ni la string)  es ejecutada en una constante string[1]. El siguiente ejemplo demuestra esto. El comando strln aplica sustitución automáticamente.

 

 

Como se puede verse en la salida aquí abajo, las variables:

 

Por defecto, todas ambas sustituciones están activadas y la sustitución string se realiza antes que la numérica.

 

 

La sustitución numérica es muy útil en programación para crear variables en un numero indefinido y que los nombres no se repitan.

 

A continuación se desarrollan una serie de ejemplos para demostrar la aplicación

Estúdiense los siguientes ejemplos:

 

La forma mas sencilla de convertir un string a numero

 

 Otro ejemplo:

 

Lo que sucede en estas asignaciones es que la expresión  de la derecha se le aplica la macro sustitución string,  quedando expuesta la expresión numérica resultante y  que es evaluada como una expresión. Esto funciona ya que la variable x se encuentra definida, de encontrarse alguna variable no definida o un error en la definición de la expresión  resultante, se presentaría un error.

 

Otro ejemplo:

Analizando el ejemplo anterior, a la expresión de la derecha en la asignación de y1, se le aplica la sustitución numérica, así que ~x~=10.

 

 

Desarrollo de secuencias usando sustitución

Esta técnica es de especial importancia en la programación. Permite la creación de un numero indeterminado de instancias de un objeto, a partir de una base común.

 

El siguiente ejemplo genera una secuencia con base nombre.

 

 

La salida es:

 

El siguiente ejemplo concatene una secuencia de números en una variable string

La salida en la barra de estado

 

El siguiente ejemplo genera una secuencia x y una secuencia y para evaluar una función de dos variables.

 

La salida es:

 

Desactivando la sustitución numérica

Cuando se desactiva la sustitución numérica, es posible almacenar una cadena de texto con los delimitadores de esta sustitución, sin usando el comando setstr  y no una constante string. La ventaja es que las sustituciones string si se podrían realizar.  Pero si se pretende imprimir la salida con el comando strln o str.

 

El siguiente ejemplo desactiva la sustitución numérica y mantiene activada la sustitución string.

 

La salida es la siguiente:

El comando strln solo pudo sustituir el string var.

 

 

 

Sustitución string

 

La sustitución string es realizada antes de la sustitución numérica, por lo tanto si ambas están activadas, el formato numérico interno de una variable string será convertido también.

Como ya se mencionó,  ninguna sustitución es realizada en una constante string.

 

Por defecto, todas ambas sustituciones están activadas.

La sustitución string puede ser activa y desactivada de dos formas:

1.       Para activar usando el comando: macro on

Este comando activa ambas sustituciones (numérica y string)

2.       Para activar usando el comando: macro stron

Este comando activa exclusivamente a la sustitución string

3.       Para desactivar usando el comando: macro off

Este comando desactiva ambas sustituciones (numérica y string)

4.       Para desactivar usando el comando: macro stroff

Este comando desactiva exclusivamente a la sustitución string

 

Cuando se crean variables string o se transfiere información string desde cualquier fuente a una variable string, si las sustituciones antes mencionadas están activas, siempre  el contenido que se almacenara en la variable string, es pasado por la macro sustitución para su conversión. En muchas ocasiones es deseable mantener activada la macrosustitucion ya que los nombres de la variables que se están usando tienen que convertirse, pero queremos que el contenido transferido no sea chaqueado, por lo tanto no es posible desactivar ninguna de las macrosustituciones en forma general. Para esto casos existen una opción que afecta específicamente al contenido que se esta transfiriendo a una variable string, por defecto esta activa, y es la opción svaron y svaroff, cada uno activa y desactiva cualquier conversión de macrosustitucion en la transferencia de los contenidos de las variables string respectivamente.

El ejemplo típico de uso es usando los componentes.

 

Ejemplo: svar1 es creada a partir de una constante string, por lo tanto no se realizaron las sustituciones.

Saida:

 

El siguiente  ejemplo muestra una sustitución string.

 

 La salida:

 

El siguiente ejemplo realiza la sustitución de los patrones de sustitución numérica dentro de la variable string.

 

La salida:

 

Es posible encadenar variables string usando la sustitución.

Ejemplo:

 

Salida:

 

No es posible realizar una sustitución usando el símbolo tilde uno inmediatamente del otro, deben de están separados por lo menos por un carácter (puede ser un espacio en blanco).

 

El comando  str y strln realiza sustitución si estas están activadas. Pero el comando outsvar toma como parámetro el nombre de una variable string e imprime su contenido sin aplicar sustitución de ningún tipo aun cuando estas estén activadas.

 

Para demostrar el poder de la macro sustitución, el siguiente programa creara tantas ventanas como tu quieras y con los nombres que quieras (no deben contener espacio los nombres de cualquier variable).

 

 

Donde Queen espera formato de macro sustitución:

Las partes donde se puede especificar formatos de macro sustitución son:

·         Los nombres de variables

·         Las expresiones numéricas

·         Especificación de formatos de color

·         Argumentos de los comandos de impresión (presentan información)

·         En los paramentos de algunos comandos como msg, status, etc. En general aquellos comando donde la información que se les pasa es para consumo final o sea, que no va a ser mas procesada, en la mayoría de casos es para presentación.

 

Donde Queen NO espera formato de macro sustitución:

Queen no intenta realizar conversiones en el establecimiento de bloques de comando, tales como los bloques de comandos de los eventos de los componentes, los eventos del timer, las rutinas, en general, todos aquellos donde el contenido son comando que serán ejecutados en determinado momento.

 

Hay ocasiones que los comandos se capturan  o se tienen en una variable, el problema es como usar el contenido de una variable para establecer un bloque de comando,  ya que Queen no intentara convertir el formato de macro. Para estos casos, los objetos que soportan cargar dinámica de bloques de comandos, soportan una opción especifica de recibir el bloque de comandos desde una variable, obteniendo el bloque accesando directamente a la variable en memoria sin pasar el contenido por el conversor de macros.