SomSetOutChar: Difference between revisions
No edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:somSetOutChar}} | {{DISPLAYTITLE:somSetOutChar}} | ||
This function changes the behavior of the [[somPrintf]] function. | This function changes the behavior of the [[somPrintf]] function. | ||
==Syntax== | ==Syntax== | ||
somTD_SOMOutCharRoutine *outCharRtn; | |||
somTD_SOMOutCharRoutine *outCharRtn; | somSetOutChar(outCharRtn); | ||
somSetOutChar(outCharRtn); | |||
==Parameters== | ==Parameters== | ||
; outCharRtn (somTD_SOMOutCharRoutine *) : A pointer to your routine that outputs a character in the way you want. | ;outCharRtn (somTD_SOMOutCharRoutine *) : A pointer to your routine that outputs a character in the way you want. | ||
==Return Code== | ==Return Code== | ||
==Remarks== | ==Remarks== | ||
This function is called to change the output character routine that somPrintf invokes. By default, somPrintf invokes a character output routine that goes to "stdout." The execution of this function affects only the application (or thread) in which it occurs. Thus, this function is normally preferred over SOMOutCharRoutine for changing the output routine called by somPrintf, since SOMOutCharRoutine remains in effect for subsequent threads as well. | This function is called to change the output character routine that somPrintf invokes. By default, somPrintf invokes a character output routine that goes to "stdout." The execution of this function affects only the application (or thread) in which it occurs. Thus, this function is normally preferred over SOMOutCharRoutine for changing the output routine called by somPrintf, since SOMOutCharRoutine remains in effect for subsequent threads as well. | ||
Some samples of this function can be found in the "somapi.h" header file. | Some samples of this function can be found in the "somapi.h" header file. | ||
==Related== | ==Related== | ||
;Functions | |||
* [[somPrintf]] | *[[somPrintf]] | ||
* [[SOMOutCharRoutine]] | *[[SOMOutCharRoutine]] | ||
[[Category:SOM | [[Category:SOM function]] | ||
Latest revision as of 04:44, 6 May 2020
This function changes the behavior of the somPrintf function.
Syntax
somTD_SOMOutCharRoutine *outCharRtn; somSetOutChar(outCharRtn);
Parameters
- outCharRtn (somTD_SOMOutCharRoutine *)
- A pointer to your routine that outputs a character in the way you want.
Return Code
Remarks
This function is called to change the output character routine that somPrintf invokes. By default, somPrintf invokes a character output routine that goes to "stdout." The execution of this function affects only the application (or thread) in which it occurs. Thus, this function is normally preferred over SOMOutCharRoutine for changing the output routine called by somPrintf, since SOMOutCharRoutine remains in effect for subsequent threads as well.
Some samples of this function can be found in the "somapi.h" header file.
Related
- Functions