CREATE SELECTION FROM ARRAY

4D v16.3


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

Parámetro	Tipo	Descripción
tabla	Tabla	Tabla de la cual crear la selección
regArray	Entero largo, Array booleano	Array de números de registros, o Array de booleanos (True = el registro está en la selección, False = el registro no está en la selección)
temp	Cadena	Nombre de la selección temporal a crear, o Aplicar el comando a la selección actual si el parámetro se omite

Descripción

El comando CREATE SELECTION FROM ARRAY crea la selección temporal temp a partir de:

un array de números de registros absolutos regArray de tabla,
o de un array de booleanos. En este caso, los valores del array indican la pertenencia (True) o no (False) de cada registro de tabla a la selección temp.

Si no pasa temp o si pasa una cadena vacía, el comando será aplicado a la selección actual, la cual será entonces actualizada.

Cuando usted utiliza un array de enteros largos con este comando, todos los números del array representan la lista de números de los registros en temp. Si un número es incorrecto (registro no creado), se genera el error -10503.

Nota: atención, debe asegurarse de que el array no contenga líneas que tengan el mismo valor, de lo contrario la selección resultante será incorrecta.

Cuando usted utiliza un array booleano con este comando, el elemento X del array indica si el registro número X es (True) o no (False) en temp. El número de elementos en regArray debe ser igual al número de registros en tabla. Si el array es más pequeño que el número de registros, sólo los registros definidos por el array pueden hacer parte de la selección.

Nota: con un array de booleanos, el comando utiliza elementos del número 0 al X-1.

Gestión de errores

Si un número de registro no es válido (registro no creado), se genera el error -10503. Puede interceptar este error con la ayuda de un método instalado por el comando ON ERR CALL.

Ver también

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