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

IndRegua

IndRegua(cAlias,cIndice,cExpress,[xOrdem],[cFor],[cMens],[lExibir])

Cria índice temporário com filtro no modelo histórico.

IndReguaAdvPL
01 · VISÃO GERAL

Visão geral

O manual descreve alias, arquivo de índice, expressão, ordem opcional, filtro, mensagem e indicador de exibição. xOrdem igual a D indica descendente. Esse contrato é histórico e depende da RDD; não equivale à criação de índice SQL permanente. O exemplo só prepara um bloco para alias e nome de índice exclusivos do ambiente de teste. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

IndRegua(cAlias,cIndice,cExpress,[xOrdem],[cFor],[cMens],[lExibir])

Parâmetros

cAlias
CaractereOpcional

Alias da tabela de trabalho.

cIndice
CaractereObrigatório

Nome exclusivo do arquivo de índice de teste.

cExpress
CaractereObrigatório

Expressão de chave.

xOrdem
CaractereOpcional

D para descendente, segundo o manual.

cFor
CaractereOpcional

Expressão de filtro.

cMens
CaractereOpcional

Mensagem de progresso.

lExibir
LógicoOpcional

Controla exibição de progresso.

Retorno

NIL, conforme a assinatura do manual histórico.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed488()
    // ED_COD deve existir na tabela de trabalho preparada.
    Local bIndex := {|cAlias,cIndex| IndRegua(cAlias,cIndex,"ED_COD",,"!Empty(ED_COD)",,.F.)}
    ConOut(ValType(bIndex))
Return Nil
Resultado esperado

Nenhum índice é criado até a chamada explícita do bloco. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Definir abertura, seleção, fechamento e descarte do índice no ciclo da tabela temporária; conferir comportamento TOPCONN.
  • 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. Waterloo Ferreira da Silva. AdvPL — O Manual, versão 1.0; p. 352. Referência histórica. Consulta em 2026-10-27.
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