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

DBStruct

DBStruct() --> aStruct

Obtém a estrutura física exposta pelo RDD.

DBStructAdvPL
01 · VISÃO GERAL

Visão geral

DBStruct retorna um array de campos com nome, tipo, tamanho e decimais. Essa estrutura não representa sozinha regras SX3, validações, compartilhamento ou índices. A documentação usa tamanho 10 como compatibilidade para memo; não é limite de conteúdo do campo. O exemplo apenas conta descritores, sem ler registros nem reconstruir uma tabela de produção. EDTRB identifica exclusivamente uma tabela própria de teste, já aberta com a estrutura e os direitos necessários; os exemplos não se destinam a tabelas padrão. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

DBStruct() --> aStruct

Retorno

Array de arrays: nome, tipo, tamanho e decimais por campo.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed342()
    Local aCampos
    If Select("EDTRB") > 0
        aCampos := EDTRB->(DBStruct())
        ConOut(cValToChar(Len(aCampos)))
    EndIf
Return Nil
Resultado esperado

Quantidade de campos descritos pelo RDD; varia com a tabela. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir RDD, alias e operações pendentes. Navegação pode efetivar atualizações; preservar contexto conforme o contrato do chamador e tratar erros na rotina completa.
  • 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. DBStruct. TDN. 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