TutSetOutputFunc

Name

TutSetOutputFunc — set the function to use for TutOut output

Synopsis

void TutSetOutputFunc(output_func) 
T_OUT_VA_FUNC output_func; 

Arguments

output_func — function to be used by TutOut

Return Values

None

Diagnostics

None

Description

TutSetOutputFunc allows you to specify a function that is used by TutOut to display output, instead of the default vprintf. This makes it possible to set up output data to go to a different place, or perform pre-processing on the output before it is displayed.

The function output_func is called each time with two arguments, the format string and the argument list, much like vprintf.

If NULL is specified for output_func, the default output function vprintf is used for subsequent TutOut operations.

For compatibility across platforms, cast using T_ENTRY_VA.

Caution

None

See Also

TutGetOutputFunc, TutOut

Examples

This example discards all TutOut output by using a dummy output function that does nothing:

static void T_ENTRY_VA dummy_func(format_str, arg_list) 
T_STR format_str; 
va_list arg_list; 
{ 
  /* do nothing */ 
} /* dummy_func */ 
. 
. 
. 
TutSetOutputFunc(dummy_func); 
TutOut("This line will not appear!\n"); 
. 
. 
.