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)