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

#include <som.h>
#pragma linkage(myCharacterOutputRoutine, system)
/* 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;