#include <nitro/os.h>void OS_TWarning( const char *fmt, ... );
| fmt | 出力書式文字列(フォーマット文字列) |
| ... | 可変個引数 |
なし。
文字列を出力します。関数内部で OS_VSNPrintf()を呼び出しているため、使用可能なフォーマット文字列(出力書式文字列)は OS_Warning() よりも限定されたものになりますが、コード量やスタック消費量を節約することができます。
出力は
<filename>:<linenumber> Warning: <string>
の形式で行われます。<filename> <linenumber> はこの OS_TWarning() を記述したファイル名と行番号となります。fmt と可変個引数で作られる文字列が、<string> となります。
一度に表示できる文字列は 255文字までです。 256文字以上の文字列を指定した場合は 256文字目以降は無視されます。
この関数はデバッグ用の関数ですので、最終ROM版(FINALROM)ライブラリでは出力動作を行ないません。
OS_TWarning() は、実際は OSi_TWarning() の #define となっています。OSi_TWarning() は weak シンボルでコンパイルされていますので、ユーザが独自に関数を定義すれば、それで上書きされます。
2009/10/02 表示可能な文字列長について追記
2004/11/25 内部動作と weak シンボルの記述を追加
2004/09/10 初版