OrdCreate
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
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas