xvacreatenestedlist(3x11) [redhat man page]

XVaCreateNestedList(3X11)					  XLIB FUNCTIONS					 XVaCreateNestedList(3X11)

NAME

       XVaCreateNestedList - allocate a nested variable argument list

SYNTAX

       typedef void * XVaNestedList;

       XVaNestedList XVaCreateNestedList(dummy, ...)
	     int dummy;

ARGUMENTS

       dummy	 Specifies an unused argument (required by ANSI C).

       ...	 Specifies the variable length argument list.

DESCRIPTION

       The XVaCreateNestedList function allocates memory and copies its arguments into a single list pointer, which may be used as a value for
       arguments requiring a list value.  Any entries are copied as specified.	Data passed by reference is not copied; the caller must ensure
       data remains valid for the lifetime of the nested list.	The list should be freed using XFree when it is no longer needed.

SEE ALSO

       Xlib - C Language X Interface

X Version 11							    Release 6.6 					 XVaCreateNestedList(3X11)

XSetICValues(3X11)														XSetICValues(3X11)

NAME

       XSetICValues, XGetICValues - set and obtain XIC values

SYNOPSIS

       char * XSetICValues(ic, ...)
	       XIC ic;

       char * XGetICValues(ic, ...)
	       XIC ic;

ARGUMENTS

       Specifies the input context.  Specifies the variable length argument list to set or get XIC values.

DESCRIPTION

       The XSetICValues function returns NULL if no error occurred; otherwise, it returns the name of the first argument that could not be set. An
       argument might not be set for any of the following reasons: The argument is read-only (for example, XNFilterEvents).  The argument name	is
       not recognized.	An implementation-dependent error occurs.

       Each value to be set must be an appropriate datum, matching the data type imposed by the semantics of the argument.

       The XSetICValues can generate BadAtom, BadColor, BadCursor, BadPixmap, and BadWindow errors.

       The  XGetICValues  function  returns  NULL  if  no  error  occurred; otherwise, it returns the name of the first argument that could not be
       obtained. An argument could not be obtained for any of the following reasons: The argument  name  is  not  recognized.	The  input  method
       encountered an implementation-dependent error.

       Each  IC  attribute value argument (following a name) must point to a location where the IC value is to be stored. That is, if the IC value
       is of type T, the argument must be of type T*. If T itself is a pointer type, then XGetICValues allocates memory to store the actual  data,
       and  the  client  is  responsible for freeing this data by calling XFree with the returned pointer. The exception to this rule is for an IC
       value of type XVaNestedList (for preedit and status attributes).  In this case,	the argument must also be of  type  XVaNestedList.   Then,
       the rule of changing type T to T* and freeing the allocated data applies to each element of the nested list.

DIAGNOSTICS

       A  value for an Atom argument does not name a defined Atom.  A value for a Colormap argument does not name a defined Colormap.  A value for
       a Cursor argument does not name a defined Cursor.  A value for a Pixmap argument does not name a defined Pixmap.   A  value  for  a  Window
       argument does not name a defined Window.

SEE ALSO

       XCreateIC(3X11), XOpenIM(3X11), XSetICFocus(3X11), XmbResetIC(3X11)

       Xlib -- C Language X Interface

																XSetICValues(3X11)