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

FreeBSD Manual Pages


home | help
XmCvtXmStringToByteStream(3Library Functions ManuaXmCvtXmStringToByteStream(3)

       XmCvtXmStringToByteStream -- A compound string function that converts a
       compound	string to a Byte Stream	format

       #include	<Xm/Xm.h>
       unsigned	int XmCvtXmStringToByteStream(
       XmString	string,
       unsigned	char **prop_return);

       XmCvtXmStringToByteStream converts a compound string  to	 a  string  of
       bytes  representing  the	 compound  string in Byte Stream format.  This
       routine is typically used by the	source of a data transfer operation to
       produce a Byte Stream representation for	transferring a compound	string
       to a destination.

       If prop_return is not NULL, this	function creates a string  of  charac-
       ters in Byte Stream format and returns it in prop_return.  The function
       also returns the	number of bytes	in  prop_return.   If  prop_return  is
       NULL,  the  function does not return the	Byte Stream format string, but
       it does calculate and return the	number of bytes	that would  appear  in
       the Byte	Stream format string.

       string	 Specifies  a  compound	 string	to be converted	to Byte	Stream

		 Specifies a pointer to	a string in Byte Stream	format that is
		 created  and  returned	 by  this function.  If	prop_return is
		 NULL, no Byte Stream format string is returned.  When a  Byte
		 Stream	 format	 string	 is  returned,	the function allocates
		 space to hold it.  The	application is responsible for	manag-
		 ing  this  allocated  space.  The application can recover the
		 allocated space by calling XtFree.

       Returns the number of bytes in the Byte Stream representation  (whether
       or not the Byte Stream representation is	returned).

       XmString(3) and XmCvtByteStreamToXmString(3).



Want to link to this manual page? Use this URL:

home | help