C言語の標準ライブラリvsnprintfのリファレンスです。
概要 | 可変長引数リストのデータを文字数を指定して配列に書き込む。 |
ヘッダ | #include <stdarg.h> |
I/F | int vsnprintf(char * restrict s, size_t n, const char * restrict format, va_list arg); |
戻り値 | 配列に書き込んだはずの文字数。表現形式エラーなら負の値。 |
詳細 | vsnprintf関数は、可変個数の実引数並びをargで置き換えたsnprintf関数と同じである。vsnprintf関数の呼出し前に、va_startマクロでargを初期化しておく必要がある。vsnprintf関数は、va_endマクロを呼び出さない。また、vsnprintf関数はva_argマクロを呼び出すので、vsnprintf関数から戻った後のargの値は不定となる。 vsnprintf関数の戻り値は書き込み済みの文字数であるが、この数に終端ナル文字は含まれない。戻り値が非負でn未満の場合のみ、ナル文字で終了している出力が完全に書き込まれている。 |