4D v12.4
SELECTION TO ARRAY
- Manual de lenguaje 4D
-
- Arrays
-
- Arrays
- Creación de arrays
- Arrays y objetos de formulario
- Áreas de desplazamiento agrupadas
- Arrays y el lenguaje 4D
- Arrays y punteros
- Utilizar el elemento cero de un array
- Arrays de dos dimensiones
- Arrays y memoria
- APPEND TO ARRAY
- ARRAY BOOLEAN
- ARRAY DATE
- ARRAY INTEGER
- ARRAY LONGINT
- ARRAY PICTURE
- ARRAY POINTER
- ARRAY REAL
- ARRAY STRING
- ARRAY TEXT
- ARRAY TO LIST
- ARRAY TO SELECTION
- BOOLEAN ARRAY FROM SET
- COPY ARRAY
- Count in array
- DELETE FROM ARRAY
- DISTINCT VALUES
- Find in array
- INSERT IN ARRAY
- LIST TO ARRAY
- LONGINT ARRAY FROM SELECTION
- MULTI SORT ARRAY
- SELECTION RANGE TO ARRAY
- SELECTION TO ARRAY
- Size of array
- SORT ARRAY
SELECTION TO ARRAY
| SELECTION TO ARRAY ( campo ; array {; campo ; array} {; campo2 ; array2 ; ... ; campoN ; arrayN} ) | ||||||||
| Parámetro | Tipo | Descripción | ||||||
| campo | Campo, Tabla |
|
Campo a utilizar para recuperar datos o Tabla a utilizar para recuperar números de registros | |||||
| array | Array |
|
Array para recibir valores de campos o números de registros | |||||
| campo | Campo |
|
Campo a recuperar en el array | |||||
| array | Array |
|
Array que recibe los valores del campo | |||||
El comando SELECTION TO ARRAY crea uno o más arrays y copia los valores en los campos o los números de registro de la selección actual en los arrays.
El comando SELECTION TO ARRAY se aplica a la selección actual de la tabla designada por el primer parámetro (nombre de tabla o nombre de campo). SELECTION TO ARRAY, puede realizar las siguientes operaciones:
- Cargar los valores de uno o varios campos.
- Cargar los números de los registros utilizando la sintaxis [tabla];array
- Cargar los valores de los campos relacionados, si hay una relación automática Muchos a Uno entre las tablas o que haya llamado previamente el comando SET AUTOMATIC RELATIONS para hacer automáticas las relaciones manuales Muchos a Uno. En ambos caso, los valores se cargan de tablas a través de varios niveles de relaciones Muchos a Uno.
Cada array es definido de acuerdo al tipo de campo. Hay dos excepciones:
- En modo compatibilidad ASCII (no Unicode), si un campo de tipo Texto se copia en un array Alfa, el array seguirá siendo de tipo Alfa.
- La copia de un campo de tipo Hora en un array, provoca la creación de un array Entero largo.
Si carga los números de registro, se copian en un array de tipo Entero largo.
4D Server: el comando SELECTION TO ARRAY se optimiza para 4D Server. Cada array se crea en el servidor y luego se envía, en su totalidad, al equipo cliente.
Advertencia: el comando SELECTION TO ARRAY puede crear arrays grandes, dependiendo del rango especificado en inicio y fin, y del tipo y tamaño de los datos a cargar. Los arrays residen en memoria, de tal manera que es una buena idea probar el resultado después de la ejecución del comando. Para hacer esto, pruebe el tamaño de cada array resultante o utilice un método de proyecto ON ERR CALL.
Nota: después de un llamado a SELECTION TO ARRAY, la selección y el registro actual no son modificados, pero el registro actual no se carga. Si necesita utilizar los valores de los campos del registro actual, utilice el comando LOAD RECORD después del comando SELECTION TO ARRAY.
En el siguiente ejemplo, la tabla [Personas] tiene una relación automática con la tabla [Empresas]. Los dos arrays asApellido y asEmpresaDir son dimensionados de acuerdo al número de registros seleccionados en la tabla [Personas] y contienen la información de ambas tablas:
SELECTION TO ARRAY([Personas]Apellido;asApellido;[Empresa]Direccion;asEmpresaDir)El siguiente ejemplo devuelve el número de registros de la tabla [Clientes] en el array alNumerosRegistros y los valores del campo [Clientes]Nombres en el array asNombres:
SELECTION TO ARRAY([Clientes];alNumerosRegistros;[Clientes]Nombres;asNombres)
Producto: 4D
Tema: Arrays
Número
260
Creado por: < 4D v6
ARRAY TO SELECTION
MULTI SORT ARRAY
ON ERR CALL
SELECTION RANGE TO ARRAY
SET AUTOMATIC RELATIONS
