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 |