笔记本 Logo

Tcl Dict 使用总结Orig

作者: 走来走去 | 时间: 2026-11-10 21:37:20 | 访问: 35 [更新状态: 成功 (+1)]
# =============================================================================
# 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

Solvnet Plus | Cadence ASK | SIEMENS EDA(Calibre)
回到首页 | 时钟 | 联系信箱:yzbox#163.com(把#换成@) 沪ICP备2026057371号-1 沪公网安备31011702892617号 沪公网安备31011702892617号