XmStringGetLtoR(3X)

NAME
     XmStringGetLtoR  --A compound string function that searches for a text seg-
     ment in the input compound string

SYNOPSIS
     #include <Xm/Xm.h>

     Boolean XmStringGetLtoR (string, tag, text)
          XmString  string;
          XmStringCharSettag;
          char      **text;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmStringGetLtoR searches for a text segment in the  input  compound  string
     that matches the given font list element tag.

     This  function allocates memory for the returned string.  The caller should
     free it with XtFree(3X).


     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 VALUE
     Returns  True  if  the matching text segment can be found.  On return, text
     will have a null terminated octet sequence containing the matched segment.

RELATED INFORMATION
     XmStringCreate(3X).

                                                             XmStringGetLtoR(3X)