# OS_SetPrintOutput

## Syntax

  `#include <nitro/os.h>`
  `void OS_SetPrintOutput( OSPrintOutputProc proc, int num );`

> `
> (#define directives are given below.)
> void OS_SetPrintOutput_Arm9( int num );
> void OS_SetPrintOutput_Arm7( int num );
> void OS_SetPrintOutput_Arm9Err( int num );
> void OS_SetPrintOutput_Arm7Err( int num );
> `

## Arguments

proc | Specified processor.
num | Output window.

## Return Values

None.

## Description

If the destination for debug output has not been set with a function like `OS_Printf`, this function specifies the default output destination to use.
The setting made by this function will also apply if the output destination has been set as `OS_PRINT_OUTPUT_CURRENT`.

We use the term "standard output" to refer to the destination for normal output, like that from `OS_Printf`. Likewise, we use the term "error output" to refer to the destination for highly urgent output, like that from `OS_Panic()`.

The proc argument is a `OSPrintOutputProc`-type enumerated type, and specifies one of the following values.

Value of proc | Description
--- | ---
`OS_PRINT_OUTPUT_PROC_ARM9` | Standard output for the ARM9 processor.
`OS_PRINT_OUTPUT_PROC_ARM7` | Standard output for the ARM7 processor.
`OS_PRINT_OUTPUT_PROC_ARM9ERR` | Error output for the ARM9 processor.
`OS_PRINT_OUTPUT_PROC_ARM7ERR` | Error output for the ARM7 processor.

ARM7 settings can also be changed from the ARM9 side. The reverse is also possible.

num can be set to either 0-3 or `OS_PRINT_OUTPUT_NONE`.

Value of num | Description
--- | ---
`0` | Output to output window 0.
`1` | Output to output window 1.
`2` | Output to output window 2.
`3` | Output to output window 3.
`OS_PRINT_OUTPUT_NONE` | Do not output.

`OS_SetPrintOutput_Arm9( num )` is the `#define` directive for `OS_SetPrintOutput( OS_PRINT_OUTPUT_PROC_ARM9, num )`.
`OS_SetPrintOutput_Arm7( num )` is the `#define` directive for `OS_SetPrintOutput( OS_PRINT_OUTPUT_PROC_ARM7, num )`.
`OS_SetPrintOutput_Arm9Err( num )` is the `#define` directive for `OS_SetPrintOutput( OS_PRINT_OUTPUT_PROC_ARM9ERR, num )`.
`OS_SetPrintOutput_Arm7Err( num )` is the `#define` directive for `OS_SetPrintOutput( OS_PRINT_OUTPUT_PROC_ARM7ERR, num )`.

## See Also

`OS_Printf`

## Revision History

2008/10/01 Corrected an argument typo.
2008/01/12 Initial version.

CONFIDENTIAL