XmCvtXmStringToByteStream(UNIX SysteXmCvtXmStringToByteStream(3X)
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);
VERSION
This page documents Motif 2.1.
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).
Page 1 (printed 7/20/06)