1XmStringNCopy(library call) XmStringNCopy(library call)
2
3
4
6 XmStringNCopy — A compound string function that creates a copy of a
7 compound string
8
10 #include <Xm/Xm.h>
11 XmString XmStringNCopy(
12 XmString s1,
13 int num_bytes);
14
16 This function is obsolete and exists for compatibility with previous
17 releases. XmStringNCopy creates a copy of s1 that contains a specified
18 number of bytes, including tags, directional indicators, and separa‐
19 tors. It then returns the resulting compound string. The original
20 strings are preserved. The function allocates space for the resulting
21 compound string. The application is responsible for managing the allo‐
22 cated space. The application can recover the allocated space by call‐
23 ing XmStringFree.
24
25 s1 Specifies the compound string.
26
27 num_bytes Specifies the number of bytes of s1 to copy. If this value
28 is less than the length of s1, as many bytes as possible, but
29 possibly fewer than this value, will be appended to s1 such
30 that the resulting string is still a valid compound string.
31
33 Returns a new compound string.
34
36 XmStringCreate(3) and XmStringFree(3).
37
38
39
40 XmStringNCopy(library call)