Read Me - Common Public License V1.0 - Copyright Notice(©)

push


>>-push(item-+------------+)-------------------------------------><
             +--,option---+

Makes the object [item] a member item of the circular queue, inserting the item object in front of the first item in the queue. The pushed item object will be the new first item in the circular queue.

If the circular queue is full, than the last item stored in the circular queue will be deleted, before the insertion takes place. In this case the [deleted item] will be returned, otherwise [.nil] .

If [option] is specified, it may be "Normal" or "Unique". The default is "Normal". Only the first letter of the option capitalized letter is required; all characters following it are ignored. If [option] is 'Unique', any matching item already in the queue will be removed before before [item] is added to the queue. removed before the operation is performed. This allows you to maintain a list like the recent files list of an editor.

Read Me - Common Public License V1.0 - Copyright Notice(©)