Sort
以字母、数字或随机顺序排列变量的内容(可以选择是否移除重复项)。
Sort, VarName [, Options]
参数
- VarName
内容需要排序的变量名.
- 选项
请参阅后面的列表.
选项
由零个或多个下列字母组成的字符串 (可任意顺序, 字母间可以用空格分隔):
C: 区分大小写的排序 (如果同时存在 N 选项则此选项被忽略). 如果同时省略 C 和 CL, 则在排序中大写字母 A-Z 被视为等同于它们相应的小写形式.
CL [v1.0.43.03+]: 基于当前用户区域设置的不区分大小写的排序. 例如, 大多数英语和西欧地区把字母 A-Z 和 ANSI 字母例如 Ä 和 Ü 等同于它们的小写形式. 这种方法也使用 "单词排序", 它把单词中的连字符和撇号例如 "coop" 和 "co-op" 保持在一起. 根据需要排序的内容, 它的执行性能比默认的不区分方法差了 1 到 8 倍.
Dx:指定 x 作为分隔符,它决定了 VarName 中每个项目的开始和结束。如果此选项不存在, 则 x 默认为换行符 (`n), 这样当 VarName 中每行以 LF (`n) 或 CR+LF (`r`n) 结尾时都可以正确排序.
F MyFunction [v1.0.47+]: 根据 MyFunction 中的标准进行自定义排序 (然而这样的排序需要更长的时间). 指定字母 "F" 后跟着可选的空格/tab, 然后是可以对列表中的任意两项进行比较的 函数 名. 此函数必须接受两个或三个参数. 当函数判断出首个参数大于第二个时, 它应该返回正整数; 当判断出两个参数相等时, 应该返回 0, "" 或不返回; 否则它应该返回负整数. 如果返回值中包含小数部分, 则这部分被忽略 (即 0.8 等同于 0). 如果含有第三个参数, 则它接受原始/未排序列表中第二个项目相对于第一个的偏移 (字符数) (请参阅示例). 最后, 此函数使用和调用它的 Sort 命令相同的全局设置 (例如 StringCaseSense).
注: F 选项会使得除 D, Z 和 U 外的选项被忽略 (尽管如此, 但 N, C 和 CL 仍会影响对于 重复项 的检测). 并且, 当指定的函数出现下列情况时不会进行排序: 1) 函数不存在; 2) 接受的参数个数少于两个; 或 3) 第一或第二个参数为 ByRef 类型.
N: 数值排序: 把每个项目看成数字而不是字符串进行排序 (例如, 如果此选项不存在, 则根据字母顺序字符串 233 被认为小于字符串 40). 十进制和十六进制字符串 (例如 0xF1) 都被认为是数字. 不是以数字开头的字符串在排序中被看成是零. 把数字作为64位浮点值进行处理,这样可以考虑到小数部分的每位数字(如果有)。
Pn: 根据第 n 个位置的字符进行排序 (n 不能为十六进制数). 如果此选项不存在, 则 n 默认为 1, 这是首个字符的位置. 在字符串间排序比较时从它们的第 n 个字符开始. 如果 n 大于某个字符串的长度, 则在排序中此字符串被看成是空的. 和选项 N (数值排序) 一起使用时, 此时使用字符串的字符位置, 它不一定和数字位的位置相同.
R: 逆向排序 (根据其他选项进行字母或数字排序).
Random: 随机排序. 此选项会使得除 D, Z 和 U 外的其他选项被忽略 (尽管如此, 但 N, C 和 CL 仍会影响对于重复项的检测). 示例:
Sort, MyVar, Random Sort, MyVar, Random Z D|
U: 移除列表中的重复项使得每个项都是唯一的. ErrorLevel 被设置为移除的项目数 (如果没有则为 0). 如果存在 C 选项, 则项目的大小写必须匹配才被看成是等同的. 如果存在 N, 那么像 2 这样的项目会被看成是 2.0 的副本. 如果存在 Pn 或 \(反斜线)的其中一个选项,则整个项目必须相同才看成是重复项,而不仅是用于排序的子字符串。如果存在 Random 或 F Function 选项, 则仅删除排序结果中彼此相邻的重复项 (说明:这句中"F Function"在原英文帮助中中间的不是空格而是斜杠,我觉得可能是错误). 例如, 对 "A|B|A" 进行随机排序, 结果中可能包含一个或两个 A.
Z: 要理解此选项, 请考虑内容为 RED`nGREEN`nBLUE`n 的变量. 如果不存在 Z, 则最后的换行符 (`n) 会被认为是最后那个项目的一部分, 因此变量中只有三个项目. 但如果指定了选项 Z,则最后的 `n(如果存在)将被认为分隔了列表最后的一个空项目,因此变量中有四个项目(最后一个是空的)。
\: 根据每个项目中最后的反斜线后面的子字符串进行排序. 如果项目中不含有反斜线, 则使用整个项目作为排序的子字符串. 此选项可用于排序单独的文件名称 (即不包含路径), 例如在下面的例子中, 排序后 AAA.txt 行在 BBB.txt 行的上面, 因为在排序中它们的目录被忽略了:
C:\BBB\AAA.txt C:\AAA\BBB.txt
注: 当反斜线选项存在时, N 和 P 选项被忽略.
备注
此命令常用于排序包含行列表的变量, 其中每行以换行符 (`n) 结尾. 获取含有行列表的变量的一种方法是使用 FileRead 装载整个文件.
如果 VarName 为 Clipboard 且剪贴板中包含文件 (例如从打开的资源管理器窗口中复制的文件), 那么这些文件将被它们文件名排序后的列表覆盖. 换句话说, 操作后剪贴板将不再包含文件本身.
仅当存在 U 选项时此命令才会改变 ErrorLevel.
可以使用 #MaxMem 增加变量所的最大内存空间.
对占用大内存的变量进行排序后当它的内容不再需要时,您可以清空它来释放占用的内存,例如 MyVar =
。
相关
FileRead, 文件读取循环, 解析循环, StringSplit, RegisterCallback(), 剪贴板, #MaxMem
示例
MyVar = 5,3,7,9,1,13,999,-4 Sort MyVar, N D, ; 数值排序, 使用逗号作为分隔符. MsgBox %MyVar% ; 结果是 -4,1,3,5,7,9,13,999 ; 下面的例子对文件的内容进行排序: FileRead, Contents, C:\Address List.txt if not ErrorLevel ; 装载成功. { Sort, Contents FileDelete, C:\Address List (alphabetical).txt FileAppend, %Contents%, C:\Address List (alphabetical).txt Contents = ; 释放内存. } ; 下面的例子设置 Win+C 热键来从打开的资源管理器窗口中 ; 复制文件, 对其中的文件名进行排序后放回剪贴板: #c:: Clipboard = ; 必须为空以检测是否有效. Send ^c ClipWait 2 if ErrorLevel return Sort Clipboard MsgBox Ready to be pasted:`n%Clipboard% return ; 下面的例子演示了通过回调函数进行自定义排序. MyVar = def`nabc`nmno`nFGH`nco-op`ncoop`ncop`ncon`n Sort, MyVar, F StringSort StringSort(a1, a2) { return a1 > a2 ? 1 : a1 < a2 ? -1 : 0 ; 基于 StringCaseSense 的设置按字母顺序进行排序. } MyVar = 5,3,7,9,1,13,999,-4 Sort, MyVar, F IntegerSort D, IntegerSort(a1, a2) { return a1 - a2 ; 按上升的数值顺序进行排序. 此方法只有在两个数字的差不会超出 64 位有符号整数的范围才有效. } MyVar = 1,2,3,4 Sort, MyVar, F ReverseDirection D, ; 反转列表, 这样它包含了 4,3,2,1 ReverseDirection(a1, a2, offset) { return offset ; 如果原始列表中 a2 在 a1 的后面则偏移是正数; 否则为负数. }