Gets the first node in a list.

Node *FirstNode( List *l )

This macro returns a pointer to the first node in the specified list. If the list is empty, the macro returns a pointer to the tail (end-of-list) anchor. To determine if the return value is an actual node rather than the tail anchor, call the IsNode() procedure.

Example 1: Use of FirstNode in forward list traversal

for (n = FirstNode(list); IsNode(list, n); n = NextNode( n )) 
{    . . .    }; 

• l A pointer to the list from which to get the first node.

The macro returns a pointer to first node in the list or, if the list is empty, a pointer to the tail (end-of-list) anchor.

Macro implemented in list.h V20.

• list.h ANSI C Macro

IsListEmpty(), IsNode(), IsNodeB(), LastNode(), NextNode(), PrevNode(), ScanList()