[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


XmStringTableToXmString

A convenience function that converts a compound string table to a single compound string

Format

#include <Xm/Xm.h>
XmString XmStringTableToXmString
XmStringTable
tableCardinal countXmString
break_component

DESCRIPTION

XmStringTableToXmString takes as input table of compound strings and a specified string component (such as a tab) and returns a single compound string consisting of each of the elements of table concatenated together with a single copy of break_component inserted between each element.

table
Specifies an XmStringTable containing the compound strings to be converted.

count
Specifies the number of compound strings in table.

break_component
Specifies the XmStringComponent that will be inserted in the result to separate the individual elements of table. The most useful types will be XmSTRING_COMPONENT_SEPARATOR and XmSTRING_COMPONENT_TAB. Refer to the XmStringComponentType (3) reference page for a complete list of possible component types. Note, however, that the XmSTRING_COMPONENT_UNKNOWN component is not a possible type.

RETURN

Returns a new XmString. The function will allocate space to hold the returned compound string. When the application no longer needs the returned compound string, the application should call XmStringFree.

RELATED

XmString (3), XmStringComponentType (3), and XmStringFree (3).


[ Previous | Next | Contents | Glossary | Home | Search ]