Histórico da Página

Sintaxe

FIELDBLOCK( <nome do campo> )

Propósito

Fornece um bloco de código que atribui um valor ou lê o conteúdo de um campo do arquivo de dados corrente.

Argumentos

<nome do campo>

Define o nome do campo ao qual o bloco de código se referirá. O nome do campo deve ser especificado como uma cadeia de caracteres.

Utilização

A função FIELDBLOCK() cria um bloco de código relacionado ao campo de um arquivo de dados em uso. Quando este bloco de código for executado com um argumento, atribuirá o valor do argumento ao campo especificado. Quando o bloco de código criado for executado sem argumento, o conteúdo do campo especificado será lido ou recuperado.

Exemplos

O bloco de código criado pela função FIELDBLOCK() equivale ao criado através do operador macro, conforme exemplo abaixo:

dbSelectArea(“TRB”)

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

// A instrução acima equivale à

bBloco := FIELDBLOCK(“cCampo”)

Embora a definição do bloco de código através do operador macro seja equivalente, a utilização da função FIELDBLOCK() é mais simples, em termos de programação, e mais eficiente e rápida em termos de execução do programa.

Suponhamos que o conteúdo do campo A1_NOME seja “José Correia Neto”. Com base nessa premissa, vejamos o exemplo abaixo.

LOCAL bBloco := FIELDBLOCK(“SA1->A1_NOME”)          // Cria o bloco de código

MsgAlert( EVAL(bBloco) )     // Retorna “José Correia Neto”