<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqutil">
<Function File="../../src/liblqutil/namespace.c">
<Name>LQU_NameSpaceTableToNameSpace</Name>
<Class>Utilities/Name Space
<Purpose>
<P>Converts a Name Space Table into a Name Space.  This is useful
if you have a statically initialised Name Space Table, for example.</P>
<P>The new Name Space has the given Name as its name.  The string
is pointed to but not copied, and should therefore be allocated by
the caller if it is not static data.  The entries in the Name
Space Table are copied, but their Name fields are simply pointed to.</P>
<Returns>
the newly created Name Space if successful.  Currently, a
failure is always fatal.
<SeeAlso>
LQU_StringToNameRef
LQU_SetNameVariable
</Function>
<Decl>
API t_NameSpace *
LQU_NameSpaceTableToNameSpace(Name, theTable)
    char *Name;
    t_NameSpaceTable theTable;
</Decl>
</Entry>
