4D v16.3

CREATE SELECTION FROM ARRAY

Página Inicial

 
4D v16.3
CREATE SELECTION FROM ARRAY

CREATE SELECTION FROM ARRAY 


 

CREATE SELECTION FROM ARRAY ( tabela ; regArray {; temp} ) 
Parâmetro Tipo   Descrição
tabela  Tabela in Tabela da qual criar a seleção
regArray  Inteiro longo, Array booleano in 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  String in Nome da seleção temporal a criar, ou Aplicar o comando a seleção atual se o parâmetro se omite

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.

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.



Ver também 

CLEAR NAMED SELECTION
Convenções
COPY NAMED SELECTION
CREATE SET FROM ARRAY
LONGINT ARRAY FROM SELECTION
USE NAMED SELECTION

 
PROPRIEDADES 

Produto: 4D
Tema: Seleção
Número 640

Este comando modifica a variável sistema ErrorO comando altera a seleção atualThis command can be run in preemptive processes

 
HISTÓRIA 

Modificado: 4D v6.7

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)