xmstringcomponentcreate(3) [redhat man page]

XmStringComponentCreate(library call)									     XmStringComponentCreate(library call)

NAME

       XmStringComponentCreate -- A compound string function that creates arbitrary components

SYNOPSIS

       #include <Xm/Xm.h>
       XmString XmStringComponentCreate(
       XmStringComponentType c_type,
       unsigned int length,
       XtPointer value);

DESCRIPTION

       XmStringComponentCreate creates a new XmString component of type c_type, containing value. If value is invalid for the particular component
       type, this function fails and returns NULL.

       c_type	 Specifies the type of component to be created.

       length	 Specifies the length in bytes of value.  Note that this must be precisely the length of  the  value  string,  not  including  any
		 trailing null characters.

       value	 Specifies the value to be used in the creation of the component.

       Refer to the XmStringComponentType(3) reference page for a list of the possible XmString component types.

RETURN

       If  value  is  invalid for c_type, fails and returns NULL. Otherwise, this function returns a new compound string.  When the application no
       longer needs the returned compound string, the application should call XmStringFree.

RELATED

       XmString(3), XmStringGetNextTriple, XmStringComponentType, and XmStringFree(3).

													     XmStringComponentCreate(library call)

XmStringTableToXmString(library call)									     XmStringTableToXmString(library call)

NAME

       XmStringTableToXmString -- A convenience function that converts a compound string table to a single compound string

SYNOPSIS

       #include <Xm/Xm.h>
       XmString XmStringTableToXmString(
       XmStringTable table,
       Cardinal count,
       XmString break_component);

DESCRIPTION

       XmStringTableToXmString takes as input table of compound strings and a specified string component (such as a tab) and returns a single com-
       pound string consisting of each of the elements of table concatenated together with a single copy of break_component inserted between  each
       element.

       table	 Specifies an XmStringTable containing the compound strings to be converted.

       count	 Specifies the number of compound strings in table.

       break_component
		 Specifies the XmStringComponent that will be inserted in the result to separate the individual elements of table. The most useful
		 types will be XmSTRING_COMPONENT_SEPARATOR and XmSTRING_COMPONENT_TAB.  Refer to the XmStringComponentType(3) reference page  for
		 a complete list of possible component types. Note, however, that the XmSTRING_COMPONENT_UNKNOWN component is not a possible type.

RETURN

       Returns	a  new XmString.  The function will allocate space to hold the returned compound string.  When the application no longer needs the
       returned compound string, the application should call XmStringFree.

RELATED

       XmString(3), XmStringComponentType(3), and XmStringFree(3).

													     XmStringTableToXmString(library call)