EN JA
WCTRANS(3)
WCTRANS(3) FreeBSD Library Functions Manual WCTRANS(3)

名称

towctrans, wctransワイド文字マッピング関数

ライブラリ

Standard C Library (libc, -lc)

書式

#include < wctype.h>

wint_t
towctrans( wint_t wc, wctrans_t desc);

wctrans_t
wctrans( const char *charclass);

解説

wctrans() 関数は、要求されたワイド文字マッピング操作を表示するタイプ wctrans_t の値を返します。それは、 towctrans() への呼び出しの 2 つ目の引数として使用されます。

次の文字マッピング名が認識されます:

tolower toupper

towctrans() 関数は、 desc によって記述されたマッピングに従って、ワイド文字 wc を書き直し (transliterate) ます。

戻り値

towctrans() 関数は、成功すれば、書き直された (transliterated) 文字を返し、そうでなければ、文字を変更せずに返し、 errno を設定します。

wctrans() 関数は、成功すれば、0 以外を返し、そうでなければ、0 を返し、 errno を設定します。

使用例

towctrans() と wctrans() に関して towupper() を再実装する:

wint_t 
mytowupper(wint_t wc) 
{ 
 return (towctrans(wc, wctrans("toupper"))); 
}

エラー

towctrans() 関数は、次の場合に失敗します:
[ EINVAL]
供給された desc 引数は、無効です。

wctrans() 関数は、次の場合に失敗します:

[ EINVAL]
求されたマッピング名は、無効です。

規格

towctrans() と wctrans() 関数は、 IEEE Std 1003.1-2001 (“POSIX.1”) に適合しています。

歴史

towctrans() と wctrans() 関数は、 FreeBSD 5.0 ではじめて登場しました。
October 3, 2002 FreeBSD