btowc

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

btowc - シングルバイトをワイド文字にコンバートする  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <wchar.h>

wint_t btowc(int c);
 

説明

btowc() 関数は初期シフト状態から始まる長さ 1 のマルチバイトのシーケンスとして 解釈され、c をワイド文字にコンバートして返す。 c が EOF もしくは長さ 1 の無効なマルチバイトシーケンスの場合、 btowc() 関数は WEOF を返す。  

返り値

btowc() 関数はシングルバイト c からコンバートされたワイド文字を返す。 c が EOF もしくは長さ 1 の無効なマルチバイトシーケンスの場合、 btowc() 関数は WEOF を返す。  

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
btowc() Thread safetyMT-Safe
 

標準規格

C11, POSIX.1-2008.  

歴史

C99, POSIX.1-2001.  

注意

btowc() の振る舞いは、現在のロケールの LC_CTYPE カテゴリーに依存する。

この関数は使用されるべきではない。状態(state)を持ったエンコードには使えず、 マルチバイトシーケンスとは違い、必ずしもシングルバイト を取り扱えるとは限らない。代わりに mbtowc() か、スレッドセーフな mbrtowc() を使用すること。  

関連項目

mbrtowc(3), mbtowc(3), wctob(3)


 

Index

名前
ライブラリ
書式
説明
返り値
属性
標準規格
歴史
注意
関連項目

This document was created by man2html, using the manual pages.