xmstringcomponentcreate(3) redhat man page | unix.com

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)