Vely logo install | documentation | examples | changelog
16.10.0 released May 10, 2023

Purpose: Create FIFO list.

new-fifo [ define ] <list>

new-fifo initializes new FIFO <list> (First In First Out). <list> is a pointer to type "vely_fifo", and can be created with optional "define".

FIFO <list> contains data stored on a first-in, first out basis. It is useful for storing temporary information in memory which can be quickly retrieved. Note that a list is accessible to the current process only.

Generally information is stored in a FIFO list, and retrieved (possibly many times) in the same order in which it was stored.

The internal positions for write-fifo and read-fifo actions are separate so you can keep adding data to the list, and obtain it in any number of retrieval passes by using rewind-fifo.
Allocated internals
<list> is allocated memory along with additional internal memory, which can be released if purge-fifo is used with <list> from a previously executed new-fifo.
new-fifo define nf

See also
FIFO ( new-fifo   purge-fifo   read-fifo   rewind-fifo   write-fifo  )  SEE ALL (documentation)

Copyright (c) 2017-2023 Dasoftver LLC