Iterate Files (ModelBuilder)

Summary

Iterates over files in a folder.

Learn how Iterate Files works in ModelBuilder

Usage

  • This tool is intended for use in ModelBuilder, not in Python scripting.

  • The File Extension option allows you to iterate over files with a particular extension. For example, if you only want files with the extension of .log to be iterated, set the File Extension parameter to log.

  • If the file appears as a dataset in the Catalog pane, then Iterate Files will skip the file. The most common examples are shape files, .dbf files, raster files (.jpg, .tif, .img, .png, and .bmp), CAD files (.dxf and .dwg) and map files (.mxd, .aprx).

  • The tool has two outputs: Output File and Name which could be used as an inline variable (for example, %Name%) in other tools.

  • Specify the file extension in the optional parameter for extensions, such as txt, pdf, zip, and so on. For example, if the tool iterates over text files and the output is used in tools, such as ASCII To Raster tool, specify the extension txt in the optional file extension parameter.

  • Most tools honor the output file format from the Iterate Files tool except tools such as Copy, which requires you to define the file extension in the output name. For example, If you are using the Iterate Files tool to iterate zip files for use as input to the Copy tool, the output name must contain the extension Name.zip or %Name%.zip.

Syntax

arcpy.mb.IterateFiles(in_folder, {wildcard}, {extension}, {recursive})
ParameterExplanationData Type
in_folder

Folder in which the input files are located.

Folder
wildcard
(Optional)

A combination of * and characters that help to limit the results. The asterisk is the same as saying ALL. If no wildcard is specified, all inputs will be returned. For example, it can be used to restrict Iteration over input names starting with a certain character or word (for example, A* or Ari* or Land* and so on).

String
extension
(Optional)

The file extension, such as TXT, ZIP, and so on. Only files with the extension will be iterated. Do not use a period before the file extension.

String
recursive
(Optional)

Determines if all subfolders of the main folder will be recursively iterated through.

  • Checked—Will iterate through all subfolders.
  • Unchecked—Will not iterate through all subfolders.
Boolean

Derived Output

NameExplanationData Type
file

The full path to the file.

File
name

The name of the dataset.

String

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes