SOMOutCharRoutine

This function prints a character. This function is replaceable.

Syntax
 char   c; int     rc;

rc = (*SOMOutCharRoutine)(c); 

Parameters

 * c (char) : The character to be output.

Return Code

 * rc (int) :

0 Returns 0 if an error occurs. 1 Returns 1 if no error occurs.

Remarks
This function is a replaceable character output routine. It is invoked by SOM whenever a character is generated by one of the SOM error-handling or debugging macros. The default implementation outputs the specified character to stdout. To change the destination of character output, store the address of a user-written character output routine in global variable SOMOutCharRoutine. Another function, somSetOutChar, may be preferred over the SOMOutCharRoutine function. The somSetOutChar function enables each application (or thread) to have a customized character output routine.

Example Code
 /* Define a replacement routine: */ int SOMLINK myCharacterOutputRoutine (char c) { (Customized code goes here) } ... /* After the next stmt all output */ /* will be sent to the new routine */ SOMOutCharRoutine = myCharacterOutputRoutine; 
 * 1) include 
 * 2) pragma linkage(myCharacterOutputRoutine, system)

Functions

 * somVprintf
 * somPrefixLevel
 * somLPrintf
 * somPrintf
 * somSetOutChar