批处理之家 - Powered by Discuz! Board

hash version 3.1.6  批量获取文件的 HASH 信息  by CrLf [bbs.bathome.net]

hash.exe [drive:][path][filename][/Pattern/[Options],...]
      [/D:[Path]] [/S[:Range]] [/G]

      [/STRING [String[/Pattern[Options]]]
      [/#] [/SHIFT] [/RE]]

      [/N[:Range]] [/CRC32[:String]] [/MD5[:String]] [/SHA1[:String]]
      [/A[:Att]] [/Z[:Range]]]

      [/PRINTF|/DO|DOUNTIL:Format[,Key,...]] [/CSV] [/NH]
      [/DO:Format[,Key,...]] [/DOUNTIL:Format[,Key,...]]
      [/UCASE] [/HIDE] [/RELATIVE] [/X]

      [/SAMPLE:[:Step | -MaxCycle]] [/RETURN] [/HELP] [/ALIAS]
      [/VERSION[:Version]] [/DEBUG[:Name|:=Value]] [//]

  [drive:][path][filename]
            指定要列出的驱动器、目录和文件名

            X:\path\filename[/Pattern/[Options]]

            通用的 Options 如下（PCRE 原生支持）:
            i 忽略大小写       x 忽略空格与以#开头的注释
            u 非贪婪模式       8 UTF-8 模式
            m 多行替换          s . 可以匹配换行符
            f 匹配首行

            以下三种 Options 仅在 /STRING 的扩展选项中生效：
            ~ 去除前后空格    + 跳过全空行
            g 允许多次匹配

            以下三种 Options 仅能用于 filename 或 string 的正则：
            . 匹配时含后缀名 : 匹配路径（默认只匹配文件名）
            ! 条件取反

            例1，匹配文件名含 A 的 exe 文件：

            hash *.exe/A/i

            例2，匹配后缀名不为 exe 的文件：
            hash */\.exe$/.!

            例3，匹配后缀名为 exe 或 txt 的文件：
            hash */\.exe$^|\.txt/.!
            rem 代码中的 ^ 用于在批处理中将 | 转义

            程序结束时，如果始终没有匹配项，退出码置为 -1

  /D[ath] 在输出的结果中包含文件夹，扩展参数可以切换工作路径到 Path
            若将 : 写成 ::，/D 将不影响输出，但 Path 设置仍生效

  /S[:Min~Max]
            显示指定目录和所有子目录中的文件
            Min~Max 能筛选出 Min < 递归深度 < Max 的文件
            可以用 /S:Min 或 /S:~Max 单独设置上限或下限

  /G[:Charset]
            将参数理解为文件列表或字符串列表，逐行读取
            列表中指向的文件无法使用正则筛选和遍历子目录，但仍可以使用通配符
            根据文件头自动判断编码格式，扩展参数可以设置无 BOM 的文件的默认编码

            支持的 Charset 和记事本一致，支持以下四种选项：
            ANSI UNICODE UNICODE-BE UTF-8

* /STRING[:/Pattenr/[Options],... |:s/Pattenr/String2/[Options],...]
            参数视为字符串，扩展选项为一条或多条正则，用于捕获或替换：
            /String:/Pattern/[Options] 捕获每个字符串中首个匹配的内容，如：

            hash /string:/(?^<=\.)\w+/i "bbs.bathome.net"
            rem 此处的 ^ 仅用于在批处理中将 < 转义
            rem 以 /(?<=\.)\w+/ 为条件对 bbs.bathome.net 进行匹配
            rem 将捕获到 "bathome"

            /STRING:s/Pattern/String2/[Options] 将对匹配的结果进行替换，如：

            hash /string:s/.*\.(.+)\..*/\1/i "bbs.bathome.net"
            rem 会把捕获的部分替换成第一个括号中引用的内容

            使用大写的 S 标记将会反复替换直到结果不再变化：

            hash /string:S/\wb/b/i "bbsbathome"
            rem 可以实现对匹配过的内容再次匹配，直到找不到匹配内容
            rem 使用 S 模式可能会因为替换结果仍符合匹配条件而产生死循环

            可以多次替换或捕获，只要将正则表达式用 ; 号分隔：

            hash /string:s/.*?\.//;s/\..*?$/ "bbs.bathome.com"
            rem 先执行 s/.*?\.// 再执行 s/\..*?$/，然后输出结果
            rem replace 可以和 match 正则联用

            正则基于 PCRE 库，Options 说明见前文，String2 中可用 \s 表示空格
            \0 表示 Pattern 匹配的全部内容，\1~\9 表示 () 引用的内容
            若将 : 写成 ::，/STRING 将作用于文件名，而不将参数理解为字符串
            此时正则只针对输出结果中的文件名或路径

  String    启用 /STRING 后，非开关的参数都视为字符串
            同样支持用如下格式的正则表达式对字符串进行筛选，
            String[/Pattern/[Options]]  （Options 说明见前文）

  /#       /STRING 模式中可设置 # 为注释符，启用后将忽略空格与以#开头的注释
            还可用以下开关启用其他注释符（仅一个生效）: /` /' /; /: /:: ///
            /# 优先级高于 /SHIFT 和 /RE，因此仅字符串中原有的注释符有效

  /RE       解释参数中的正则元字符，启用后将参数中的对部分元字符转义:

            \\=\ \a={响铃符}  \b={退格符} \f={换页符} \n={换行符}
            \r={回车符} \t={水平制表符} \v={垂直制表符} \s={空格} \0={NULL}
            \xNN={2位十六进制所代表的任意字符，如 \x41=A}
            \cX={c@ ~ c_ 对应 0x0 ~ 0x1F 任意控制字符}

  /SHIFT    映射参数中的字符，把参数中 $ 之后的第一个字符映射为同键字符
            启用后，$ 的作用类似于 SHIFT 键，如 $a=A $'=" $1=!
            /SHIFT 与 /RE 开关对以下内容起作用：
            FileName  String  各开关扩展参数  正则Pattern  正则Replacement

* /N[:SCOPE | :Min~Max[=Scope]]
            显示行号
            Scope 指定计数周期，有如下可选项（可简写为首字母）：

            Bin 二进制周期  Oct 八进制周期  Dec 十进制周期  Hex 十六进制周期
            Global 全局    Arg 命令行参数  List 文件列表 Folder 每个文件夹

            Min~Max 能筛选出 Min < 行号 < Max 的字符串或文件，
            可以用 /N:Min 或 /N:~Max 单独设置上限或下限
            若将 : 写成 ::，Size 将不被显示，但筛选条件仍生效

* /CRC32[:String]
            计算 CRC32 值，可用扩展参数指定只显示 CRC32 值为指定值的项
            若将 : 写成 ::，CRC32 值将不被显示，但筛选条件仍生效

* /MD5[:String]
            计算 MD5 值，可用扩展参数指定只显示 MD5 值为指定值的项
            若将 : 写成 ::，MD5 值将不被显示，但筛选条件仍生效

* /SHA1[:String]
            计算 SHA1 值，可用扩展参数指定只显示 SHA1 值为指定值的项
            若将 : 写成 ::，SHA1 值将不被显示，但筛选条件仍生效

* /A[:Att[Att]...]
            显示文件/文件夹的属性，对字符串无效。缩写字母的含义如下:

            d 目录 r 只读 a 存档 h 隐藏 s 系统
            c 压缩 o 脱机 i 无索引 l 链接 e 加密

            可以用扩展选项筛选文件属性，- 号表示排除此类型
            如未使用 /A 开关及其扩展参数，则默认为 /A::-d-h-s
            同时启用 /F /STRING 与 /A 开关时，此值为文件的名称或路径
            若将 : 写成 ::，属性将不被显示，但筛选条件仍生效

* /Tx[:FORMAT | :Min~Max[=Format]]
            Tx 代表显示文件的时间属性（仅能指定一种）:
            /TC 创建时间 /TA 上次访问时间 /TW 上次写入时间

            扩展参数可指定范围，Min~Max 能筛选出 Min < 文件日期 < Max 的文件
            可以用 /Tx:Min 或 /Tx:~Max 单独设置上限或下限
            支持常见日期格式，并能进行增减计算，格式为：
            DateTime[[ + | - ]Number[Type]]

            + 为增加，- 为减少，Number 为数量，Type 为单位
            可选的 Type 有：w(周) d(日[默认]) h(时) m(分) s(秒)

            hash *.txt /tw:12:00-5
            rem 列举所有 5天前的12:00 之后修改的 txt 文件
            hash /tc:9:00-10d+12h
            rem 列举所有 10天前的9:00再加12个小时之后创建的文件

            如果同时明确指定了 Min 与 Max，则会用当前时间自动补充未指定的部分
            将日期补全之后，才会进行日期增减计算
            若日期前缀 * 符号，则会优先用另一半补充未指定的部分如：

            hash /tw:"7/29 0:0"~*8:00
            rem 列举从今年 07/29 00:00 到同一天的08:00 之间修改的文件

            若参数中含有 % 号，将理解为设置日期显示格式
            日期格式语法参考 strftime 函数，如：

            hash /tw:%Y年%m月%d日
            hash /printf:"%s修改于%s\n",file,tw:"%H时%M分%S秒"

            如果要用一个 /tx 同时指定日期范围与显示格式
            可以用 = 符号表示其后内容为日期格式：

            hash /tc:"00:00+12h"="%y年第%W周"

* /Z[:Unit | :Min~Max[=Unit]]
            显示文件的长度或文件夹中的成员数量
            Unit 指定长度单位，有如下可选项：

            bit Byte KB MB GB TB PB Chars

            Chars 用于计算字符串中的字符数而非字节数
            可使用首字母简写，但简写时 b 与 B 区分大小写

            Min~Max 能筛选出 Min < 长度 < Max 的字符串或文件，
            可以用 /Z:Min 或 /Z:~Max 单独设置上限或下限
            若将 : 写成 ::，Size 将不被显示，但筛选条件仍生效

  /PRINTF:Format[,Key[,..]]
            用 PRINTF 支持的格式输出各项，可用的 Key 有（支持别名）：

            number  crc32  md5  sha1  attrib  time  size  file|string

            最多能指定 20 个 Key 来指示各项信息出现的顺序，Key 与同名开关等价
            名字相同的 Key 共用扩展参数，新的扩展参数会替代原有设置
            若指定了 Key，则使用 Key 的顺序，帮助中前缀 * 的开关都将失效
            未指定 Key 将使用上表顺序，而与开关出现的顺序无关
            所以下面三条命令是等价的：

            hash /printf:"%03d %s %10d %s\n" /size /num /attrib
            hash /printf:"%03d %s %10d %s\n" /size /attrib /num
            hash /printf:"%03d %s %10d %s\n",num,attrib,size,file

            可以用类似的方法模拟 LIST 格式输出：

            hash /printf:"NAME=%s\nSIZE=%d\nMD5=%s\n\n",file,size,md5 *

            对 size 和 number 可选 %d %x %o %u 类型，余项只能使用 %s 类型
            file 表示文件，与 string 互斥，但共用 /STRING 的扩展参数
            另有四个内置参数 @name @path @is @when，并各自带扩展参数

            @name 表示参数为文件名
            支持以下扩展参数(其中 base 与 ext 也可用于字符串)

            short 短名    long  长名    full  全名    parent 父目录名
            base  基本名 ext 扩展名

            @path 表示参数为路径，支持以下扩展参数：

            short 短路径 long  长路径 full  全路径 parent 父目录路径
            root  根路径

            @is 表示判断属性
            必须指定以下扩展参数之一，其中 empty 也可用于字符串：

            folder 文件夹             file 文件
            readonly 只读                hidden 隐藏
            empty 为空

            @when 表示获取相应修改时间
            支持以下扩展参数：(用于字符串时为当前时间)：

            create 创建    access 访问  write 写入

            带 @ 的开关仅用于 format，且独立于其他开关，例如：

            hash /printf:"创建于%s，扩展名%s\n",@when:create,@name:ext"
            rem 显示文件的修改时间和后缀名
            rem 使用 @when 时日期格式固定，但有更好的兼容性

  /DO:Format[,Key,...]
  /DOUNTIL:Format[,Key,...]
            语法和 /PRINTF 一致，但效果是执行根据 Format 生成的命令行

            /DO    无论执行结果如何，都将依次执行
            /DOUNTIL 将中止于退出码不为 0 的命令

            效果类似于 forfiles，但使用起来更灵活，如：

            hash /do:"ren ""%s"" ""[%d]%s""",file,n,file
            echo 当前目录下有 %errorlevel% 个 txt 文件
            rem 启用 /return 开关将返回匹配的具体数量

            /PRINTF /DO /DOUNTIL 开关互斥，只能有一个生效
            启用 /RETURN 开关后，将返回最后一条命令的退出码

* /CSV       以逗号为分隔符输出结果
* /NH       指定列标题不在输出中显示
  /UCASE    用大写字母输出 HASH
* /HIDE    隐藏文件名或字符串
* /RELATIVE 输出为相对路径
  /X       使用文件短名
  /SAMPLE[:Step | -MaxCycle]
            开启后，只对文本的一部分内容采样计算 hash，可节省时间
            参数为正数时，每隔 Step 个周期计算 hash
            参数为负数时，只计算到 MaxCycle 个周期为止
            指定的数字越大，采样的内容越少、速度越快
            如未指定扩展参数，视同 /SAMPLE:16
            每个周期可处理 64*1024 Byte，和字符串的长度上限相同

  /RETURN    若未开启此开关，有匹配项时退出码为 0，无匹配项返回 1
            启用此开关后，在退出码中返回被处理的数量，如：

            hash *.txt /return
            echo 当前目录下有 %errorlevel% 个 txt 文件
            rem 启用 /return 开关将返回匹配的具体数量

            hash *.txt && echo 当前目录下存在 txt 文件
            rem 否则只返回成功与否

            无论是否开启此开关，参数错误将返回小于 0 的值，如：

            hash /Undifend *.txt
            if not errorlevel 0 echo /Undifend 是个无效的开关
            rem 语法错误返回小于 0 的值

  /HELP    获取帮助信息
  /ALIAS    列举各个参数别名
  /VERSION[:Number1[.Number2[.Number]]]
            显示当前版本信息，扩展选项可用于判断当前版本号是否高于指定版本号
            版本号分为三个部分，未指定的部分视为 0，如 2.1 等同于 2.1.0
            如高于给定版本号，返回值为 1，若低于则为 -1，若相等则为 0
            若将 : 写成 ::，/VERSION 将只在低于指定版本号时退出

  /DEBUG[:Name|:=Value]
            显示参数解析结果，可用扩展参数筛选输出内容
            /DEBUG:flag 将筛选名称以 flag 开头的项
            /DEBUG:=true 将筛选值为 true 的项

  //       终止参数解析，其后内容将理解为注释