dxmcvtcstoos(3x) [osf1 man page]

DXmCvtCStoOS(3X)														  DXmCvtCStoOS(3X)

NAME

       DXmCvtCStoOS - Converts a compound string to an operating-system specific format. Currently uses text format.

SYNOPSIS

       Opaque DXmCvtCStoOS(
	       XmString cs,
	       long *byte_count,
	       long *status );

PARAMETERS

       A  compound  string.   The number of bytes in the length of the output string.  The status of the conversion procedure, indicated by one of
       the following values:

	      -----------------------------------------------------------
	      Value		     Description
	      -----------------------------------------------------------
	      DXmCvtStatusOK	     The conversion was successful.
	      DXmCvtStatusDataLoss   Data was lost  during  the  conver-
				     sion.
	      DXmCvtStatusFail	     The conversion was not successful.
	      -----------------------------------------------------------

DESCRIPTION

       The  DXmCvtCStoOS  routine converts a compound string to an operating-system specific format.  It currently uses text format. The user must
       free the string by using the Intrinsic routine XtFree.

RETURN VALUES

       The address of the file-compatible format string.

																  DXmCvtCStoOS(3X)

XmCvtXmStringToByteStream(library call) 								   XmCvtXmStringToByteStream(library call)

NAME

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

SYNOPSIS

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

DESCRIPTION

       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 characters 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 format

       prop_return
		 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 managing this allocated space.	The application can recover the allocated space by calling
		 XtFree.

RETURN

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

RELATED

       XmString(3) and XmCvtByteStreamToXmString(3).

													   XmCvtXmStringToByteStream(library call)