Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmStringNCopy(3)	    Library Functions Manual		XmStringNCopy(3)

NAME
     XmStringNCopy  --	A compound string function that creates a copy of a com-
     pound string

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

DESCRIPTION
     This function is obsolete and exists for compatibility  with  previous  re-
     leases. It is replaced by XmStringCopy.

     XmStringNCopy  creates  a	copy  of  s1 that contains a specified number of
     bytes, including tags, directional indicators, and separators. It then  re-
     turns  the  resulting  compound string. The original strings are preserved.
     The function allocates space for the resulting compound string.  The appli-
     cation 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 possi-
	       bly 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmStringNCopy&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help