描述
迭代文件夹中的文件。
使用
此工具专用于模型构建器,而并不在编写 Python 脚本时使用。
文件扩展名选项可用于迭代具有特定扩展名的文件。例如,如果只想迭代扩展名为 .log 的文件,则将文件扩展名参数设置为 log。
如果该文件在目录 窗口中显示为数据集,则迭代文件将跳过该文件。最常见的示例是 shape 文件、.dbf 文件、栅格文件(.jpg、.tif、.img、.png 和 .bmp)、CAD 文件(.dxf 和 .dwg)、地图文件 (.mxd) 和个人地理数据库 (.mdb)。
此工具有两个输出:输出文件和名称,可在其他工具中用作行内变量(例如 %Name%)。
在可选扩展名参数中指定文件扩展名,例如 .txt、.pdf、.zip 等。例如,如果工具对文本文件进行迭代并将输出用于 ASCII 转栅格等工具中,则请在可选文件扩展名参数中指定扩展名 .txt。
大部分工具都支持来自迭代文件工具的输出文件格式,但复制等工具除外,该工具要求定义输出名称中的文件扩展名。例如,如果要使用迭代文件工具迭代用作复制工具的输入的 .zip 文件,输出名称必须包含扩展名 Name.zip 或 %Name%.zip。
如果模型中已添加一个迭代器,模型中的所有工具都会对此迭代器中的每个值进行迭代。如果您不想对每个被迭代的值运行模型中的每个工具,请创建一个只包含迭代器的子模型/嵌套模型内的子模型/镶嵌模型,并将其作为模型工具添加到主模型中。
语法
IterateFiles(in_folder, {wildcard}, {extension}, {recursive})
参数 | 说明 | 数据类型 |
in_folder | 输入文件所在文件夹。 | Folder |
wildcard (可选) | * 与有助于限制结果的字符的组合。星号表示允许使用任意字符。如果未指定通配符,则将返回所有输入。例如,可使用通配符来限制对以某个字符或词语(即,A*、Ari* 或 Land* 等)开头的输入名称进行迭代。 | String |
extension (可选) | 文件扩展名,例如 TXT、ZIP 等。只迭代具有扩展名的文件。不要在文件扩展名前使用句点。 | String |
recursive (可选) | 确定是否递归迭代主文件夹的所有子文件夹。
| Boolean |
环境
此工具不使用任何地理处理环境。
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是