Sintaxe

FIELDPUT( <expressão numérica>, <expressão> )

Propósito

Atribui um valor ou o resultado de uma expressão para um campo, de acordo com a sua posição dentro do arquivo de dados em uso.

Argumentos

<expressão numérica>

Define um número inteiro correspondente à posição ordinal do campo desejado dentro do arquivo de dados em uso, na área de trabalho selecionada. Se for especificado 1, o novo conteúdo será atribuído ao primeiro campo do arquivo, se for 2, o segundo, e assim por diante.

<expressão>

Define o valor a ser atribuído como conteúdo do campo especificado. O valor especificado deve estar de acordo com o tipo de dado do campo correspondente. Caso contrário, ocorrerá erro de atribuição.

Utilização

Caso o campo especificado não exista na estrutura do arquivo de dados, a função retornará o valor NIL (nulo).

A função FIELDGET() é o inverso da função FIELDPUT().

Exemplos

LOCAL cCampo := FIELD(1)       // Obtém o nome do primeiro campo

&cCampo := “AdvPL”     // Atribui o conteúdo “AdvPL” ao primeiro campo do arquivo de dados

// A instrução acima equivale à

FIELDPUT(1, “AdvPL”)