vswprintf

vswprintf 関数は可変長引数リストのデータを書式ワイド文字列に従ってワイド文字 (wide character) 配列に書き込みます． 

#include <stdarg.h>
#include <wchar.h>

int vswprintf(
    wchar_t * restrict s,
    size_t n,
    const wchar_t * restrict format,
    va_list arg
);

vswprintf 関数は可変長引数リスト arg のデータを format が指す書式ワイド文字列に従って s が指すワイド文字配列へ書き込みを行います．
ワイド文字配列に書き込んだワイド文字列 (wide string) の後には自動的にナルワイド文字 (null wide character) が書き込まれます．
なお，書き込まれる文字数が n を超えることはありません．

vswprintf 関数の呼び出し前には va_start マクロで引数 arg を初期化しておく必要があります．また，vfwprintf 関数は va_end マクロを呼び出しません．したがってユーザーが手動で va_end マクロを呼び出す必要があります．

vswprintf 関数の動作は可変長引数 (variable arguments) を arg に置き換えた swprintf 関数と同じです．

引数

  • s: ワイド文字配列 (ここに書き込まれる)
  • n: 書き込む文字数の最大値
  • format: 書式ワイド文字列 (詳しくは wprintf 関数の書式ワイド文字列を参照してください)
  • arg: 変換するパラメータのリスト (可変長引数リスト)

戻り値

  • 成功した場合: 配列に書き込まれた文字数
  • 失敗した場合: 負の値

Cプログラマの必読書

たくさんあるC言語関連の書籍の中でも特に役に立った本です．よかったら参考にしてみてください．

C実践プログラミング 第3版

C言語の実践的参考書．少々値段は張りますが初心者を脱しようとしている人は絶対に読むべきです．
文法だけでなく，コーディングスタイルやデバッグなど文字通り「実践的」なことが書かれているので非常にためになります． オライリーの本は，読みにくい本が多いのですが本書はとても読みやすくオススメです．


C言語ポインタ完全制覇 (標準プログラマーズライブラリ)

ポインタの解説書としては最高の書籍です．
この1冊でポインタを完全に理解することができます．全くの初学者が読むには敷居が高いですが，入門書を読み終えた後に読むと非常に有益です．