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 num-
     ber 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 re-
     leases. It is replaced by XmStringConcat.

     XmStringNConcat appends a specified number of bytes from s2 to the  end  of
     s1, including tags, directional indicators, and separators. It then returns
     the  resulting  compound  string.	The original strings are preserved.  The
     function allocates space for the resulting compound string.   The	applica-
     tion  is responsible for managing the allocated space.  The application can
     recover the allocated space by calling XmStringFree.

     s1        Specifies the compound string to which a copy of s2 is appended.

     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 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).

							      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+15.1.quarterly>

home | help