noble (3) XmStringNCopy.3.gz

NAME

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

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(3)