Recupera o conteúdo de um campo do registro atualmente posicionado no alias selecionado, a partir da sua posição ordinal na estrutura da tabela.
Sintaxe
xFieldContent := FieldGet( <nFieldPos> )
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência | Observações |
---|---|---|---|---|---|
nFieldPos | N | Número da posição ordinal do campo na tabela. | S | N | Caso o número informado seja menor que 1 ou maior que o número de campos no alias da tabela em questão, a função retorna NIL. |
Retorno
Nome | Tipo | Descrição | Observações |
---|---|---|---|
xFieldContent | * | Retorna o conteúdo do campo informado, na linha atual do alias em uso. | A informação retornada depende do tipo do campo na estrutura da tabela. Para verificar o tipo do retorno após a chamada da função, pode ser usada a função ValType(). Para verificar o tipo do retorno antes da chamada, deve ser verificada a estrutura da rabela através da função DbStruct() |
Observações
Quando uma Query é aberta em um determinado Alias, os campos do tipo "D" Data e "L" lógico são retornados como "C" Caractere, pois no SGDB estes campos normalmente são gravados internamente usando o tipo nativo do SDGB Char() ou VarChar(). Para que os campos de tipo "D" Data e "L" lógico sejam retornados adequadamente no Alias aberto com a Query, é necessário usar a função TcSetField() para estes campos no alias da Query, imediatamente após a abertura da Query.
Exemplos
Exemplo
// Usando FieldGet() no alias corrente DbSelectArea("SA1") cValor := FIELDGET(1) // Usando uma expressão aliasada para recuperar o campo cValor := SA1->(FIELDGET(1)) // Recuperar o campo pelo numero sem usar a FieldGet DbSelectArea("SA1") cCampo := FIELD(1) // Obtém o nome do primeiro campo cValor := &cCampo // Obtém o conteúdo deste campo
Veja também
Fieldget, FieldPut, TCSetField