NAME    [Toc]    [Back]

       XmStringNCopy  - A compound string function that creates a
       copy of a compound string

SYNOPSIS    [Toc]    [Back]

       #include <Xm/Xm.h>

       XmString XmStringNCopy (s1, num_bytes)
               XmString s1;
               int num_bytes;

DESCRIPTION    [Toc]    [Back]

       XmStringNCopy creates a copy of s1 that contains a  specified
  number of bytes, including tags, directional indicators,
 and separators.  It then returns the resulting  compound
  string.   The  original strings are preserved.  The
       space for  the  resulting  compound  string  is  allocated
       within  the  function.  The application is responsible for
       managing the allocated space.  The memory can be recovered
       by calling XmStringFree.

       Specifies  the  compound  string.  Specifies the number of
       bytes of s1 to copy. If this value is less than the length
       of  s1, as many bytes as possible, but possibly fewer than
       this value, will be appended to s1 such that the resulting
       string is still a valid compound string.

RETURN VALUE    [Toc]    [Back]

       Returns a new compound string.

SEE ALSO    [Toc]    [Back]

       XmStringCreate(3X), XmStringFree(3X)



                                                XmStringNCopy(3X)