SET UNIQUE*
 Comuta a inclusao de chaves nao-únicas num índice
------------------------------------------------------------------------------

 Sintaxe

     SET UNIQUE on | OFF | <xlComuta>

 Argumentos

     ON faz com que os índices sejam criados com atributo de unicidade.

     OFF faz com que os índices possam ser criados sem atributo de
     unicidade.

     <xlComuta> é uma expressao lógica entre parênteses.  Um valor
     verdadeiro (.T.) é o mesmo que ON, e falso (.F.) é OFF.

 Descriçao

     SET UNIQUE controla se um índice será criado com atributo de unicidade
     ou nao.  Com UNIQUE ON, novos índices sao criados incluindo apenas
     chaves únicas.  Se, durante o processo de indexaçao, dois ou mais
     registros forem encontrados com o mesmo valor de chave, o Clipper
     inclui somente o primeiro registro no índice.  Onde quer que a chave
     seja atualizada, REINDEXada, ou sofra PACK, somente registros únicos
     serao mantidos.  O índice mantém seu atributo de unicidade sem
     importar-se com o SET UNIQUE corrente, o mesmo se tivesse sido criado
     com INDEX ON...UNIQUE.

     Alterar o valor da chave num índice único tem algumas implicaçoes
     importantes.  Primeiro, se uma chave é alterada para um valor de chave
     já existente no arquivo, o registro alterado é perdido no índice.
     Segundo, se houver mais de um caso de um valor chave dentro de um
     arquivo de dados, alterar a chave visível nao traz à tona outro
     registro com a mesma chave quando o índice é reconstruído com REINDEX,
     PACK, ou INDEX...UNIQUE.

     Com UNIQUE OFF, índices sao criados com todos os registros no índice.
     Modificaçoes posteriores aos arquivos de dados adicionam todos os
     valores de chave ao índice, independente do estado de SET UNIQUE.

     SET UNIQUE é um comando de compatibilidade e portanto nao recomendado.
     Ele é superado pela cláusula UNIQUE no comando INDEX.

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: INDEX PACK REINDEX SEEK