Name

XtVaCreateArgsList — dynamically allocate a varargs list for use with the XtVaNestedList symbol in multiple varargs calls. 

Synopsis

XtVarArgsList XtVaCreateArgsList(unused, ..., NULL)

      XtPointer unused;

Arguments

unusedThis argument is not currently used and must be specified as NULL. 

..., NULLSpecifies the NULL-terminated variable-length list of resource name/value pairs to override any other resource specifications. 

Description

XtVaCreateArgsList allocates memory and copies its arguments into a single list pointer that may be used with XtVaNestedList.  The end of both lists is identified by a name entry containing NULL.  Any entries of type XtVaTypedArg are copied as specified without applying conversions.  Data passed by reference (including strings) is not copied, only the pointers themselves; the caller must ensure that the data remains valid for the lifetime of the created varargs list.  When no longer needed, the list should be freed using XtFree. 

To permit modification without recompilation, use of resource files and the resource database is generally encouraged over lengthy ArgList or varargs lists whenever possible. 

Structures

typedef XtPointer XtVarArgsList;

See Also

XtCalloc(1), XtFree(1), XtMalloc(1), XtMergeArgLists(1), XtNew(1), XtNewString(1), XtRealloc(1), XtSetArg(1).