Skip to content

Latest commit

 

History

History
36 lines (23 loc) · 849 Bytes

FindName.md

File metadata and controls

36 lines (23 loc) · 849 Bytes

NAME

FindName -- find a system list node with a given name

SYNOPSIS

    node = FindName(start, name)
    D0,Z            A0     A1

    struct Node *FindName(struct List *, STRPTR);

Links: Node List

FUNCTION

Traverse a system list until a node with the given name is found. To find multiple occurrences of a string, this function may be called with a node starting point.

No arbitration is done for access to the list! If multiple tasks access the same list, an arbitration mechanism such as SignalSemaphores must be used.

INPUTS

start - a list header or a list node to start the search (if node, this one is skipped) name - a pointer to a name string terminated with NULL

RESULTS

node - a pointer to the node with the same name else zero to indicate that the string was not found.