DELETE FROM LIST
DELETE FROM LIST ( {* ;} lista ; refElem | * {; *} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | → | Se especificada, lista é um nome de objeto (cadeia) Se omitida, lista é um número de referência de lista |
| lista | Integer, Text | → | Número de referência de lista (se omitida *) ou Nome do objeto de tipo lista (se passada *) |
| refElem | * | Inteiro longo, Operador | → | Número de referencia do elemento, ou 0 para o último elemento adicionado à lista ou * para o elemento da lista atualmente selecionada |
| * | Operator | → | Se especificada, apaga as sub-listas (se existem) da memória Se omitida, as sub-listas (se existem) não são apagadas |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando DELETE FROM LIST apaga o elemento designado pelo parâmetro refElem da lista cujo número de referência se passa em lista.
Se passa o primeiro parâmetro opcional *, indica que o parâmetro lista é um nome de objeto (cadeia) correspondente a uma representação de lista no formulário. Se não passar este parâmetro, indica que o parâmetro lista é uma referencia de lista hierárquica (refLista). Se utilizar uma só representação de lista ou trabalha com todos os elementos (passa o segundo *), pode utilizar qualquer uma das duas sintaxes. Pelo contrário, se utilizar várias representações da mesma lista e trabalha com os elementos visíveis (o segundo * é omitido), a sintaxe baseada no nome do objeto é necessária já que cada representação pode ter sua própria configuração exibida/contraída.
Se passar * em refElem, apaga o elemento atualmente selecionado na lista. Igualmente pode passar 0 neste parâmetro para apagar o último elemento adicionado à lista.
Do contrário, especifique o número de referência do elemento que deseja apagar. Se o número não corresponde a nenhum elemento da lista, o comando não faz nada.
Se trabalhar com os números de referência dos elementos, construa uma lista na qual os elementos tenham números de referência únicos, do contrário não poderá distinguir os elementos. Para maior informação, consulte a descrição do comando APPEND TO LIST.
Sem importar que elemento apague, deve especificar o parâmetro opcional * para permitir a 4D apagar automaticamente a sub-lista associada ao elemento, se as houver. Se não especificar o parâmetro *, é uma boa idéia obter previamente o número de referência da sub-lista (se houver) associada ao elemento, de maneira que pode ser apagado, se for necessário, utilizando o comando CLEAR LIST.
Exemplo
O código a seguir apaga o elemento selecionado da lista hList. Se o elemento tiver uma sub-lista associada for apagada (como também toda sub-sub lista):
DELETE FROM LIST(hList;*;*)