New list
New list : Integer
Parâmetro | Tipo | Descrição | |
---|---|---|---|
Resultado | Integer | ← | Número de referência de lista |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
New list cria uma nova lista hierárquica vazia em memória e retorna seu número de referência único.
Advertência: as listas hierárquicas residem na memória. Quando terminar de utilizar uma lista hierárquica, é importante apagá-la para liberar memória, utilizando o comando CLEAR LIST.
Outros comandos lhe permitem criar listas hierárquicas:
- Copy list duplica uma lista existente.
- Load list cria uma nova lista carregando uma lista criada (manualmente ou por programação) no editor de listas do ambiente Desenho.
- BLOB to list cria uma lista a partir do conteúdo de um BLOB no qual uma lista foi previamente guardada.
Quando tiver criado uma lista hierárquica utilizando New list, pode:
- Adicionar itens a essa lista, utilizando o comando APPEND TO LIST ou INSERT IN LIST.
- Apagar itens dessa lista, utilizando o comando DELETE FROM LIST.
Exemplo
Ver o exemplo do comando APPEND TO LIST.
Ver também
APPEND TO LIST
BLOB to list
CLEAR LIST
Copy list
DELETE FROM LIST
INSERT IN LIST
LIST TO BLOB
Load list