locals - 2023.2 简体中文

Vitis 统一软件平台文档 嵌入式软件开发 (UG1400)

Document ID
UG1400
Release Date
2023-12-13
Version
2023.2 简体中文

获取或设置局部变量的值。

语法

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 结构体的成员。