开源文件批量改名

功能说明:该程序是基于易语言（E Language）开发的一套高效文件批量处理工具模块，核心功能集中在对指定目录下的文件进行批量自动化管理。通过分析代码结构中的公开子程序（`.子程序 开头`），可以看出该程序主要设计用于解决用户在大量文件整理过程中遇到的繁琐手动操作问题，具体功能总结如下：

1. **核心功能概览**

   程序提供了两个主要的公开接口子程序，分别对应两种常见的文件操作需求：

   - `.子程序 文件批改名`：用于对文件夹内的文件按照特定规则进行批量重命名。

   - `.子程序 文件批量改后缀`：用于批量修改文件的扩展名（例如将所有.txt 改为.bak，或删除后缀等）。

2. **详细功能特性**

   - **智能批量重命名**：

     在 `文件批改名` 子程序中，用户可以灵活配置多个参数：

     - **文件类型筛选**：支持指定特定的文件扩展名（如 exe、txt），留空则默认为所有类型（*）。

     - **命名规则定制**：支持设置“文件名前缀”和“文件名后缀”，允许在新文件名前后添加固定字符。

     - **序号生成器**：支持自动添加序号，可自定义“序号起始值”和“序号位数”（默认 4 位，不足补零），并支持“增序”或“降序”排列逻辑。

     - **结果反馈**：执行完毕后会在调试输出区显示处理的文件总数及失败的数量，便于用户监控操作进度。

   - **批量修改后缀**：

     在 `文件批量改后缀` 子程序中，功能相对专注：

     - 允许用户指定新的后缀名称。

     - 程序内部会自动处理原始后缀的去除与新后缀的拼接逻辑。

     - 同样具备对特殊符号（如输入的后缀带点号）的清洗功能，确保后缀格式正确。

   - **安全备份机制**：

     程序中定义了全局程序集变量 `是否备份文件`。在执行任何可能导致文件覆盖的操作前（即判断新文件名是否与现有文件冲突时），若该变量为真且目标位置已存在同名文件，系统会先将现有的目标文件重命名为 `.bak` 后缀进行备份，然后再写入新文件。这一设计有效防止了因批量操作导致的原始数据意外丢失。

   - **错误处理与统计**：

     无论是改名还是改后缀，程序都通过指针传参的方式引入了 `失败数量` 变量。当底层的 `文件更名` 操作返回假（表示失败）时，程序会自动累加失败计数，保证了程序的健壮性，不会因为单个文件失败而中断整个流程。

3. **技术架构与实现原理**

   - **回调机制**：程序采用了高级的文件遍历模式。`FindFile` 子程序负责核心的文件搜索逻辑，它接受一个“子程序指针”作为参数。这意味着当找到文件时，它会动态调用传入的处理函数（如 `批量改名` 或 `批量改后缀`）。这种设计实现了“遍历逻辑”与“业务逻辑”的分离，使得代码更加模块化，易于维护。

   - **内存与指针操作**：在处理序号和计数器时，代码使用了 `.取变量数据地址`、`.写到内存` 等命令配合指针操作。这是因为子程序作为回调传递时，需要共享状态（如当前的序号值、失败的计数），通过指针读写内存是实现跨子程序共享变量的高效方式。

   - **字符串处理**：广泛使用易语言的文本处理函数，如 `.取标准整数文本`（格式化数字）、`.取文件后缀 `、`.倒找文本`、`.取文本左边` 等，来精确构建新的文件名。

4. **使用场景与注意事项**

   - **启动与测试**：在 `.子程序 _启动子程序` 中，预设了两行被注释的代码示例，分别演示了如何调用改名和改后缀功能。在实际发布为软件运行时，可能需要解除注释或将其封装为图形界面按钮事件；作为库模块使用时，用户只需引用该程序集并调用公开子程序即可。

   - **路径依赖**：目前硬编码了在测试环境下的路径（如 C:\Users\CISA-DEV\Desktop\），实际使用时需根据传入的参数动态适应，代码逻辑本身支持任意路径输入。

   - **潜在风险**：虽然具备备份功能，但批量操作仍存在风险。建议在使用前确认 `是否备份文件` 的状态，并在非关键数据目录下先行测试。此外，代码片段末尾 `FindFile` 的定义虽不完整，但从调用方式看，它是整个功能的基石，确保了能递归或深度扫描文件夹。

综上所述，这是一个功能完备、注重数据安全且具有良好扩展性的易语言文件处理组件，非常适合系统集成或个人自动化脚本中使用，能够显著提升文件管理的效率。

======程序集1

           |  |

           |  |------ _启动子程序

           |  |

           |  |------ 文件批改名

           |  |

           |  |------ 文件批量改后缀

           |  |

           |  |------ 批量改名

           |  |

           |  |------ 批量改后缀

           |  |

           |  |------ FindFile

           |  |

           |  |------ 取标准整数文本

           |  |

           |  |------ 取文件后缀