[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   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);

   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.