## Tcl8.6.17/Tk8.6.17 Documentation > Tcl C API > ToUpper

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    Tcl_UniCharToUpper, Tcl_UniCharToLower, Tcl_UniCharToTitle, Tcl_UtfToUpper, Tcl_UtfToLower, Tcl_UtfToTitle — ユニコード文字とutf-8文字列の大文字小文字操作の為の業務譜　　　 routines for manipulating the case of Unicode characters and UTF-8 strings
  SYNOPSIS
    #include <tcl.h>
    Tcl_UniChar
    Tcl_UniCharToUpper(ch)
    Tcl_UniChar
    Tcl_UniCharToLower(ch)
    Tcl_UniChar
    Tcl_UniCharToTitle(ch)
    int
    Tcl_UtfToUpper(str)
    int
    Tcl_UtfToLower(str)
    int
    Tcl_UtfToTitle(str)
  引数 ARGUMENTS
    int ch (入力in)
    char *str (入出力in/out)
  説明 DESCRIPTION
  瑕疵 BUGS
  KEYWORDS

### NAME

Tcl_UniCharToUpper, Tcl_UniCharToLower, Tcl_UniCharToTitle, Tcl_UtfToUpper, Tcl_UtfToLower, Tcl_UtfToTitle — ユニコード文字とutf-8文字列の大文字小文字操作の為の業務譜　　　 routines for manipulating the case of Unicode characters and UTF-8 strings

### SYNOPSIS

#include <tcl.h>
Tcl_UniChar
Tcl_UniCharToUpper(ch)
Tcl_UniChar
Tcl_UniCharToLower(ch)
Tcl_UniChar
Tcl_UniCharToTitle(ch)
int
Tcl_UtfToUpper(str)
int
Tcl_UtfToLower(str)
int
Tcl_UtfToTitle(str)

### 引数 ARGUMENTS

int ch (入力in)
  変換対象のユニコード文字｡　　　　 The Unicode character to be converted.

char *str (入出力in/out)
  その場で変換される UTF-8 文字列へのポインタ｡ Pointer to UTF-8 string to be converted in place.

### 説明 DESCRIPTION

最初の３つの函数は個別のユニコード文字の大文字小文字変換をする｡ The first three routines convert the case of individual Unicode characters:

もし ch が小文字を表す場合､Tcl_UniCharToUpper は対応する大文字を返す｡もし､大文字が定義されていない場合変更せずに返す｡ 　 If ch represents a lower-case character, Tcl_UniCharToUpper returns the corresponding upper-case character. If no upper-case character is defined, it returns the character unchanged.

もし ch が大文字を表す場合､Tcl_UniCharToLower は対応する小文字を返す｡もし､小文字が定義されていない場合変更せずに返す｡ 　　 If ch represents an upper-case character, Tcl_UniCharToLower returns the corresponding lower-case character. If no lower-case character is defined, it returns the character unchanged.

もし ch が小文字を表す場合､Tcl_UniCharToTitle は対応する大文字開始文字を返す｡もし､大文字開始文字が定義されていない場合対応する大文字を返す｡もし､大文字が定義されていない場合変更せずに返す｡大文字開始文字は大文字で開始した時と異なる外観を有するごく小数の文字に定義されている｡ 　　　 If ch represents a lower-case character, Tcl_UniCharToTitle returns the corresponding title-case character. If no title-case character is defined, it returns the corresponding upper-case character. If no upper-case character is defined, it returns the character unchanged. Title-case is defined for a small number of characters that have a different appearance when they are at the beginning of a capitalized word.

次の３つの函数は記憶域内のユニコード文字列の大文字小文字変換をする｡ 　　　 The next three routines convert the case of UTF-8 strings in place in memory:

Tcl_UtfToUpper は str 内の全ての UTF-8 文字を大文字に変更する｡文字を大文字に変更することによりその領域の寸法が変わる場合､結果の文字列内のそれぞれの文字のバイトの偏寄が元の場所と異なるかもしれない｡ Tcl_UtfToUpper は変更された文字列の末尾に零バイトを書込む｡Tcl_UtfToUpper は文字列の新しいバイト単位の長さを返す｡この新しい長さは最早元の長さを保障しない｡ Tcl_UtfToUpper changes every UTF-8 character in str to upper-case. Because changing the case of a character may change its size, the byte offset of each character in the resulting string may differ from its original location. Tcl_UtfToUpper writes a null byte at the end of the converted string. Tcl_UtfToUpper returns the new length of the string in bytes. This new length is guaranteed to be no longer than the original string length.

Tcl_UtfToLower は文字列内のそれぞれの文字を等価な小文字に変更する以外は Tcl_UtfToUpper と同じである｡ Tcl_UtfToLower is the same as Tcl_UtfToUpper except it turns each character in the string into its lower-case equivalent.

Tcl_UtfToTitle は文字列内の最初の文字を等価な大文字開始文字に､続く文字を等価な小文字に変更する以外は Tcl_UtfToUpper と同じである｡ Tcl_UtfToTitle is the same as Tcl_UtfToUpper except it turns the first character in the string into its title-case equivalent and all following characters into their lower-case equivalents.

### 瑕疵 BUGS

現在､大文字小文字変換は ISO8859-1 文字にのみ定義されている｡ 0x00ff 以上のユニコード文字はこれら函数では修正されない｡ 　　 At this time, the case conversions are only defined for the Unicode plane 0 characters. The result for Unicode characters above 0xFFFF is undefined, but - actually - only the lower 16 bits of the character value is handled.

### KEYWORDS

utf, unicode, toupper, tolower, totitle, case
Copyright © 1997 Sun Microsystems, Inc.