CREATE SELECTION FROM ARRAY
CREATE SELECTION FROM ARRAY ( tabela : Table ; regArray : Integer, Boolean array {; temp : Text} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| tabela | Table | → | Tabela da qual criar a seleção |
| regArray | Integer, Boolean array | → | 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 | Text | → | Nome da seleção temporal a criar, ou Aplicar o comando a seleção atual se o parâmetro se omite |
Histórico
| Versão | Alterações |
|---|---|
| 6.7 | Modificado |
| <6 | Criado |
Descrição
O comando CREATE SELECTION FROM ARRAY cria a seleção selectionName 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 selectionName.
Cuidado: Uma seleção nomeada é criada e carregada na memória. Portanto, tenha certeza de ter memória suficiente antes de executar o comando.
Se não passar selectionName ou se passar uma string 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 selectionName. Se um número for 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 selectionName. 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.
Aviso: Lembre que um número de registro pode ser reutilisado se o registro for apagado e outro registro for criado (ver Sobre Números de Registros).
Gestão de erros
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
COPY NAMED SELECTION
CREATE SET FROM ARRAY
LONGINT ARRAY FROM SELECTION
SELECTION TO ARRAY
USE NAMED SELECTION
Propriedades
| Número do comando | 640 |
| Thread-seguro | yes |
| Modificar variáveis | error |
| Modificar a seleção atual |