## Tcl9.0.3/Tk9.0.3 Documentation > Tcl C API > GetInt

### 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_GetInt, Tcl_GetDouble, Tcl_GetBoolean — 文字列を整数や､倍精度実数や､論理値に変換する convert from string to integer, double, or boolean
  SYNOPSIS
    #include <tcl.h>
    int
    Tcl_GetInt(interp, src, intPtr)
    int
    Tcl_GetDouble(interp, src, doublePtr)
    int
    Tcl_GetBoolean(interp, src, intPtr)
    int
    Tcl_GetBool(interp, src, flags, charPtr)
  引数 ARGUMENTS
    Tcl_Interp *interp (入力in)
    const char *src (入力in)
    int *intPtr (出力out)
    double *doublePtr (出力out)
    char *charPtr (出力out)
    int flags (入力in)
  説明 DESCRIPTION
  KEYWORDS

### NAME

Tcl_GetInt, Tcl_GetDouble, Tcl_GetBoolean — 文字列を整数や､倍精度実数や､論理値に変換する convert from string to integer, double, or boolean

### SYNOPSIS

#include <tcl.h>
int
Tcl_GetInt(interp, src, intPtr)
int
Tcl_GetDouble(interp, src, doublePtr)
int
Tcl_GetBoolean(interp, src, intPtr)
int
Tcl_GetBool(interp, src, flags, charPtr)

### 引数 ARGUMENTS

Tcl_Interp *interp (入力in)
  不都合を報告する為に使用する解釈実行機能｡　 Interpreter to use for error reporting.

const char *src (入力in)
  変換すべき文書的値｡　 Textual value to be converted.

int *intPtr (出力out)
  源資から変換された整数を保存する為の場所を指す｡　 Points to place to store integer value converted from src.

double *doublePtr (出力out)
  倍精度浮動少数点数を保存する為の場所を指す｡　 Points to place to store double-precision floating-point value converted from src.

char *charPtr (出力out)
  srcから変換された論理値(0 or 1)値を保存する場所を指す｡ Points to place to store boolean value (0 or 1) value converted from src.

int flags (入力in)
  0 か TCL_NULL_OK｡もし､TCL_NULL_OKが使われると､ 空文字列又はNULLがTcl_GetBoolの結果になりTCL_OKを返す､ *charPtrは値'\xFF'で満たされる｡ 0 or TCL_NULL_OK. If TCL_NULL_OK is used, then the empty string or NULL will result in Tcl_GetBool return TCL_OK, the *charPtr filled with the value '\xFF';

### 説明 DESCRIPTION

これ等の手続函数は文字列を整数や倍精度浮動小数点値や論理値( 0 か 1 の値を有する整数として表現される)に変換する｡夫々の手続函数は src 引数を取り､特定の内部の形式に変換し手続函数の三番目の引数によって指し示される位置に変換された値を保存する｡もし､全てが巧くいくと､夫々の手続函数は TCL_OK を返す｡もし src が望ましい適切な構文を有さない場合､ TCL_ERROR が返され､不都合伝言文が解釈実行機能の結果の中に保存され､ *intPtr や *doublePtr の箇所には何も保存されない｡ 　　 These procedures convert from strings to integers or double-precision floating-point values or booleans (represented as 0- or 1-valued integers). Each of the procedures takes a src argument, converts it to an internal form of a particular type, and stores the converted value at the location indicated by the procedure's third argument. If all goes well, each of the procedures returns TCL_OK. If src does not have the proper syntax for the desired type then TCL_ERROR is returned, an error message is left in the interpreter's result, and nothing is stored at *intPtr or *doublePtr.

Tcl_GetInt は src が 整数数字の集合から構成され､任意的な符号付加と､任意的に空白が先導されるか後置されることを期待する｡もし追加追加された空白と符号の後の src の初めの二つの文字が “0x” であると､ src は十六進数形式であることが期待される; それ以外の場合､もし最初のその様な文字が “0d” であると､ src は十進数形式であることが期待される; それ以外の場合､もし最初のその様な文字が “0o” の場合 src は八進数形式であることが期待される; それ以外の場合､もし最初のその様な文字が “0b” の場合 src は二進数形式であることが期待される; それ以外の場合 src は十進数形式であることが期待される｡ Tcl_GetInt expects src to consist of a collection of integer digits, optionally signed and optionally preceded and followed by white space. If the first two characters of src after the optional white space and sign are “0x” then src is expected to be in hexadecimal form; otherwise, if the first such characters are “0d” then src is expected to be in decimal form; otherwise, if the first such characters are “0o” then src is expected to be in octal form; otherwise, if the first such characters are “0b” then src is expected to be in binary form; otherwise, src is expected to be in decimal form.

Tcl_GetDouble は src が浮動小数点数から構成されると期待する､それは: 空白; 符号; 数字の継続; 小数点 “.”; 数字の継続; 文字 “e”; 符号付十進冪数; 更なる空白である｡どの欄も省略され得る､但し､小数点の後か前のどちらかに数字が存在しなくてはならず､且つ､もし “e” がある場合はそれに冪数が続かなくてはならない｡符号と先頭の十進数の並びから離れた欄がない場合(即ち､小数点や冪数がない)､その先頭の十進数の並びは 上述の Tcl_GetInt が運営している書式の内のどれかであるべきである｡小数点としての “,” の使用は運営されていないし､整数の区切りの類も存在すべきではない｡[訳注 ドイツ流の数字書式は運営しないとの意味｡若干偏狭] Tcl_GetDouble expects src to consist of a floating-point number, which is: white space; a sign; a sequence of digits; a decimal point “.”; a sequence of digits; the letter “e”; a signed decimal exponent; and more white space. Any of the fields may be omitted, except that the digits either before or after the decimal point must be present and if the “e” is present then it must be followed by the exponent number. If there are no fields apart from the sign and initial sequence of digits (i.e., no decimal point or exponent indicator), that initial sequence of digits should take one of the forms that Tcl_GetInt supports, described above. The use of “,” as a decimal point is not supported nor should any other sort of inter-digit separator be present.

Tcl_GetBooleanは､srcが論理値を指定する事を期待する｡ もし､srcが､0かfalseかnoかoffのどれかであると､Tcl_GetBooleanは*intPtrの処に零値を保存する｡ もし､srcが､1かtrueかyesかonのどれかであると､*intPtrの処に1を保存する｡ これ等のどの値も､短縮化でき､且つ､大文字綴りも受容れられる｡ Tcl_GetBoolean expects src to specify a boolean value. If src is any of 0, false, no, or off, then Tcl_GetBoolean stores a zero value at *intPtr. If src is any of 1, true, yes, or on, then 1 is stored at *intPtr. Any of these values may be abbreviated, and upper-case spellings are also acceptable.

Tcl_GetBool函数は殆どTcl_GetBooleanと同じであるが､但し､追加の假引数flagsがあり､空文字列又はNULLを適正として受容れるか否かの指定に使える｡ Tcl_GetBool functions almost the same as Tcl_GetBoolean, but it has an additional parameter flags, which can be used to specify whether the empty string or NULL is accepted as valid.

### KEYWORDS

boolean, conversion, double, floating-point, integer
Copyright © 1989-1993 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.