Histórico da Página

Pagetitle

	OrdCreate
	OrdCreate

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

Sintaxe

Bloco de código

collapse	false

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

Nome	Tipo	Descrição	Obrigatório
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.

Nome	Tipo	Descrição
uRet	nil	Retorno sempre é nulo.

Informações

icon	true
title	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.