FIELDBLOCK()

Sintaxis

FIELDBLOCK( <nombre del campo> )

Propósito

Suministra un bloque de código que atribuye un valor o lee el contenido de un campo del archivo de datos corriente.

Argumentos

<nombre del campo>

Define el nombre del campo al que se referirá el bloque de código. El nombre del campo se debe especificar como una cadena de caracteres.

Utilización

La función FIELDBLOCK() crea un bloque de código vinculado al campo de un archivo de datos en uso. Cuando este bloque de código se ejecuta con un argumento, atribuirá el valor del argumento al campo especificado. Cuando el bloque de código creado se ejecuta sin argumento, se leerá o recuperará el contenido del campo especificado.

Ejemplos

El bloque de código creado por la función FIELDBLOCK() equivale al que se creó por medio del operador macro, de acuerdo con el siguiente ejemplo:

dbSelectArea(“TRB”)

bBloco := &( “{ | cValor | IF(cValor == NIL, cCampo, cCampo := cValor) }” )

// La instrucción anterior equivale al

bBloco := FIELDBLOCK(“cCampo”)

Aunque la definición del bloque de código por medio del operador macro sea equivalente, el uso de la función FIELDBLOCK() es más simple, en términos de programación, y más eficiente y rápida en términos de ejecución del programa.

Supongamos que el contenido del campo A1_NOME sea “José Correa Nieto”. Con base en esta premisa, veamos el siguiente ejemplo.

LOCAL bBloco := FIELDBLOCK(“SA1->A1_NOME”)          // Crea el bloque de código

MsgAlert( EVAL(bBloco) )     // Retorna “José Correa Nieto”