# OS_Printf

## C Specification

  `#include <nitro/os.h>`
  `void OS_Printf( const char *fmt, ...`

## Arguments

`fmt` | Output formatted string (formatted string)
... | Variable number of arguments

## Return Values

None.

## Description

Displays the character string. A variable number of arguments can be given in accordance to the format character string (output format character string).

This function is compiled with weak symbols. Therefore you can overwrite them with your own function definitions.

This function is used for debugging. It will not be generated in the final ROM version (`FINALROM`).

> Example:
> OS_Printf( "variable test = %d\n", test );

## Note

`OS_Printf` consumes a lot of stack. The IRQ stack used during interrupt and callback execution is not that big. Therefore, use the lightest possible version of `OS_TPrintf` in the the deep nest in IRQ interrupt. If the print operation freezes during debug generation, switching to `OS_TPrintf` may prevent freezes from occurring. However, floating decimal output is not supported by `OS_TPrintf`.

## See Also

`OS_PutString
`

## Revision History

11/25/2004 Added description of weak symbols.
12/01/2003 Initial version.

CONFIDENTIAL