xmstringsegmentcreate(3x) [osf1 man page]

XmStringSegmentCreate(3X)												 XmStringSegmentCreate(3X)

NAME

       XmStringSegmentCreate - A compound string function that creates a compound string

SYNOPSIS

       #include <Xm/Xm.h>

       XmString XmStringSegmentCreate (text, tag, direction, separator)
	       char * text;
	       char *tag;
	       XmStringDirection direction;
	       Boolean separator;

DESCRIPTION

       XmStringSegmentCreate  is  a high-level function that assembles a compound string consisting of a font list element tag, a direction compo-
       nent, a text component, and an optional separator component.  Specifies a null-terminated string to be used as the text	component  of  the
       compound  string.  Specifies the font list element tag to be associated with the text. The value XmFONTLIST_DEFAULT_TAG identifies a locale
       text segment.  Specifies the direction of the text.  Specifies separator addition.  If False, the compound string does not have a separator
       at the end.  If True, a separator immediately follows the text component.

RETURN VALUE

       Returns a new compound string.

SEE ALSO

       XmStringCreate(3X)

															 XmStringSegmentCreate(3X)

XmStringSegmentCreate(library call)									       XmStringSegmentCreate(library call)

NAME

       XmStringSegmentCreate -- A compound string function that creates a compound string

SYNOPSIS

       #include <Xm/Xm.h>
       XmString XmStringSegmentCreate(
       char * text,
       XmStringTag tag,
       XmStringDirection direction,
       Boolean separator);

DESCRIPTION

       This  function is obsolete and exists for compatibility with previous releases. It can be replaced by using a combination of XmStringCompo-
       nentCreate and XmStringConcat.  XmStringSegmentCreate is a high-level function that assembles a compound string consisting of a	font  list
       element tag, a direction component, a text component, and an optional separator component.

       The  function  allocates  space	for  the  returned compound string.  The application is responsible for managing the allocated space.  The
       application can recover the allocated space by calling XmStringFree.

       text	 Specifies a NULL-terminated string to be used as the text component of the compound string.

       tag	 Specifies the tag component to be associated with the text.  The value XmFONTLIST_DEFAULT_TAG is for compatibility with  previous
		 releases.

       direction Specifies the direction of the text.

       separator A  value  of False means the compound string does not have a separator at the end. A value of True, means a separator immediately
		 follows the text component.

RETURN

       Returns a new compound string.

RELATED

       XmStringCreate(3).

													       XmStringSegmentCreate(library call)