Man Linux: Main Page and Category List

NAME

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

SYNOPSIS

       #include <Xm/Xm.h>
       XmString XmStringNCopy(
       XmString s1,
       int num_bytes);

DESCRIPTION

       This function is obsolete and exists for  compatibility  with  previous
       releases.  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 function allocates space for the  resulting
       compound  string.   The  application  is  responsible  for managing the
       allocated space.  The application can recover the  allocated  space  by
       calling XmStringFree.

       s1        Specifies the compound string.

       num_bytes 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

       Returns a new compound string.

RELATED

       XmStringCreate(3) and XmStringFree(3).

                                                   XmStringNCopy(library call)