CREATE SELECTION FROM ARRAY

4D v20 R7


CREATE SELECTION FROM ARRAY ( tabela ; regArray {; temp} )

Parâmetro	Tipo	Descrição
tabela	Tabela	Tabela da qual criar a seleção
regArray	Inteiro longo, Array booleano	Array de números de registros, ou Array de booleanos (True = o registro está na seleção, False = o registro não está na seleção)
temp	String	Nome da seleção temporal a criar, ou Aplicar o comando a seleção atual se o parâmetro se omite

Descrição

O comando CREATE SELECTION FROM ARRAY cria a seleção selectionName a partir de:

um array de números de registros absolutos regArray de tabela,
ou de um array de booleanos. Neste caso, os valores do array indicam a associação (True) ou não (False) de cada registro de tabela à seleção selectionName.

Cuidado: Uma seleção nomeada é criada e carregada na memória. Portanto, tenha certeza de ter memória suficiente antes de executar o comando.

Se não passar selectionName ou se passar uma string vazia, o comando será aplicado a seleção atual, a qual será então atualizada.

Quando você utiliza um array de inteiros longos com este comando, todos os números do array representam a lista de números dos registros em selectionName. Se um número for incorreto (registro não criado), é gerado o erro -10503.

Nota: atenção, deve ter certeza de que o array não contenha linhas que tenham o mesmo valor, do contrário a seleção resultante será incorreta.

Quando usa um array booleano com este comando, o elemento X do array indica se o registro número X é (True) ou não (False) em selectionName. O número de elementos em regArray deve ser igual ao número de registros em tabela. Se o array é menor que o número de registros, só os registros definidos pelo array podem fazer parte da seleção.

Nota: com um array de booleanos, o comando utiliza elementos do número 0 al X-1.

Aviso: Lembre que um número de registro pode ser reutilisado se o registro for apagado e outro registro for criado (ver Sobre Números de Registros).

Gestão de erros

Se um número de registro não é válido (registro não criado), é gerado o erro -10503. Pode interceptar este erro com a ajuda de um método instalado pelo comando ON ERR CALL.

Ver também

CLEAR NAMED SELECTION
COPY NAMED SELECTION
CREATE SET FROM ARRAY
LONGINT ARRAY FROM SELECTION
SELECTION TO ARRAY
USE NAMED SELECTION