FWIDE

Section: Linux Programmer's Manual (3)
Updated: 2016-03-15
Index JM Home Page

名前

fwide - FILE ストリームの入出力単位を設定または取得する

書式

#include <wchar.h>

int fwide(FILE *stream, int mode);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

fwide():

_XOPEN_SOURCE >= 500 || _ISOC99_SOURCE ||
_POSIX_C_SOURCE >= 200112L

説明

mode がゼロならば fwide() 関数は stream の現在の入出力単位を決定して返す。stream がワイド文字単位のとき、すなわちワイド文字 I/O は許されてバイト (char) I/O は許されていないときには、正の値を返す。 stream がバイト単位のとき、すなわちバイト I/O は許されてワイド文字 I/O は許されていないときには、負の値を返す。 stream の入出力単位がまだ決定されていない場合にはゼロが返される。この場合には次の I/O 操作によって入出力単位が変更される (バイト I/O 操作の場合にはバイト単位に、ワイド文字 I/O 操作の場合にはワイド文字単位になる)。

一度ストリームの入出力単位が決まると、変更することはできず、ストリームがクローズ (close) されるまで保持される。

mode がゼロでない場合には fwide() 関数は最初に stream の入出力単位を設定しようとする (mode が 0 より大きい場合にはワイド文字単位に、 mode が 0 より小さい場合にはバイト単位に設定しようとする)。そして上記と同様に現在の入出力単位を返す。

返り値

fwide() 関数はストリームの入出力単位の設定を試みた後にその値を返す。正の返り値はワイド文字単位を、負の返り値はバイト単位を意味する。返り値が 0 ならば未決定を意味する。

準拠

POSIX.1-2001, POSIX.1-2008, C99.

注意

バイト単位のストリームにワイド文字を出力にするには fprintf(3) 関数の %lc 変換や %ls 変換を使用することができる。

ワイド文字単位のストリームにバイト単位の出力を行うには fwprintf(3) 関数の %c 変換や %s 変換を使用することができる。

この文書について

この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。

Linux マニュアル一覧

[man1] [man2] [man3] [man4] [man5] [man6] [man7] [man8]
[a] [b] [c] [d] [e] [f] [g] [h] [i] [j] [k] [l] [m] [n] [o] [p] [q] [r] [s] [t] [u] [v] [w] [x] [y] [z]

This document was created by man2html, using the manual pages.
Time: 12:08:38 GMT, June 11, 2022

FWIDE

名前

書式

説明

返り値

準拠

注意

関連項目

この文書について

関連キーワード

Linux マニュアル 一覧

Index

Linux マニュアル一覧