load(3tcl)

NAME
load - 装载机器代码并初始化新命令。

总览 SYNOPSIS
load fileName
load fileName packageName
load fileName packageName interp

描述 DESCRIPTION

这个命令把二进制代码从一个文件装载到应用的地址空间中并调用在包(package)中的初始化过程来把它加入到解释器中。fileName 是包含代码的文件的名字；它准确的形式在不同的系统上是不同的，但在多数系统上是一个共享库，例如，在 Solaris 下的 .so 文件或在 Windows 下的一个 DLL。packageName 是包的名字，并被用于计算初始化过程的名字。interp 是要在其中装载包的解释器的路径名(详情参见 interp 手册条目)；如果省略了 interp ，它的缺省是在其中调用 load 命令的那个解释器。

一旦已经被装载到应用的地址空间中，两个初始化过程之一将在新代码中被调用。典型的，初始化进程将向一个 Tcl 解释器添加新命令。初始化过程的名字由 packageName 和目标解释器是否是安全解释器来确定。对于通常的解释器，初始化过程的名字的形式是 pkg_Init，这里 pkg 与 packageName 相同，但是第一个字母被转换成大写而所有其他字母被转换成小写。例如，如果 packageName 是 foo 或 FOo，则初始化过程的名字将是 Foo_Init。

如果目标解释器是一个安全解释器，则初始化过程的名字将是 pkg_SafeInit 而不是 pkg_Init。写 pkg_SafeInit 函数要仔细，在包中提供的功能中，只用由不可信任的代码使用是安全的的那部分初始化安全解释器。 关于 Safe-Tcl 的详细的信息，请参见 safe 手册条目。

初始化过程必须匹配下列原型 (prototype): typedef int Tcl_PackageInitProc(Tcl_Interp *interp); interp 参数标识在其中装载包的解释器。初始化过程必须返回 TCL_OK 或 TCL_ERROR 来指示是否成功完成；在有错误的情况下，应把解释器的结果设置为指向一个错误消息。初始化过程返回的结果就是 load 命令的结果。

在一个应用中对每个 fileName 只进行一次文件的实际装载。如果一个给定的 fileName 被装载到多个解释器中，则第一个 load 将装载代码并调用初始化过程；随后的 load 将调用初始化过程而不再次装载代码 。不可能卸载或重载一个包。

load 命令还支持同应用静态连接的包，条件是这些包已经通过调用 Tcl_StaticPackage 过程注册过了。如果 fileName 是一个空串，则必须指定packageName 。

如果省略了 packageName 或被指定为一个空串，Tcl 尝试着猜出包的名字。在不同的平台上可能是不同的。在多数 UNIX 平台上，缺省的猜测是接受 fileName 的最后的组成部分，如果前三个字符是 lib 就去掉它们，使用所有随后的 字母和下划线作为模块的名字。 例如，命令 load libxyz4.2.so 使用模块名 xyz 而命令 load bin/last.so {} 使用模块名 last。

如果 fileName 是一个空串，则必须指定 packageName。load 命令首先用这个名字查找一个静态装载包(通过调用 Tcl_StaticPackage 过程注册的包)；如果找到了就使用它。否则，load 命令用这个名字查找动态装载包，如果找到就使用它。如果一些不同的文件被装载成包的不同版本，Tcl 选择被最先装载的文件。

移植要点 PORTABILITY ISSUES

Windows
    在装载出现 "library not found" 错误的时候，也有可能是没找到一个依赖库。要查看依赖库，在一个 DOS 控制台中“dumpbin -imports <dllname>”来查看必须导入那些库。在当前目录中装载一个 DLL 的时候，Windows 将忽略作为一个路径指定符(specifier)的“./”，转而使用一次启发式(heuristic)的查找来找到这个 DLL。要避免如此，装载DLL 就要用
        load [file join [pwd] mylib.DLL]

BUGS

如果以不同的fileNames 装载同一个文件，它将被多次载入这个进程的地址空间。在不同的系统上装载的行为是不同的(一些系统可以检测多余的装载，其他的可能不能)。

参见 SEE ALSO
info sharedlibextension, Tcl_StaticPackage(3), safe(n)

关键字 KEYWORDS
binary code, loading, safe interpreter, shared library

[中文版维护人]
寒蝉退士

[中文版最新更新]
2001/08/30

《中国 Linux 论坛 man 手册页翻译计划》:
http://cmpp.linuxforum.net