4D Doc Center : CREATE SELECTION FROM ARRAY

4D v14.3

CREATE SELECTION FROM ARRAY


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	cadeia	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.