DLIST

DLIST N

CREATES A SYSTEM OBJECT DLIST AND ALLOCATES IT NUMBER N AS REFERENCE

  • Type: Command
  • Parameter: 1
  • Group: System Objects Creation

ACTION

The command DLIST N creates a system object DLIST, and allocates it a number N. The number N will be used to designate the DLIST.

The created DLIST can then be used through the appropriated commands.

A DLIST is an invisible system object which is used to treat a chained list of strings (dynamic list). Each element of the list is an item.

A DLIST cannot generate an event.

Remark: a DLIST is filled with the commands ITEM_ADD, ITEM_INSERT, FILE_LOAD or FILE_ADD, and is read with the function ITEM_READ$().

SYNTAX: DLIST N

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.

USE

  • A DLIST is used to treat a chained list of strings.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than or equal to 0.
  • If number N is already used for a system object number.

EXAMPLE

rem create a DLIST

dlist 1

rem fill it with an item

item_add 1,"Hello !"

SEE ALSO

ITEM_ADD

ITEM_INSERT

ITEM_DELETE

ITEM_READ$()

FILE_ADD

FILE_LOAD

CLEAR