SearchCursor

描述

SearchCursor 函数用于在要素类或表上建立只读游标。SearchCursor 可用于遍历 Row 对象并提取字段值。可以使用 where 子句或字段限制搜索,并对结果排序。

讨论

旧版本:

自 ArcGIS 10.1 起,此功能已由 arcpy.da.SearchCursor 取代。为了获得更快性能,请使用 arcpy.da.SearchCursor

可用于迭代搜索游标的方式有两种:for 循环或者 while 循环(通过游标的 next 方法返回下一行)。如果要使用游标的 next 方法来检索行数为 N 的表中的所有行,则脚本必须调用 next N 次。在检索完结果集的最后一行后调用 next 将返回 None,它是一种 Python 数据类型,此处用作占位符。

通过 for 循环使用 SearchCursor

import arcpy
fc = "c:/data/base.gdb/roads"
field = "StreetName"
cursor = arcpy.SearchCursor(fc)
for row in cursor:
    print(row.getValue(field))

通过 while 循环使用 SearchCursor

import arcpy
fc = "c:/data/base.gdb/roads"
field = "StreetName"
cursor = arcpy.SearchCursor(fc) row = cursor.next() while row:
    print(row.getValue(field))    row = cursor.next()

语法

SearchCursor (dataset, {where_clause}, {spatial_reference}, {fields}, {sort_fields})
参数说明数据类型
dataset

包含要搜索行的要素类、shapefile 或表。

String
where_clause

用于限制在游标中返回的行的可选表达式。有关 where 子句和 SQL 语句的详细信息,请参阅 在查询构建器中编写查询

String
spatial_reference

指定后,要素将使用提供的 spatial_reference 进行动态投影。

SpatialReference
fields

游标中包含以分号分隔的字符串字段。默认情况下,包含所有字段。

String
sort_fields

用于在游标中对行进行排序的字段。每个字段的升序和降序排列表示为 A 形式,D 表示升序,"field1 A;field2 D" 表示降序。

String
返回值
数据类型说明
Cursor

可分发 Row 对象的 Cursor 对象。

代码示例

SearchCursor 示例

列出 Counties.shp 的字段内容。游标按州名称和人口进行排序。

import arcpy
# Open a searchcursor
#  Input: C:/Data/Counties.shp
#  Fields: NAME; STATE_NAME; POP2000
#  Sort fields: STATE_NAME A; POP2000 D
rows = arcpy.SearchCursor("c:/data/counties.shp",
                          fields="NAME; STATE_NAME; POP2000",
                          sort_fields="STATE_NAME A; POP2000 D")
# Iterate through the rows in the cursor and print out the
# state name, county and population of each.
for row in rows:
    print("State: {0}, County: {1}, Population: {2}".format(
        row.getValue("STATE_NAME"),
        row.getValue("NAME"),
        row.getValue("POP2000")))

相关主题