Árvore de páginas

Cria um novo índice para a área de trabalho ativa.

Sintaxe

OrdCreate( < cIndexFile >, [ cIndexTag ], < cExprKey >, [ bExprKey ], [ lUnique ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cIndexFile

caractere

Indica o nome do arquivo de índice que será criado

X


cIndexTag

caractere

Indica o nome da ordem de índice a ser criada (**)



cExprKey

caractere

Expressão das chaves do índice que será criado na forma de string.

X


bExprKey

bloco de código

Expressão das chaves do índice que será criado na forma executável.



lUnique

lógico

Caso especificado como .T. (verdadeiro), o índice criado é de "chave única" – não permite a mesma chave de busca para mais de um registro.



Retorno

Nome

Tipo

Descrição

uRet

nil

Retorno sempre é nulo.

Observações

  • O comportamento e funcionalidade da função OrdCreate(), quando não informado o parâmetro cIndexTag, é exatamente igual à função DBCreateIndex().
  • (**) Quando utilizado um Driver e/ou RDD de dados que permite múltiplas ordens de indexação (ou TAGs) em um arquivo de índice, podemos informar em <cIndexTag> o nome da TAG da ordem de indice que será aberta e acrescentada na lista de ordens abertas no alias / área de trabalho ativa.
  • (**) O suporte a criação de múltiplos indices dentro do mesmo arquivo de índice é um recurso presente exclusivamente em Drivers e RDDs ISAM, que utilizam arquivos físicos em disco para armazenamento das tabelas e índices, onde cada tabela e cada índice é um arquivo no disco. Este recurso é obsoleto, e foi mantido apenas por compatibilidade.
  • (**) Os DRivers implementados no AdvPL que tem suporte mantido por compatibilidade ao uso de TAG em índice são : DBFCDXADS (Obsoleto) , CTREECDX, SQLITE e SQLITECLI.

Veja também

  • Sem rótulos