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

Field

Field( nPos ) --> cRet

Obtém o nome de um campo pela posição ordinal.

FieldAdvPL
01 · VISÃO GERAL

Visão geral

Field começa em posição 1, não considera campos internos Recno/Deleted e tem comportamento equivalente a FieldName. Uma posição acima da quantidade de campos retorna string vazia; falta de área pode produzir erro recuperável. O exemplo comunitário usa posição fixa de SA1. A adaptação testa a existência de campos antes de consultar o primeiro, sem presumir qual nome será retornado. 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

Field( nPos ) --> cRet

Parâmetros

nPos
NuméricoObrigatório

Posição do campo, começando em 1.

Retorno

Nome do campo ou string vazia nos casos documentados.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed382()
    If Select("EDTRB") > 0
        // Estrutura pode ter quantidade de campos diferente da amostra.
        If EDTRB->(FCount()) > 0
            ConOut(EDTRB->(Field(1)))
        EndIf
    EndIf
Return Nil
Resultado esperado

Nome do primeiro campo da estrutura própria, não o seu conteúdo. 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. Field. TDN. Consulta em 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Acesso a Dados/Field.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