# =============================================================================
# Tcl Dict 使用总结
# =============================================================================
# Dict (Dictionary) 是 Tcl 8.5 引入的键值对数据结构,类似于其他语言中的
# Map 或 HashMap。与 array 不同,dict 是一个值(value),可以像普通变量
# 一样传递、返回和嵌套。
# -----------------------------------------------------------------------------
# 1. 基本创建与操作
# -----------------------------------------------------------------------------
# 创建空字典
set myDict [dict create]
# 创建并初始化字典
set myDict [dict create key1 "value1" key2 "value2" key3 "value3"]
# 或者直接使用列表格式(偶数个元素)
set myDict {key1 "value1" key2 "value2"}
# 获取值
puts [dict get $myDict key1] ;# 输出: value1
# 设置/更新值(注意:dict 是不可变的,必须接收返回值)
set myDict [dict set $myDict key4 "value4"]
set myDict [dict set $myDict key1 "new_value1"]
# 批量设置/更新
set myDict [dict merge $myDict {key5 "value5" key6 "value6"}]
# 检查键是否存在
if {[dict exists $myDict key1]} {
puts "key1 exists"
}
# 删除键
set myDict [dict unset $myDict key1]
# -----------------------------------------------------------------------------
# 2. 常用命令
# -----------------------------------------------------------------------------
# dict size - 获取字典大小(键值对数量)
puts [dict size $myDict]
# dict keys - 获取所有键
set keys [dict keys $myDict]
# dict values - 获取所有值
set values [dict values $myDict]
# dict get with default - 获取值,若不存在则返回默认值
set val [dict get $myDict key1 "default_value"]
# dict filter - 过滤字典
# 按值过滤
set filtered [dict filter $myDict value *val*]
# 按键过滤
set filtered [dict filter $myDict key key*]
# dict map - 映射转换(对每个值应用脚本)
set squared [dict map {key val} $myDict {expr {$val * $val}}]
# dict invert - 反转键值(值变键,键变值)
set inverted [dict invert $myDict]
# dict replace - 替换多个键值对
set myDict [dict replace $myDict key1 "new1" key2 "new2"]
# -----------------------------------------------------------------------------
# 3. 遍历字典
# -----------------------------------------------------------------------------
# 方法1:使用 foreach(最常用)
foreach {key val} $myDict {
puts "$key => $val"
}
# 方法2:只遍历键
foreach key [dict keys $myDict] {
puts "$key => [dict get $myDict $key]"
}
# 方法3:使用 dict for(Tcl 8.6+)
dict for {key val} $myDict {
puts "$key => $val"
}
# -----------------------------------------------------------------------------
# 4. 嵌套字典
# -----------------------------------------------------------------------------
# Dict 支持嵌套,这是相比 array 的一大优势
# 创建嵌套字典
set person [dict create \
name "John" \
age 30 \
address [dict create \
city "Beijing" \
zip "100000" \
] \
]
# 访问嵌套值
puts [dict get $person address city] ;# 输出: Beijing
# 设置嵌套值
set person [dict set $person address zip "100001"]
# 使用 {*}$path 语法访问深层嵌套(Tcl 8.6+)
set city [dict get $person {*}{address city}]
# -----------------------------------------------------------------------------
# 5. 实用技巧
# -----------------------------------------------------------------------------
# 合并多个字典
set dict1 [dict create a 1 b 2]
set dict2 [dict create c 3 d 4]
set merged [dict merge $dict1 $dict2]
# 复制字典(直接赋值即可,因为 dict 是值类型)
set copyDict $myDict
# 将 dict 转换为列表
set listData [array get myArray] ;# 对于 array
set listData $myDict ;# 对于 dict,本身就是列表格式
# 安全获取嵌套值(避免错误)
proc dict_get_safe {dictVar args} {
upvar 1 $dictVar d
if {[catch {dict get $d {*}$args} result]} {
return ""
}
return $result
}
# 示例用法
set val [dict_get_safe person address city]
# -----------------------------------------------------------------------------
# 6. Dict 与 Array 对比
# -----------------------------------------------------------------------------
# | 特性 | array | dict |
# |--------------|------------------------|--------------------------|
# | 数据类型 | 变量修饰符 | 值类型 |
# | 可变性 | 原地修改 | 不可变(返回新值) |
# | 嵌套支持 | 不支持 | 支持 |
# | 函数传递 | 需通过名称引用 | 直接作为参数传递 |
# | 函数返回 | 无法直接返回 | 可直接返回 |
# | 性能 | 大型数据集较快 | 中小型数据集表现良好 |
# | 引入版本 | Tcl 早期 | Tcl 8.5+ |
# | 适用场景 | 全局状态、配置 | 局部变量、数据结构 |
# -----------------------------------------------------------------------------
# 7. 注意事项
# -----------------------------------------------------------------------------
# - 不可变性:dict 操作(set, unset, merge 等)都返回新字典,必须接收返回值
# - 键顺序:Tcl 8.6+ 保持插入顺序,早期版本不保证顺序
# - 键类型:键必须是有效的 Tcl 字符串
# - 性能:对于频繁修改的大型数据集,array 可能更高效
# - EDA 应用:在 Innovus/PrimeTime 中,dict 适合存储临时计算结果、
# 单元属性映射、时序路径信息等结构化数据
# -----------------------------------------------------------------------------
# 8. 实际应用场景示例
# -----------------------------------------------------------------------------
# 场景1:存储单元延迟信息
set cell_delays [dict create]
dict set cell_delays INVX1 rise 0.05
dict set cell_delays INVX1 fall 0.04
dict set cell_delays NAND2X1 rise 0.08
# 场景2:配置参数管理
set config [dict create \
process_node "7nm" \
voltage 0.7 \
temperature 25 \
corners [list ss tt ff] \
]
# 场景3:报告数据聚合
set report_data [dict create]
dict incr report_data total_cells 100
dict incr report_data buffer_cells 20
dict incr report_data inverter_cells 30