CREATE SET FROM ARRAY

4D v15 R2


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

Parámetro	Tipo	Descripción
tabla	Tabla	Tabla del conjunto
arrayReg	Entero largo, Array booleano	Array de número de registros o Array de booleanos (True = el registro está en el conjunto, False = el registro no está en el conjunto)
nomConjunto	Cadena	Nombre del conjunto a crear o Aplicar el comando a Userset si se omite

Descripción

El comando CREATE SET FROM ARRAY crea nomCon a partir de:

Un array de número de registros absolutos arrayReg de la tabla tabla,
o un array de booleanos arrayReg. En este caso, los valores del array indican si cada registro en la tabla pertenece (True) o no (False) a nomCon.

Cuando utilice este comando y pasa un array entero largo en arrayReg, todos los números en el array representan la lista de números de registros que está en nomCon. Si un número es inválido (por ejemplo, si un registro no ha sido creado), se genera el error -10503.

Cuando utilice este comando y pase un array booleano en arrayReg, el elemento N del array indica si el registro "N" está (True) o no (False) en nomCon. En principio, el número de elementos del array debe ser igual al número de registros en la tabla. Si el array es más pequeño que el número de registros, sólo los registros definidos por el array estarán en el conjunto.

Nota: con un array de booleanos, el comando utiliza los elementos 0 a N-1.

Si no pasa el parámetro nomCon o si pasa una cadena vacía, el comando se aplica al conjunto sistema Userset.

Gestión de errores

En un array de enteros largos, si un número de registro no es válido (registro no creado), se genera el error -10503.

Ver también

BOOLEAN ARRAY FROM SET
Convenciones
CREATE SELECTION FROM ARRAY