CREATE SELECTION FROM ARRAY

4D v18


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 temporal temp 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 temp.

Se não passa temp ou se passa uma cadeia 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 temp. Se um número é 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 temp. 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.

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
Convenções
COPY NAMED SELECTION
CREATE SET FROM ARRAY
LONGINT ARRAY FROM SELECTION
SELECTION TO ARRAY
USE NAMED SELECTION