XmStringGetNextComponent(3X)



XmStringGetNextComponent(3X)  SDK X11 R4.11MU05 XmStringGetNextComponent(3X)


NAME
       XmStringGetNextComponent--A compound string function that returns the
       type and value of the next component in a compound string

SYNOPSIS
       #include <Xm/Xm.h>

       XmStringComponentType XmStringGetNextComponent (context, text, tag, direction, unknowntag,
       unknownlength, unknownvalue)
            XmStringContext     context;
            char                **text;
            XmStringCharSet     *tag;
            XmStringDirection   *direction;
            XmStringComponentType*unknowntag;
            unsigned short      *unknownlength;
            unsigned char       **unknownvalue;


DESCRIPTION
       XmStringGetNextComponent returns the type and value of the next
       component in the compound string identified by context.  It is a low-
       level component function.  Components are returned one at a time.  On
       return, only some output parameters will be valid; which ones can be
       determined by examining the return status.  In the case of text, tag,
       and direction components, only one output parameter is valid.  If the
       return status indicates an unknown component was encountered, the
       font list element tag, length, and value are returned.  This function
       allocates the space necessary to hold returned values; freeing this
       space is the caller's responsibility.


        context     Specifies the string context structure which was
                    allocated by the XmStringInitContext function.

        text        Specifies a pointer to a null terminated string.

        tag         Specifies a pointer to the font list element tag
                    associated with the text.  The value
                    XmFONTLISTDEFAULTTAG identifies a locale text segment.

        direction   Specifies a pointer to the direction of the text.

        unknowntag Specifies a pointer to the tag of an unknown component.

        unknownlength
                    Specifies a pointer to the length of an unknown
                    component.

        unknownvalue
                    Specifies a pointer to the value of an unknown
                    component.



RETURN VALUE
       Returns the type of component found.  Following are the possible
       values:


         ·  XmSTRINGCOMPONENTCHARSET

       This component is obsolete and remains for compatibility with
       previous releases.  It has been replaced by
       XmSTRINGCOMPONENTFONTLISTELEMENTTAG.

         ·  XmSTRINGCOMPONENTFONTLISTELEMENTTAG

         ·  XmSTRINGCOMPONENTLOCALETEXT

         ·  XmSTRINGCOMPONENTTAG

         ·  XmSTRINGCOMPONENTTEXT

         ·  XmSTRINGCOMPONENTDIRECTION

         ·  XmSTRINGCOMPONENTSEPARATOR

         ·  XmSTRINGCOMPONENTEND

         ·  XmSTRINGCOMPONENTUNKNOWN


RELATED INFORMATION
       XmStringCreate(3X) and XmStringInitContext(3X).


Licensed material--property of copyright holder(s)
Museum
