Initializing help system before first use

XPRMcb_sendctrl

XPRMcb_sendctrl


Purpose
Send a control character to an initialization stream.
Synopsis
int XPRMcb_sendctrl(XPRMcbinit cbinit,int ctrl,int flush);
Arguments
cbinit 
Stream context
ctrl 
Control character code. Possible values:
XPRM_CBC_SKIP 
Skip the next record (same as * in an ASCII file)
XPRM_CBC_OPENLST 
Begin a list of values (same as [ in an ASCII file)
XPRM_CBC_CLOSELST 
End a list of values (same as ] in an ASCII file)
XPRM_CBC_OPENNDX 
Begin a list of indices (same as ( in an ASCII file)
XPRM_CBC_CLOSENDX 
End a list of indices (same as ) in an ASCII file)
flush 
If 0, the data will be processed when the queue of tokens is full, otherwise processing occurs immediately.
Return value
Normal termination
All tokens have been processed and no more data is expected
No more data is expected but the queue of tokens is not empty
-1 
An error occurred
Further information
1. This function can only be used from a callback stream (see Section cb driver) during the execution of an initializations from block.
2. If the flush argument is 0, the information sent is queued and the function returns 0. The queue is flushed when it is full or if the flush argument is non-zero.
Related topics