書式

#include <wctype.h>

---

wctrans_t wctrans(const char *name);

説明

wctrans_t 型は、あるワイド文字を他のワイド文字に変換できるマッピ ングを表現する。本質的には実装依存であるが、特殊な値 (wctrans_t)0 は不正なマッピングを示す。0 でない値を持つ wctrans_t を towctrans(3) 関数に渡すことによって、実際に ワイド文字の変換を実行させることができる。

wctrans() は、名前によって与えられるマッピングを返す。有効な名前の 集合は現在のロケールの LC_CTYPE カテゴリに依存するが、以下の名前は全てのロケールにおいて有効である。

  "tolower" - tolower(3) のマッピングを実現する
  "toupper" - toupper(3) のマッピングを実現する

返り値

wctrans() 関数は、name が有効ならばマッピング記述子を返す。 有効でなければ (wctrans_t) 0 を返す。

属性

マルチスレッディング (pthreads(7) 参照)

wctrans() 関数は、例外付きのスレッドセーフである。実行中に setlocale(3) を呼び出してロケールを変更しない限り、マルチスレッドアプリケーションで安全に使用することができる。

準拠

C99.

注意

wctrans() の動作は、現在のロケールの LC_CTYPE カテゴリに依存する。

この文書について

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