获取或设置局部变量的值。
语法
locals [options] [variable-name [variable-value]]
获取或设置由 <variable-name>
指定的变量的值。未指定变量名称和值时,将返回所有局部变量的值。复杂数据类型的元素(如结构)可通过“.”运算符来访问。例如,var1.int_type 表示 var1 结构体中的 int_type 元素。阵列元素可通过其索引来访问。例如,array1[0] 表示位于 array1 中的索引 0 处的元素。
选项
选项 | 描述 |
---|---|
-defs
|
用于返回变量定义,如地址、类型、大小和 RW 标志。 |
-dict
|
用于以 Tcl 词典格式返回结果,其中以变量名作为词典键,以变量值作为词典值。对于结构体之类的复杂数据,名称采用 parent.child 格式。 |
返回
返回值取决于所使用的选项。
<none>
:变量值
-defs
:变量定义
已设置变量值时,不返回任何结果。如果无法读取或设置变量值,则返回错误字符串。
示例
locals Int_Loc
返回局部变量 Int_Loc 的值。
locals
返回当前栈帧中所有局部变量的值。
locals -defs
返回当前栈帧中所有局部变量的定义。
locals Int_Loc 23
将局部变量 Int_Loc 的值设置为 23。
locals tmp_var.var1.int_type
返回 var1 结构体中的 int_type 元素值,其中,var1 是 tmp_var 结构体的成员。
locals tmp_var.var1.array1[0]
返回位于 array1 阵列中的索引 0 处的元素的值。array1 是 var1 结构体的成员,该结构体则是 tmp_var 结构体的成员。