Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

FieldGet

FieldGet( nPos ) --> xRet

Lê o valor do campo na posição atual do registro.

FieldGetAdvPL
01 · VISÃO GERAL

Visão geral

FieldGet usa posição ordinal, não nome. Posição inválida pode retornar Nil com advertência; tipo depende da estrutura, e queries podem exigir TCSetField para datas/lógicos. O fonte GitHub avança três registros de SA1 e lê o quinto campo sem testar EOF. A adaptação localiza ED_COD por FieldPos e confirma registro válido antes da leitura, sem pressupor posição fixa. Somente o tipo é mostrado. EDTRB é um alias próprio de teste já aberto; ED_COD, quando usado, é campo caractere de tamanho 10 do esquema didático. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

FieldGet( nPos ) --> xRet

Parâmetros

nPos
NuméricoObrigatório

Posição ordinal válida no alias.

Retorno

Conteúdo do campo, conforme seu tipo; Nil nos casos documentados de erro.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed384()
    Local nPosicao
    Local xValor
    If Select("EDTRB") > 0
        nPosicao := EDTRB->(FieldPos("ED_COD"))
        // Nome presente nao basta: o cursor tambem deve ser valido.
        If nPosicao > 0 .And. !EDTRB->(Eof())
            xValor := EDTRB->(FieldGet(nPosicao))
            ConOut(ValType(xValor))
        EndIf
    EndIf
Return Nil
Resultado esperado

Tipo esperado C no esquema de teste; valor do campo não é exposto. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Usar somente tabela própria de teste com estrutura conhecida. Qualificar alias, conferir posição do registro e administrar alterações de contexto conforme o contrato do chamador.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. FieldGet. TDN. Consulta em 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Acesso a Dados/FieldGet.PRW. universo_do_desenvolvedor_site, commit a5c83e9490302bdb4a0fc5a9d92c2d569a60773c. Exemplo analisado. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha