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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmStringNConcat	-- A compound string function that appends a specified
       number of bytes to a compound string

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

DESCRIPTION
       This function is	obsolete and exists for	 compatibility	with  previous
       releases.  It is	replaced by XmStringConcat.  XmStringNConcat appends a
       specified number	of bytes from s2 to the	end of s1, including tags, di-
       rectional indicators, and separators. It	 then  returns	the  resulting
       compound	 string. The original strings are preserved.  The function al-
       locates space for the resulting compound	string.	  The  application  is
       responsible  for	managing the allocated space.  The application can re-
       cover the allocated space by calling XmStringFree.

       s1	 Specifies the compound	string to which	a copy of  s2  is  ap-
		 pended.

       s2	 Specifies  the	compound string	that is	appended to the	end of
		 s1.

       num_bytes Specifies the number of bytes of s2 to	append to s1.  If this
		 value is less than the	length of s2, as many bytes as	possi-
		 ble,  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).

							    XmStringNConcat(3)

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

home | help