本文に進む 日本−日本語
日本HPホーム 製品とサービス お客様サポート/ ダウンロード ソリューション ご購入の方法
≫ お問い合わせ
詳細検索オプション
日本HPホーム
HP-UX リファレンス: セクション 3 : ライブラリ (N~Z) > p

putws(3C)

HP-UX 11i Version 2: September 2004
≫ 

テクニカル ドキュメント

PDF版
フィードバック
ここから本文が始まります

 ≫ 目次

 ≫ 索引

名称

putws(), fputws() ― ワイドキャラクタ文字列のストリームファイルへの書き込み

構文

#include <wchar.h>

int putws(const wchar_t *ws);

int fputws(const wchar_t *ws, FILE *stream);

廃止インタフェース

int putws_unlocked(const wchar_t *ws);

int fputws_unlocked(const wchar_t *ws, FILE *stream);

特記事項:

fputws は、XPG4 Worldwide Portability Interface のワイドキャラクタ I/O 関数に準拠しています。 これらの関数は、 puts(3S) で定義されている 8 ビットキャラクタの I/O 関数に相当するものです。

説明

putws() は、 ws が指す null で終わるワイドキャラクタ文字列を対応する文字列にして、改行文字を追加して、標準出力ストリーム stdout に書き出します。

fputws() は、 ws が指す null で終わるワイドキャラクタ文字列を対応する文字列にして、 stream で指定された出力に書き出しますが、改行文字や終端のヌル文字を追加することは ありません。

どちらの関数も、終端のヌル文字を書き込みません。

これらの関数の定義にある型 wchar_t および値 WEOF は、ヘッダー <wchar.h> で定義されています。

廃止インタフェース

ワイドキャラクタ文字列をストリームファイルに書き込む putws_unlocked() および fputws_unlocked()

アプリケーション使用法

putws() または fputws() がストリームに適用された後は、ストリームはワイド指向になります (orientation(5) を参照)。

多言語化対応

ロケール

LC_CTYPE カテゴリにより、ワイドキャラクタの変換方法が決まります。

サポートされる文字コードセット

シングル/マルチバイト文字コードセットが、サポートされます。

戻り値

putws(), putws_unlocked(), fputws(), および fputws_unlocked() は、正常終了すると、負でない数を返します。 失敗すると、 WEOF を返し、ストリームのエラーインジケーターをセットし、エラーを示す値を errno にセットします。

エラー

putws(), putws_unlocked(), fputws(), および fputws_unlocked() は、 stream がバッファーされていないとき、あるいは、 stream のバッファー内に write() 呼び出しを実行してフラッシュするデータがあるときに、以下の条件で失敗します。

[EAGAIN] 

O_NONBLOCK フラグが stream のファイル記述子にセットされていて、プロセスが書き込み操作に間に合わなかった場合。

[EBADF] 

stream のファイル記述子が、書き込みオープンのファイル記述子として無効な場合。

[EFBIG] 

プロセスのファイルサイズ上限あるいは最大ファイルサイズ ulimit(2) 参照) を越えてファイルに書き込もうとした場合。

[EINTR] 

write() システムコールの中でシグナルを受け取った場合。

[EIO] 

プロセスがバックグラウンド プロセスグループで、 TOSTOP がセットされている制御ターミナルに書き込もうとした場合、プロセスが SIGTTOU シグナルを無視もブロックもしていない場合、プロセスのプロセスグループが親無しの場合。

[ENOSPC] 

ファイルのあるデバイスに空きスペースが残っていない場合。

[EPIPE] 

どのプロセスからも読み取りオープンされていないパイプあるいは FIFO に書き込もうとした場合。 SIGPIPE シグナルが、プロセスに送られます。

[EILSEQ] 

ws のワイドキャラクタが、有効な文字に対応しない場合。

中で呼び出される write() 関数によって、これ以外の errno 値がセットされることがあります write(2) 参照)。

警告

putws_unlocked() および fputws_unlocked() インタフェースは廃止され、現在では既存の DCE アプリケーションとの互換性を保つためにだけサポートされています。新しいマルチスレッドアプリケーションでは、 putws() および fputws() を使用してください。

著者

putws() および fputws() は、OSF と HP で開発されました。

標準準拠

fputws(): XPG4

印刷用画面へ
プライバシー 本サイト利用時の合意事項
© 1983-2004 Hewlett-Packard Development Company, L.P.