GOLF(2gg)

NAME
delete-list - (linked-list)

PURPOSE
Delete current linked list element.

SYNTAX

        delete-list <list> [ status <status> ]

DESCRIPTION
delete-list will delete current element in linked <list> created with new-list. A current list element is the one that will be subject to statements like read-list and write-list. See position-list for more details on the current element.

<status> (in "status" clause) is GG_OKAY if element is deleted, or GG_ERR_EXIST if could not delete element (this can happen if the list is empty, or if current list element is beyond the last element, such as for instance if "end" clause is used in position-list statement).

Once an element is deleted, the current element becomes either the next one (if the current element wasn't the last one), or the previous one (if the current element was the last one).

EXAMPLES

        delete-list mylist status st

SEE ALSO
 Linked list

delete-list get-list new-list position-list purge-list read-list write-list See all documentation