## Tcl9.0.3/Tk9.0.3 Documentation > Tcl Commands > source

### 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

source — ファイル又は源資をTcl記述譜として評価する Evaluate a file or resource as a Tcl script

### 構文 SYNOPSIS

source fileName

source -encoding encodingName fileName

### 説明 DESCRIPTION

この命令は指定されたファイル又は源資の内容を取り､Tcl解釈実行機能に文章記述譜として渡す｡ source の戻り値は記述譜の最後の命令を実行した値の戻り値である｡もし､記述譜の内容の評価中に不都合が生じると､ source 命令は不都合を戻す｡もし､記述譜の内部で return 命令が起動されれると､ファイルの残りは飛越しされ､source は正常に return 命令の戻り結果を伴って戻る｡ This command takes the contents of the specified file or resource and passes it to the Tcl interpreter as a text script. The return value from source is the return value of the last command executed in the script. If an error occurs in evaluating the contents of the script then the source command will return that error. If a return command is invoked from within the script then the remainder of the file will be skipped and the source command will return normally with the result from the return command.

全てのOSで､ファイルの終末は “\32” (^Z) である｡ source 命令はこの文字まで読む｡この制限は､ read や gets 命令にはなく､ファイルが､命令とデータの区分(記述された文書)を含むことを許容している｡もし文字比較のために命令中に “^Z” を使う必要がある場合は “\x1A” が使用でき､これは安全にTcl解釈実行機能により “^Z” に置換えられる｡ The end-of-file character for files is “\32” (^Z) for all platforms. The source command will read files up to this character. This restriction does not exist for the read or gets commands, allowing for files containing code and data segments (scripted documents). If you require a “^Z” in code for string comparison, you can use “\x1A”, which will be safely substituted by the Tcl interpreter into “^Z”.

ファイルに含まれる冒頭の BOM (バイト順印 Byte order mark) はユニコード符号化(utf-8, ユニコード, ucs-2)では無視される｡ A leading BOM (Byte order mark) contained in the file is ignored for unicode encodings (utf-8, utf-16, ucs-2).

-encoding 指示項目は fileName に保存されたデータの文字体系の指定に使われる｡ -encoding 指示項目が省略された場合には､utf-8符号系が仮定される｡ The -encoding option is used to specify the encoding of the data stored in fileName. When the -encoding option is omitted, the utf-8 encoding is assumed.

### 用例 EXAMPLE

ファイル foo.tcl 中の記述譜を実行し､次に､ファイル bar.tcl 中の記述譜を実行する｡ Run the script in the file foo.tcl and then the script in the file bar.tcl:

    source foo.tcl
    source bar.tcl

別法: Alternatively:

    foreach scriptFile {foo.tcl bar.tcl} {
        source $scriptFile
    }

### SEE ALSO

file, cd, encoding, info

### KEYWORDS

file, script
Copyright © 1993 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.
Copyright © 2000 Scriptics Corporation.