NAME

       XmStringGetLtoR — A compound string function that searches for a text segment in the input
       compound string "XmStringGetLtoR" "compound string functions" "XmStringGetLtoR"

SYNOPSIS

       #include <Xm/Xm.h>
       Boolean XmStringGetLtoR(
       XmString string,
       XmStringCharSet tag,
       char **text);

DESCRIPTION

       This function is obsolete and exists for  compatibility  with  previous  releases.  It  is
       replaced  by  XmStringUnparse.   XmStringGetLtoR  returns  the first text component in the
       input compound string that is tagged with the given tag component. The returned text is to
       be  a  NULL-terminated  sequence of single byte characters.  If the function returns True,
       the function will allocate space to hold the returned text. The application is responsible
       for  managing  the  allocated  space.  The  application can recover the allocated space by
       calling XtFree.

       string    Specifies the compound string.

       tag       Specifies the font list element tag  associated  with  the  text.   A  value  of
                 XmFONTLIST_DEFAULT_TAG identifies a locale text segment.

       text      Specifies a pointer to a NULL terminated string.

RETURN

       Returns  True if the matching text segment can be found.  On return, text will have a NULL
       terminated byte sequence containing the matched segment.

RELATED

       XmStringCreate(3).

                                                                               XmStringGetLtoR(3)