4D Doc Center : CREATE SET FROM ARRAY

4D v14.3

CREATE SET FROM ARRAY


CREATE SET FROM ARRAY ( tabela ; arrayReg {; nomConjunto} )

Parâmetro	Tipo	Descrição
tabela	Tabela	Tabela do conjunto
arrayReg	Inteiro longo, Array booleano	Array de números de registrs, ou Array de booleanos (True = o registro está no conjunto, False = o registro não está no conjunto)
nomConjunto	cadeia	Nome do conjunto a criar, ou Aplicar o comando ao UserSet se omitido

Descrição

O comando CREATE SET FROM ARRAY cria nomConj a partir de:

seja um array de número de registros absolutos arrayReg da tabela tabela,
ou um array de booleanos arrayReg. Neste caso, os valores do array indicam se cada registro na tabela pertence (True) ou não (False) a nomCon.

Quando utilize este comando e passa um array inteiro longo em arrayReg, todos os números no array reapresentam a lista de números de registros que está em nomConjunto. Se um número for inválido (por exemplo, se um registro não tiver sido criado), se gera o erro -10503.

Quando utilizar este comando para passar um array inteiro longo em arrayReg, todos os números no array representam a lista de números de registros que estejam em nomConjunto. Se um número for inválido (por exemplo, se um registro não foi criado), o erro -10503 é gerado.

Quando utilizar este comando para passar um array booleano em arrayReg, um elemento N do array indica se o registro "N" está (True) ou não (False) em nomConjunto. No princípio, o número de elementos do array deve ser igual ao número de registros na tabela. Se o array é más pequeno que o número de registros, apenas os registros definidos pelo array estarão no conjunto.

Nota: com um array de booleanos, o comando utiliza os elementos 0 a N-1.

Se não passar o parâmetro nomConjunto ou se passar uma string vazia, o comando é aplicado ao conjunto sistema Userset.

Gestão de erros

Em um array de inteiros longos, se um número de registro não for válido (registro não criado), se gera o erro -10503.