描述
迭代字段中的所有值。
使用
此工具专用于模型构建器,而并不在编写 Python 脚本时使用。
此工具的输出是名为 Value 的变量,且包含字段值。此变量可用在行内变量替换 (%Value%) 中。
数据类型参数可指定输出变量的数据类型。默认数据类型为字符串,但根据输出将在模型中的使用方式,可指定不同的数据类型。例如,如果字段包含要素类的路径,则可将数据类型设置为“要素类”,并将输出变量用作接受要素类的工具的输入。
如果模型中已添加一个迭代器,模型中的所有工具都会对此迭代器中的每个值进行迭代。如果您不想对每个被迭代的值运行模型中的每个工具,请创建一个只包含迭代器的子模型/嵌套模型内的子模型/镶嵌模型,并将其作为模型工具添加到主模型中。
语法
IterateFieldValues(in_table, field, {data_type}, {unique_values}, {skip_nulls}, {null_value})
参数 | 说明 | 数据类型 |
in_table | 要被迭代的输入表。 | Table View |
field | 要进行迭代的输入字段。 | Field |
data_type (可选) | 输出值的数据类型。默认数据类型为字符串,但根据输出将在模型中的使用方式,可指定不同的数据类型。例如,如果字段包含要素类的路径,则可将数据类型设置为要素类,并将输出变量用作接受要素类的工具的输入。 | String |
unique_values (可选) | 确定迭代值是否基于唯一值。
| Boolean |
skip_nulls (可选) | 确定是否会跳过字段中的空值。
| Boolean |
null_value (可选) | 指定要跳过的空值,例如 -9999、Null 和 -1。对于字符串,默认值为 "";对于数字,默认值为“0”。 | String |
环境
此工具不使用任何地理处理环境。
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是