XmStringNCopy - A compound string function that creates a
copy of a compound string
XmString XmStringNCopy (s1, num_bytes)
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.
Returns a new compound string.
[ Back ]