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

FCount

FCount() --> nRet

Conta os campos da área, não os registros.

FCountAdvPL
01 · VISÃO GERAL

Visão geral

FCount consulta a estrutura da área ativa e retorna o número de campos. Não depende de somar registros e não substitui LastRec. O fonte comunitário seleciona SA1 antes da chamada; a adaptação qualifica explicitamente a tabela própria e não muda a área do chamador para consultar o metadado. 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

FCount() --> nRet

Retorno

Número de campos da estrutura.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed379()
    // Consultar metadado sem percorrer registros.
    If Select("EDTRB") > 0
        ConOut(cValToChar(EDTRB->(FCount())))
    EndIf
Return Nil
Resultado esperado

Quantidade conforme estrutura de EDTRB; nenhuma contagem de linhas. 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. FCount. TDN. Consulta em 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Acesso a Dados/fCount.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