# =============================================================================
# Tcl Array 使用总结
# =============================================================================
# -----------------------------------------------------------------------------
# 1. 基本操作
# -----------------------------------------------------------------------------
# 设置单个元素
set myArray(key1) "value1"
set myArray(key2) "value2"
# 使用 array set 批量设置
array set myArray {
key1 "value1"
key2 "value2"
key3 "value3"
}
# 读取元素
puts $myArray(key1) ;# 输出: value1
puts [array get myArray] ;# 获取所有键值对列表
# 检查元素是否存在
if {[info exists myArray(key1)]} {
puts "key1 exists"
}
# 删除元素
unset myArray(key1) ;# 删除单个元素
unset myArray ;# 删除整个数组
# -----------------------------------------------------------------------------
# 2. 常用命令
# -----------------------------------------------------------------------------
# array names - 获取键名列表
set keys [array names myArray] ;# 获取所有键
set keys [array names myArray "key*"] ;# 获取匹配模式的键
set keys [lsort [array names myArray]] ;# 按排序获取
# array size - 获取数组大小
puts [array size myArray] ;# 返回元素个数
# array get / array set - 转换格式
set listData [array get myArray] ;# 数组转列表
array set newArray $listData ;# 列表转数组
# array exists - 检查是否为数组
if {[array exists myArray]} {
puts "myArray is an array"
}
# -----------------------------------------------------------------------------
# 3. 遍历数组
# -----------------------------------------------------------------------------
# 方法1:使用 foreach
foreach key [array names myArray] {
puts "$key => $myArray($key)"
}
# 方法2:使用 array startsearch / array nextelement
set searchId [array startsearch myArray]
while {[array anymore myArray $searchId]} {
set key [array nextelement myArray $searchId]
puts "$key => $myArray($key)"
}
array donesearch myArray $searchId
# -----------------------------------------------------------------------------
# 4. 多维数组模拟(复合键)
# -----------------------------------------------------------------------------
set matrix(0,0) 1
set matrix(0,1) 2
set matrix(1,0) 3
set matrix(1,1) 4
puts $matrix(1,0) ;# 输出: 3
# -----------------------------------------------------------------------------
# 5. 实用技巧
# -----------------------------------------------------------------------------
# 默认值处理
proc array_get_default {arr key default} {
upvar 1 $arr a
if {[info exists a($key)]} {
return $a($key)
} else {
return $default
}
}
# 合并数组
array set mergedArray [concat [array get array1] [array get array2]]
# 复制数组
array set copyArray [array get originalArray]
# -----------------------------------------------------------------------------
# 6. 注意事项
# -----------------------------------------------------------------------------
# - 键是字符串:Tcl 数组的键始终是字符串,即使是数字也会被转换为字符串
# - 全局作用域:在过程中访问全局数组需要使用 global 或 upvar
# - 性能:对于大型数据集,考虑使用字典(dict),在某些场景下性能更好
# - 键区分大小写:Key 和 key 是不同的键
# -----------------------------------------------------------------------------
# 7. Array vs Dict 对比
# -----------------------------------------------------------------------------
# | 特性 | array | dict |
# |------------|----------------|-------------------|
# | 引入版本 | Tcl 早期版本 | Tcl 8.5+ |
# | 可变性 | 直接修改 | 不可变(返回新值) |
# | 嵌套 | 不支持 | 支持 |
# | 传递方式 | 通过名称引用 | 作为值传递 |
# | 适用场景 | 全局状态、 | 局部变量、 |
# | | 大型数据集 | 函数返回值 |
# Tcl 数组在 EDA 工具(如 Innovus、PrimeTime)的 Tcl 脚本中广泛应用,
# 常用于存储配置参数、设计数据和中间结果。