作者:河许人 2024年4月3日,第四次更新
前文中,我们介绍了变量,它就像是给数据贴上了标签一样。举例来说,我们可以使用变量age来表示一个人的年龄,或者用变量name来表示一个人的名字。这种做法的好处在于,我们无需直接处理那些晦涩难懂的二进制数据,而是通过有意义的标签来引用和操作数据,这使得我们的代码更易读易懂。
然而,当我们需要处理大量的数据时,逐个命名并存储变量将变得相当繁琐。这时,数组的出现就显得十分重要了。我们可以使用一个数组来代表一组数据,每个数据的位置或关联的键就是数组的索引或键。这样,我们就能用一个标签来代表整组数据,大大减轻了我们的记忆负担。
常见的数组有两种类型:简单数组和关联数组。简单数组适用于按顺序排列的数据集合,而关联数组适用于键值对形式的数据存储。此外,还有二维数组和伪数组(形式上类似数组但实际并非数组)。这些数组类型的出现为我们处理不同类型的数据提供了更灵活的选择。
一、简单数组
简单数组是AutoHotkey中的一种基本数据结构,由一组有序的值组成,每个值都通过一个索引来访问。与许多其他编程语言不同的是,AutoHotkey的数组索引从1开始而不是0。简单数组在AutoHotkey中的应用非常广泛,可以用来存储各种类型的数据,比如数字、字符串等。它们在循环、数据处理和算法等方面都发挥着重要作用。
当涉及到对数组的增加、删除、修改和查询操作时,AutoHotkey提供了一些方便的功能和方法。下面是针对简单数组和关联数组的常见操作:
(一)创建数组:
(二)获取项:
(三)对项进行赋值:
(四)插入一个或多个东东到给定序号位置:
插入一个或多个值到给定位置.
参数
Index
类型: 整数
插入 Value1 的位置. 随后的值插入到 Index+1, Index+2, 以此类推. 指定 0 为索引等同于指定 Length + 1.Value1 …
类型: Any
要插入的一个或多个值. 要插入数组值, 请将 theArray* 作为最后一个参数传递.
备注
InsertAt 对应 RemoveAt.
先前位于 Index 的项目或 Index 右侧的所有项目都移到右侧. 缺失的参数也会被插入, 但没有值. 例如:
如果 Index 小于 -ArrayObj.Length 或大于 ArrayObj.Length + 1, 则抛出 ValueError. 例如, 对于一个包含 3 个项目的数组, Index 必须介于-3 和 4 之间(包含).
(五)追加一个或多个东东:
追加值到数组的末尾.
参数
Value …
类型: Any
要插入一个或多个值. 要插入数组值, 请将 theArray* 作为最后一个参数传递.
(六)删除数组元素的值, 使索引不包含值.
参数
Index
类型: 整数
一个有效的数组索引.
返回值
类型: Any
此方法返回删除的值(如果没有, 则为空).
Delete 不影响数组的 Length(长度).
备注
此方法不影响数组的 Length.
如果 Index 超出范围, 则抛出 ValueError.
(七)移除项:
从数组中移除项目.
参数
Index
类型: 整数
要删除的值的索引.Length
类型: 整数
如果省略, 则删除一个项目. 否则, 请指定要删除的值的范围的长度.
返回值
类型: Any
如果省略 Length, 返回删除的值(如果没有, 则返回空值). 否则就没有返回值.
备注
RemoveAt 对应 InsertAt.
如果 Index 和 Length 所表示的范围不完全在数组的当前范围内, 则抛出 ValueError.
Pos 侧的其余项将根据 Length 向左移动(如果省略则为 1). 例如:
(八)移除最后一项:
删除并返回最后的数组元素.
下面这些都是等同的:
如果数组为空(Length 为 0), 则抛出 Error.
如果数组不是空的, 那么 MinIndex和MaxIndex/Length 分别返回数组中当前使用的最小和最大的索引. 由于最小的索引几乎总是 1, 所以 MaxIndex 经常返回项目数. 如果没有整数键, MaxIndex 返回空而 Length 返回 0 ,对数组内容进行依次循环可以通过索引或 For 循环实现。
例如:
AutoHotkey v1.1语法
AutoHotkey v2.0语法
(九)返回对象的一个浅拷贝:
所有数组元素都被复制到新数组. 对象 引用 被复制(就像普通的赋值一样), 而不是对象本身.
根据 Obj.Clone 来复制自有的属性, 方法和基.
(十)返回给定索引处的值, 或默认值.
该方法执行如下操作:
- 如果 Index 为零或超出范围, 则抛出 IndexError.
- 返回 Index 处的值, 如果有(请参阅 Has).
- 如果指定, 则返回 Default 参数的值.
- 如果定义, 则返回
ArrayObj.Default的值. - 抛出 UnsetItemError.
当 Default 被省略时, 它等价于 ArrayObj[Index], 除了没有调用 __Item.
(十一)Has
如果 Index 有效且在该位置有一个值, 则返回返回一个非零数字.
(十二)_New
追加项目. 等同于 Push.
这个方法是为了支持 Call 而存在的, 并不打算直接调用. 请参阅构造和销毁.
(十三)__Enum
枚举数组元素.
返回一个新的枚举器. 该方法通常不直接调用. 而是将数组对象被直接传递给 for-loop, 其调用一次 __Enum 然后循环的每次迭代都调用一次枚举器. 每次对枚举器的调用都会返回下一个数组元素. for-loop 的变量对应于枚举器的参数, 它们是:Index
类型: 整数
数组索引, 通常与 A_Index 相同. 其仅在两参数模式下存在.Value
类型: Any
值(如果没有, 则 Value 为未初始化值).
(十四)属性
1.Length
检索或设置数组的长度.
长度包含没有值的元素. 因增加长度而产生的索引是有效的, 但是新元素没有值(由 Has 反映出来). 减小长度将截断数组.
2.Capacity
检索或设置数组的当前容量.
MaxItems 是一个整数, 表示数组在必须自动扩展之前可以包含的最大元素数量. 如果设置的值小于 Length, 则删除多的元素.
3.Default
定义请求没有值的元素时返回的默认值.
默认情况下, 该属性实际上不存在, 但是可以由脚本定义. 如果被定义, 如果请求的元素没有值, 它的值将由 __Item 或 Get 返回, 而不是抛出 UnsetItemError. 它可以通过任何常规方法实现, 包括动态属性或元函数, 但要确定查询的是哪个键, 则需要重写 __Item 或 Get.
设置默认值并不会在索引超出范围时防止抛出错误.
4.__Item
检索或设置数组元素的值.
Index 是一个表示有效的数组索引的整数; 即, 一个绝对值在 1 和 Length(包括) 之间的整数. 负索引可用于反向处理元素, 因此 -1 是最后一个元素, -2 是倒数第二个元素, 依此类推. 尝试使用超出范围的数组索引(例如零, 或者其绝对值大于数组的 Length(长度)) 被视为错误, 并将导致抛出 IndexError.
如上所示, 属性名 __Item 通常被省略, 但在覆盖属性时使用.
二、关联数组(map)
AutoHotkey v1.1到v2.0版本,关联数组发生了比较大的变化。
(一)AutoHotkey v1.1
关联数组是一种数据结构,内容是键值对,本质上是一种特殊的对象。操作关联数组自包含关联数组可以使用以下两种创建:
也可以,先建一个空数组,然后填充键和值。
注:除了数字,还可以把字符串和对象作为键使用。对象可以作为值存储到其他对象中并且可以作为函数参数或返回值传递。
创建完数组,就可以访问了。
也可以遍历。
对于这样特殊的关联数组,还可以把上面的 For 循环替换为 Loop 循环:
实际上不建议使用 Loop 对关联数组进行循环操作(很蹩脚),上面的例子中数组的索引从 1 开始且是连续的整数,所以可以使用 Loop 循环。然而,关联数组中的键可以为字符串、整数或对象,即使键为整数时还可能是稀疏分布的,例如{1:"a",1000:"b"},在这些一般情况下都无法使用 Loop 代替。
(二)AutoHotkey v2.0
Map或关联数组是包含一组键(每个键是唯一的) 和一组值的对象, 其中每个键和一个值关联. 键可以为字符串, 整数或对象, 而值可以为任何类型. 关联数组可以用如下方法
1.创建:
这等同于使用用 MapObj[Key] := Value 来设置每个项目, 除了 __Item 没有被调用, 而且 Capacity 会被自动调整以避免在一次调用中多次扩展.
2.检索一个项目, 其中 键 可以是变量或表达式:
3.赋值项目:
4.使用 Delete 方法移除项目:
任意一个键. 如果映射不包含此键, 则抛出 UnsetItemError。返回值-类型: Any,此方法返回删除的值。
5.枚举项目:
6.从映射中删除所有键-值对:
7.返回对象的一个浅拷贝.
所有键-值对都被复制到新映射. 对象 引用 被复制(就像普通的赋值一样), 而不是对象本身.
根据 Obj.Clone 来复制自有的属性, 方法和基.
8.返回键关联的值, 或者一个默认值.
此方法执行以下操作:
- 返回与 Key 关联的值, 如果找到.
- 如果 Default 参数的值, 如果指定.
- 返回
MapObj.Default的值, 如果定义. - 抛出 UnsetItemError.
当 Default 被省略时, 这等同于 MapObj[Key], 除了没有调用 __Item.
9.查找一个key,如果 Key 在映射中有关联的值, 则返回 true, 否则返回 false.
10.设置零个或多个项目.
这相当于用 MapObj[Key] := Value 来设置每个项目, 除了 __Item 没有被调用和 Capacity 会被自动调整, 以避免在一次调用中扩展多次.
返回值
类型: Object
此方法返回 map 对象.
11.__Enum
枚举键-值对.
返回一个新的枚举器. 该方法通常不直接调用. 而是将映射对象被直接传递给 for-loop, 其调用一次 __Enum 然后循环的每次迭代都调用一次枚举器. 每次对枚举器的调用都会返回下一个键和/或值. for-loop 的变量对应于枚举器的参数, 它们是:Key
类型: 整数, 对象或字符串
键.Value
类型: Any
值.
12.__New
设置项目. 等同于 Set.
这个方法是为了支持 Call 而存在的, 并不打算直接调用. 请参阅构造和销毁.
13.属性
(1)Count
检索映射中存在的键-值对的数量.
(2)Capacity
检索或设置映射的当前容量.
MaxItems 是一个整数, 表示在必须自动扩展前, 映射可以包含的最大键-值对数量. 如果设置的值小于当前键-值对数量, 则使用设置的值并释放未使用的空间.
(3)CaseSense
检索或设置映射的大小写敏感性设置.
如果已经赋值, CurrentSetting 为 NewSetting, 否则默认为 On(但请注意, 该属性只能检索当前设置的字符串变量).
NewSetting 是以下字符串或整数(布尔值) 之一:
On 或 1(true): 键查找区分大小写. 这是默认设置.
Off 或 0(false): 键查找不区分大小写, 即字母 A-Z 被认为与对应小写字母相同.
Locale: 根据当前用户的区域设置规则, 键查找不区分大小写. 例如, 大多数英语和西欧地区不仅将字母 A-Z视为与其对应的小写字母相同, 而且将非 ASCII 字母(如 Ä 和 Ü) 视为与其对应的字母相同. Locale 比 Off 慢 1 到 8 倍, 具体取决于所比较字符串的性质.
如果 Map 不是空的, 尝试为该属性赋值将导致抛出异常.
(4)Default
定义当没有找到键时返回的默认值.
默认情况下, 这个属性实际上并不存在, 但可以由脚本定义. 如果定义了, 如果无法找到请求的项, 则由 __Item 或 Get 返回其值, 而不是抛出 UnsetItemError. 它可以通过任何正常的方式来实现, 包括动态属性或元函数, 但确定哪个键被查询到, 需要覆盖 __Item 或 Get 来代替.
(5)__Item
检索或设置键-值对的值.
检索值时, Key 必须是先前与另一个值关联的唯一值. 如果 Key 在映射中没有关联的值, 则抛出 UnsetItemError, 除非定义了 Default 属性, 在这种情况下返回其值.
赋值时, 与 Value 关联的 Key 可以是任何值; 换句话说, key 用于以后访问 Value. 浮点键会自动转换为字符串.
如上所示, 属性名 __Item 通常被省略, 但在覆盖属性时使用.
三、二维(多维)数组
尽管不支持 “多维” 数组, 但是脚本可以组合多个数组或映射,来实现二维和多维数组的效果。
(一)数据结构
| Arr [x↓ ,y→ ] := 值 | PID |
|---|---|
| TestSuite | 9448 |
| 定时器 | 8256 |
(二)例子
AutoHotkey v1.1语法
AutoHotkey v2.0语法,v2.0语法更加严谨,必须预定义数组空间才可以使用。不管怎么看都显得更麻烦了,而且好像不够强大了。
更方便点的二维数组
更方便点的二维关联数组
四、伪数组
伪数组应该是AutoHotkey中特有的概念,每个伪数组实际上只是一系列连续编号的变量或函数的集合,它们的每一个被视为伪数组的“元素”。AutoHotkey 内部不会以任何方式把这些元素链接在一起。任何接受 OutputVar 或能赋值的命令都可以用来创建伪数组。
最简单的例子是使用赋值运算符(:=),如下所示:
通过在索引间使用自选分隔符可以创建多维伪数组,例如:
操作伪数组下面的例子演示了如何创建和访问伪数组,这里是从文本文件获取一系列的名称:
五、数组、伪数组与关联数组的之间的比较和应用
尽管 Insert() 和枚举数有它们的用途, 不过一些用户可能会发现使用它们比用更传统的方式容易些。下面的例子中把伪数组和关联数组的操作方式进行比较,其中注释中的为伪数组的操作方式:
这个是帮助中的例子,但实际意义不大,因为它是以伪数组的方式在伪数组的功能上进行的比较。例如使用 ArrayCount 变量保存数组元素个数,我们知道这对于关联数组是多余的,它的元素个数是由程序维护,可以直接使用 MaxIndex() 方法获取,而且获取值时无需通过元素个数,可直接 for 循环。帮助中提到这个比较会“让大家更容易从原来使用伪数组的习惯中过渡过来”,不过我个人认为这样做是否像用汉字标出英语单词的发音来学英语呢?
关联数组使用与简单数组非常相似的语法. 事实上, 在 v1.x 中它们是相同的东西. 然而, 把[] 视为简单线性数组有助于保持其作用清晰, 并且改善您脚本与 AutoHotkey 未来版本的兼容性, 未来版本中可能改变实现方式.
看过这两个例子后,里面的操作中我们只是连续的操作变量罢了,与操作普通变量在性质上没有区别。唯一的区别是名称,这系列变量的名称一般后面部分为数字,比较典型的如 StringSplit、WinGet List 及 RegExMatch 这些命令创建的伪数组。还有些命令虽然会创建一系列变量,变量的名称却不是以数字结尾,如 GuiControlGet Pos、SysGet 等。
六、技巧
数组可以用地址拆分
七、小结
目前而言,在支持创建伪数组的命令中还是需要伪数组(伪数组存在的必要性),在其他地方关联数组具有优势(关联数组的功能强大、使用方便),即关联数组尚无法完全取代伪数组(即使作为中间产物),尽管我推荐在一般情况下使用关联数组。

