xmstringgetltor(3) [redhat man page]

XmStringGetLtoR(library call)											     XmStringGetLtoR(library call)

NAME

       XmStringGetLtoR -- A compound string function that searches for a text segment in the input compound string

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-termi-
       nated  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  seg-
		 ment.

       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(library call)

XmStringCreateLtoR(library call)										  XmStringCreateLtoR(library call)

NAME

       XmStringCreateLtoR -- A compound string function that creates a compound string

SYNOPSIS

       #include <Xm/Xm.h>
       XmString XmStringCreateLtoR(
       char *text,
       char *tag);

DESCRIPTION

       This function is obsolete and exists for compatibility with previous releases. It is replaced by XmStringGenerate.  XmStringCreateLtoR cre-
       ates a compound string with two components: text and a tag component.  This function scans for 
 characters  in  the  text.  When  one	is
       found,  the  text up to that point is put into a segment followed by a separator component. No final separator component is appended to the
       end of the compound string.  The direction component defaults to left-to-right.	This function assumes that the	encoding  is  single  byte
       rather than multibyte.

       The  function  will  allocate space to hold the returned compound string.  The application is responsible for managing the allocated space.
       The application can recover the allocated space by calling XmStringFree.

       text	 Specifies a NULL-terminated string to be used as the text component of the compound string.

       tag	 Specifies the tag component to be associated with the given text. The value XmFONTLIST_DEFAULT_TAG is retained for  compatibility
		 with previous releases.

RETURN

       Returns a new compound string.

RELATED

       XmStringCreate(3) and XmStringGenerate(3).

														  XmStringCreateLtoR(library call)