Loop(文件和文件夹)

获取指定的文件或文件夹,每次一个.

Loop, Files, FilePattern [, Mode]  ; v1.1.21+ (推荐)

Loop, FilePattern [, IncludeFolders?, Recurse?]

参数

Files [v1.1.21+]

单词 Files (大小写敏感). 不可为 变量 或 表达式.

FilePattern 文件模式

单个文件或文件夹的名称或者通配符模式,例如 C:\Temp\*.tmp.如果未指定绝对路径则假定 FilePattern 在 %A_WorkingDir%.

支持星号和问号作为通配符使用. 当模式出现在文件的长/普通名称或其 8.3 短名称 时出现匹配.

如果此参数为单个文件或文件夹 (即不含通配符) 且 Recurse 为 1, 同时指定的文件名出现在多个被搜索的文件夹中, 那么将找到多个匹配.

Mode 方式[v1.1.21+]

零个或多个以下字母(的组合):

D : 包含目录(文件夹).
F: 包含文件. 如果同时省略 F 和 D, 则仅包含文件而不包括目录 .
R : 递归子目录. 如果省略 R , 则不包含子目录中的文件和目录.

IncludeFolders? 包含子文件夹?

使用下列的其中一个数字, 或留空以使用默认值:
0 : (默认) 不获取文件夹 (仅文件).
1 : 获取所有匹配通配符模式的文件和文件夹.
2 : 仅获取文件夹 (不获取文件).

Recurse? 递归?

使用下列的其中一个数字, 或留空以使用默认值:
0 : (默认) 不对子文件夹进行递归.
1 : 递归子文件夹, 以便获取包含在其中的匹配 FilePattern 的文件和文件夹.将递归所有子文件夹, 而不仅是名称匹配 FilePattern 的那些.

可在文件循环中使用的特殊变量

下列变量存在于任何文件循环中.如果一个内层文件循环包含在一个外层文件循环中,那么最内层循环的文件将具有优先权:

Loop, C:\My Documents\Address List.txt
    ShortPathName = %A_LoopFileShortPath%

备注

当您想同时对文件 和/或 文件夹集合中的项逐个进行操作时, 文件循环很有用.

所有匹配的文件都被获取, 包括隐藏文件. 相比之下, 诸如 DIR 命令的 OS 特性默认忽略隐藏文件. 要避免处理隐藏, 系统 和/或 只读文件, 请在循环内部使用类似下面的方法:

if A_LoopFileAttrib contains H,R,S  ; 跳过具有 H (隐藏), R (只读) 或 S (系统) 属性的任何文件. 注意: 在 "H,R,S" 中不含空格.
    continue  ; 跳过这个文件并前进到下一个.

要在递归搜索中获取文件的相对路径而不是绝对路径,在循环之前使用 SetWorkingDir 来改变工作目录为基文件夹,且在接着的 Loop 中省略路径(例如 Loop, *.*, 0, 1).这样将使得 A_LoopFileFullPath 包含相对于基文件夹的文件路径.

如果文件循环在其范围中创建或重命名文件或文件夹, 那么会扰乱它自己. 例如, 如果它通过 FileMove 或其他方法重命名文件, 每个这样的文件可能被找到两次: 一次是作为其旧名称, 再一次则作为其新名称. 要变通解决此问题, 创建需重命名文件的列表后才重命名这些文件. 例如:

FileList =
Loop, Files, *.jpg
   FileList = %FileList%%A_LoopFileName%`n
Loop, Parse, FileList, `n
   FileMove, %A_LoopField%, renamed_%A_LoopField%

在 NTFS 文件系统中的文件可能总是按字母顺序来获取. 在其他文件系统中的文件则没有特殊的获取顺序. 要使用特殊的获取顺序, 使用 Sort 命令, 如同下文示例部分演示的那样.

文件和文件夹的完整路径和名称超过 259 个字符时, 这些文件和文件夹会被跳过, 就像它们不存在一样. 这样的文件很罕见, 因为操作系统一般不允许创建它们.

请参阅 Loop 了解关于区块,Break,Continue 和 A_Index 变量(其存在于各种类型的循环中)的相关信息.

相关

Loop, Break, Continue, 区块, SplitPath, FileSetAttrib, FileSetTime

示例

; 示例 #1:
Loop Files, %A_ProgramFiles%\*.txt, R  ; 递归子文件夹.
{
    MsgBox, 4, , Filename = %A_LoopFileFullPath%`n`nContinue?
    IfMsgBox, No
        break
}

; 示例 #2: 计算文件夹的大小, 包括其所有子文件夹中的文件:
SetBatchLines, -1  ; 让操作以最快速度进行.
FolderSizeKB = 0
FileSelectFolder, WhichFolder  ; 让用户选取文件夹.
Loop, Files, %WhichFolder%\*.*, R
    FolderSizeKB += %A_LoopFileSizeKB%
MsgBox Size of %WhichFolder% is %FolderSizeKB% KB.

; 示例 #3: 获取根据名称排序的文件名(要以日期排序请参阅后一个例子):
FileList =  ; 初始为空.
Loop, C:\*.*
    FileList = %FileList%%A_LoopFileName%`n
Sort, FileList, R  ; R 选项使得以逆序排列. 请参阅 Sort 了解其他选项.
Loop, parse, FileList, `n
{
    if A_LoopField =  ; 忽略列表末尾的空项.
        continue
    MsgBox, 4,, File number %A_Index% is %A_LoopField%.  Continue?
    IfMsgBox, No
        break
}

; 示例 #4: 获取根据修改日期排序的文件名:
FileList =
Loop, Files, %A_MyDocuments%\Photos\*.*, FD  ; 包含文件和子目录
    FileList = %FileList%%A_LoopFileTimeModified%`t%A_LoopFileName%`n
Sort, FileList  ; 根据日期排序.
Loop, Parse, FileList, `n
{
    if A_LoopField =  ; 忽略列表末尾的最后一个换行符 (空项).
        continue
    StringSplit, FileItem, A_LoopField, %A_Tab%  ; 用 tab 作为分隔符将其分为两部分.
    MsgBox, 4,, The next file (modified at %FileItem1%) is:`n%FileItem2%`n`nContinue?
    IfMsgBox, No
        break
}

; 示例 #5: 仅复制比目标位置中
; 它们的副本更新的源文件:
CopyIfNewer:
; 调用者已经为我们赋值了变量 CopySourcePattern 和 CopyDest.
Loop, Files, %CopySourcePattern%
{
    copy_it = n
    IfNotExist, %CopyDest%\%A_LoopFileName%  ; 如果目标文件还不存在, 那么总是复制.
        copy_it = y
    else
    {
        FileGetTime, time, %CopyDest%\%A_LoopFileName%
        EnvSub, time, %A_LoopFileTimeModified%, seconds  ; 从目的时间中减去源文件的时间.
        if time < 0  ; 源文件比目的文件更新.
            copy_it = y
    }
    if copy_it = y
    {
        FileCopy, %A_LoopFileFullPath%, %CopyDest%\%A_LoopFileName%, 1   ; 以覆盖形式复制
        if ErrorLevel
            MsgBox, Could not copy "%A_LoopFileFullPath%" to "%CopyDest%\%A_LoopFileName%".
    }
}
Return

; 示例 #6: 把通过命令行参数传递的文件名转换为长名称,
; 完整路径和在文件系统中存储的正确的大写/小写字符形式.
Loop %0%  ; 对于拖放到脚本上 (或作为参数传递) 的每个文件.
{
    GivenPath := %A_Index%  ; 获取下一个命令行参数.
    Loop %GivenPath%, 1
        LongPath = %A_LoopFileLongPath%
    MsgBox The case-corrected long path name of file`n%GivenPath%`nis:`n%LongPath%
}