ultrix man page for dwtstringinitcontext

DwtStringInitContext(3Dwt)												DwtStringInitContext(3Dwt)

Name
       DwtStringInitContext - Initializes a compound-string context structure needed by DwtGetNextSegment

Syntax
       Boolean DwtStringInitContext(context, compound_string)
	    DwtCompStringContext context;
	    DwtCompString compound_string;

Arguments
       context	 Specifies the compound-string context structure initialized by DwtStringInitContext.

       compound_string
		 Specifies the compound-string.

Description
       The  DwtStringInitContext  function  initializes  a compound-string context structure.  The context structure is needed for calling DwtGet-
       NextSegment.  For performance reasons, DwtStringInitContext is preferred over DwtInitGetSegment.

       After fetching the necessary segments using DwtGetNextSegment, call DwtStringFreeContext to free the context structure.

Return Values
       This function returns one of these status return constants:

       True		 The compound-string  con-
			 text  structure  has been
			 successfully initialized.
       False		 The compound-string  con-
			 text  structure  has  not
			 been  successfully   ini-
			 tialized.

See Also
       DwtGetNextSegment(3Dwt), DwtStringFreeContext(3Dwt)
       Guide to the XUI Toolkit: C Language Binding
       Guide to the XUI Toolkit Intrinsics: C Language Binding

															DwtStringInitContext(3Dwt)