NAME

       XmStringComponentCreate    —   A   compound   string   function   that   creates   arbitrary   components
       "XmStringComponentCreate"

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(3)