7.9.8.77.GEL_SymbolAdd()

加载其他符号信息。

句法

GEL_SymbolAdd(“fileName [, “cpuName] [, “boardName]);

参数

fileName 为包含符号信息的符号文件命名。fileName 必须括在引号内。符号文件可以是标准 COFF 输出文件 (*.out) 或在构建过程中获取的特定符号文件。

cpuName(可选)是用于加载符号信息的 CPU 的名称(在多处理器环境中很有用)。cpuName 必须括在引号内。

boardName(可选)是用于加载符号信息的电路板的名称。如果未指定,请使用执行此 GEL 函数的处理器的电路板名称。boardName 必须括在引号内。

描述

符号信息可以附加到现有符号表中。此函数从指定符号文件加载符号信息。GEL_SymbolAdd 与 GEL_SymbolLoad 的不同之处在于,在加载新符号之前,它不会清除现有符号表的内容。

如果文件不在当前目录中,请在字符串内提供完整路径名称。需要使用双反斜杠转义序列,以确保在 fileName 参数中添加反斜杠。

cpuName 和 boardName 参数必须与多处理器设置中配置的处理器名称和电路板名称相匹配。在单处理器系统中,用户无需填写这些字段。

同步

从 GEL 同步:否

完全同步:否

示例

GEL_SymbolAdd(“c:\mydir\myfile.out”, “cpu_a”, “Emulator”);

相关主题

GEL_Load()

GEL_SymbolAddRel()

GEL_SymbolLoad()

GEL_SymbolAddRel()

GEL_SymbolRemove()

GEL_UnloadAllSymbols()