lq-text: LQU_FirstNameRef

API t_NameRef LQU_FirstNameRef (NameSpace) t_NameSpace *NameSpace;

Purpose

Used in conjunction with LQU_Next­Name­Ref to iterate over all of the Names in a Name Space.

Returns

A reference to the first Name in the given Name Space, if there are any. Use LQU_Name­Ref­Is­Valid() to determine if the returned reference is valid; if not, LQU_NameRefIsError will determine if there was an error, and LQU_GetNameError will handle the error using Error().

See Also:

Example

* t_NameRef NameRef; * * for ( * NameRef = LQU_FirstNameRef(NameSpace); * LQU_NameRefIsValid(NameSpace, NameRef); * NameRef = LQU_NextNameRef(NameSpace, NameRef) * ) { * now use the Name Reference: * printf("%s\n", LQU_GetNameFromNameRef(NameRef)); * }