OpenVMS マニュアル

vswprintf

ワイド文字書式文字列の制御下で，ストリームに出力を書き込みます。

形式

#include <wchar.h>

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

引数

s

マルチバイト文字シーケンスへのポインタ。

n

マルチバイト文字を構成するバイト数の最大値。

format

書式指定を含んだワイド文字列へのポインタ。書式指定および変換指定とそれぞれに対応する引数の詳細については，『HP C ランタイム・ライブラリ・リファレンス・マニュアル(上巻)』第 2 章を参照してください。

ap

出力に必要な項目の可変リスト。

説明

vswprintf関数は，可変引数リストが ap 引数に置き換えられていることを除けば， swprintf関数と等価です。 ap の初期化は va_startマクロを使って，またおそらくはそれ以降の va_arg呼び出しを使って行います。

swprintfも参照してください。

戻り値

n

書き込まれたワイド文字の数。

負の値

エラーを示します。関数は errno を以下のいずれかに設定します。 EILSEQ---無効な文字を検出した。 EINVAL---引数が足りなかった。 ENOMEM---変換のために利用できるメモリが足りなかった。 ERANGE---浮動小数点計算のオーバフロー。 EVMSERR---変換不可能な OpenVMS エラー。 vaxc$errno に OpenVMS エラー・コードが含まれている。オーバフローのために数値への変換が失敗した可能性がある。 また，関数は I/O サブシステムから返されたエラーの結果として， errno を以下の値に設定することもあります。 EBADF---ファイル記述子が有効でない。 EIO---I/O エラー。 ENOSPC---ファイルを含んでいるデバイス上に空きスペースがない。 ENXIO---デバイスが存在しない。 EPIPE---パイプが破壊されている。 ESPIPE---追加用にオープンされたファイル内での不正なシーク。 EVMSERR---変換不可能な OpenVMS エラー。 vaxc$errno に OpenVMS エラー・コードが含まれている。等価な C エラー・コードがない I/O エラーが発生した可能性がある。