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

### 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_LoadFile, Tcl_FindSymbol — OSに依存しない動的外部函数の組込み　 platform-independent dynamic library loading
  SYNOPSIS
    #include <tcl.h>
    int
    Tcl_LoadFile(interp, pathPtr, symbols, flags, procPtrs, loadHandlePtr)
    void *
    Tcl_FindSymbol(interp, loadHandle, symbol)
  引数 ARGUMENTS
    Tcl_Interp *interp (入力in)
    Tcl_Obj *pathPtr (入力in)
    const char *const symbols[] (入力in)
    int flags (入力in)
    void *procPtrs (出力out)
    Tcl_LoadHandle *loadHandlePtr (出力out)
    Tcl_LoadHandle loadHandle (入力in)
    const char *symbol (入力in)
  説明 DESCRIPTION
  SEE ALSO
  KEYWORDS

### NAME

Tcl_LoadFile, Tcl_FindSymbol — OSに依存しない動的外部函数の組込み　 platform-independent dynamic library loading

### SYNOPSIS

#include <tcl.h>
int
Tcl_LoadFile(interp, pathPtr, symbols, flags, procPtrs, loadHandlePtr)
void *
Tcl_FindSymbol(interp, loadHandle, symbol)

### 引数 ARGUMENTS

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

Tcl_Obj *pathPtr (入力in)
  組込むべきファイルの名前｡それが単一の名前の場合､それを決定する為に現在の環境の外部函数捜索経路が使用される｡　 The name of the file to load. If it is a single name, the library search path of the current environment will be used to resolve it.

const char *const symbols[] (入力in)
  外部函数組込みの間に決定されるべき symbol の名前の配列､決定すべきsymbolがない場合は NULL｡配列が与えられる場合､配列の最後の項目は NULL でなければならぬ｡　 Array of names of symbols to be resolved during the load of the library, or NULL if no symbols are to be resolved. If an array is given, the last entry in the array must be NULL.

int flags (入力in)
  値は普通は 0 の筈､但し TCL_LOAD_GLOBAL か TCL_LOAD_LAZY か､これら二つの組み合わせも同じく許容される｡　 The value should normally be 0, but TCL_LOAD_GLOBAL or TCL_LOAD_LAZY or a combination of those two is allowed as well.

void *procPtrs (出力out)
  symbols 引数内に記述された函数の番地を保有する配列を指す｡どの symbols も決定されない場合は NULL になってしまう｡　 Points to an array that will hold the addresses of the functions described in the symbols argument. Should be NULL if no symbols are to be resolved.

Tcl_LoadHandle *loadHandlePtr (出力out)
  既に組込まれた外部函数を記述する字句要旨への操作子を保有することになる変数を指す｡　 Points to a variable that will hold the handle to the abstract token describing the library that has been loaded.

Tcl_LoadHandle loadHandle (入力in)
  symbol を捜索する為の外部函数を記述する要約の字句｡　 　 Abstract token describing the library to look up a symbol in.

const char *symbol (入力in)
  捜索すべき symbol の名前｡　 The name of the symbol to look up.

### 説明 DESCRIPTION

Tcl_LoadFile はファイル系(潜在的に実装されたどの仮想ファイル系も含む)からファイルを組込みその操作子を提供するそれは､更なる操作に使用できる｡ symbols 配列は非零の場合､記号の名前の組を供給する(典型的には函数)､それは外部函数から定められなくてはならず､それは procPtrs に指定される配列に保存される｡もしどれかの記号が定まらない場合､ファイルの組込みが失敗し不都合伝言文が解釈実行機能に残される(非零の場合)｡ Tcl_LoadFile の結果は標準 Tcl 不都合符号である｡外部函数は Tcl_FSUnloadFile によって組込まれないこともある｡ Tcl_LoadFile loads a file from the filesystem (including potentially any virtual filesystem that has been installed) and provides a handle to it that may be used in further operations. The symbols array, if non-NULL, supplies a set of names of symbols (typically functions) that must be resolved from the library and which will be stored in the array indicated by procPtrs. If any of the symbols is not resolved, the loading of the file will fail with an error message left in the interpreter (if that is non-NULL). The result of Tcl_LoadFile is a standard Tcl error code. The library may be unloaded with Tcl_FSUnloadFile.

Tcl_FindSymbol は組込まれた外部函数の記号を据えて返す｡もし記号が見付られない場合､ NULL を返し不都合伝言文が解釈実行機能に残される(非零の場合)｡註意すべきは､これは操作子の不安全な操作であり､それは Tcl_FSUnloadFile に渡される｡ Tcl_FindSymbol locates a symbol in a loaded library and returns it. If the symbol cannot be found, it returns NULL and sets an error message in the given interp (if that is non-NULL). Note that it is unsafe to use this operation on a handle that has been passed to Tcl_FSUnloadFile.

### SEE ALSO

Tcl_FSLoadFile, Tcl_FSUnloadFile, load, unload

### KEYWORDS

binary code, loading, shared library
Copyright © 2009-2010 Kevin B. Kenny
Copyright © 2010 Donal K. Fellows