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
       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. 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
       returns	the  resulting	compound string. The original strings are pre-
       served.	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  Xm-
       StringFree.

       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)

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