purge-fifo
Purpose: Delete FIFO list data.
purge-fifo <list> [ delete ]
purge-fifo will delete all elements from the FIFO <list>, created by
new-fifo. The list is then empty and you can still put data into it, and get data from it afterwards, without having to call
new-fifo again.
If you use "delete" clause, then all the internal memory of a <list> is freed, and you must call
new-fifo in order to use it again.
Note that in any case, purge-fifo will not free any possibly
allocated memory for keys or values stored in its elements (see
write-fifo).
See
memory_handling for more on when (not) to delete memory explicitly like this; the same rules apply as for
delete-mem.
Examples
See
read-fifo.
See also
FIFO (
new-fifo purge-fifo read-fifo rewind-fifo write-fifo )
SEE ALL (
documentation)