NAME

       XmStringCreateLtoR  —  A  compound  string  function  that creates a compound string "XmStringCreateLtoR"
       "compound string functions" "XmStringCreateLtoR"

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  creates  a  compound  string  with two components: text and a tag
       component.  This function scans for \n 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(3)