#include <ctype.h> int toupper(int c); int tolower(int c); int toupper_l(int c, locale_t locale); int tolower_l(int c, locale_t locale);
glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):
toupper_l(), tolower_l():
c が小文字の場合、現在のロケールで大文字表現が存在する場合、 toupper() は対応する大文字を返す。大文字表現が存在しない場合、c を返す。 toupper_l() 関数は同じ動作をするが、ロケールハンドル locale が参照するロケールを使って変換を行う。
If c is an uppercase letter, tolower() returns its lowercase equivalent, if a lowercase representation exists in the current locale. Otherwise, it returns c. The tolower_l() function performs the same task, but uses the locale referred to by the locale handle locale.
もし c が unsigned char 値でも EOF でもない場合、これらの関数の動作は未定義である。
locale が特別なロケールオブジェクト LC_GLOBAL_LOCALE の場合 (duplocale(3) 参照)、または locale が有効なロケールオブジェクトハンドルでない場合、 toupper_l() と tolower_l() の動作は未定義である。
| インターフェース | 属性 | 値 |
|
toupper(),
tolower(),
toupper_l(), tolower_l() | Thread safety | MT-Safe |
toupper_l(), tolower_l(): POSIX.1-2008.
char c; ... res = toupper((unsigned char) c);
This is necessary because char may be the equivalent signed char, in which case a byte where the top bit is set would be sign extended when converting to int, yielding a value that is outside the range of unsigned char.
なにが大文字でなにが小文字なのかということの詳細は、ロケールに依存している。たとえば、デフォルトの "C" ロケールではウムラウトを認識しないため、それらの文字は変換できない。
いくつかの非英語ロケールでは、対応する大文字を持たない小文字が存在する。 ドイツ語のエスツェットが一つの例である。