FIELDPUT()
 Estabelece o valor da variável campo usando a posiçao ordinal do campo na
 estrutura do arquivo
------------------------------------------------------------------------------

 Sintaxe

     FIELDPUT(<nCampo>, <expAtrib>) --> valorAtrib

 Argumentos

     <nCampo> é a posiçao ordinal do campo no arquivo de dados corrente.

     <expAtrib> é o valor a ser atribuído ao campo dado.  O tipo de dado
     desta expressao deve obedecer o tipo da variável campo designada.

 Retorno

     FIELDPUT() retorna o valor atribuído ao campo designado.  Se <nCampo>
     nao corresponder a posiçao de qualquer campo do arquivo de dados,
     FIELDPUT() retorna NIL.

 Descriçao

     FIELDPUT() é uma funçao de arquivo de dados que atribui <expAtrib> ao
     campo na posiçao ordinal <nCampo> na área de trabalho corrente.  Esta
     funçao permite estabelecer o valor de um campo usando sua posiçao
     dentro da estrutura do arquivo ao invés de seu nome.  Dentro das
     funçoes genéricas de acesso a arquivos de dados, esta permite entre
     outras coisas, estabelecer o valor de um campo sem o uso de macros.

 Exemplos

     O exemplo a seguir compara FIELDPUT() ao código funcionalmente
     equivalente que usa o macro operador para recuperar o valor do campo:

     // Usando macro operador
     FName := FIELD(nField)              // Obtem nome do campo
     FIELD->&FName := FVal               // Estabelece o valor do campo

     // Using FIELDPUT()
     FIELDPUT(nField, FVal)              // Estabelece valor do campo

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: FIELDGET()