Краткая информация
Возвращает строки значений атрибутов из класса объектов или таблицы.
Функция SearchCursor итерирует объекты Row и извлекает значения поля.
Прежние версии:
Эта функция была заменена на arcpy.da.SearchCursor в ArcGIS 10.1 и остается для использования только в устаревших скриптах. Для обеспечения улучшенной производительности и функциональности, а также поддержки новых типов полей и токенов, воспользуйтесь arcpy.da.SearchCursor.
Обсуждение
Курсоры поиска могут работать циклически с помощью цикла for или while, с использованием метода курсора next для перехода к следующей строке. При использовании на курсоре метода next, чтобы найти все строки в таблице, содержащей n строк, скрипт должен вызвать next N-ное количество раз. Вызов next после последней строки в полученном наборе результатов возвращает None, выступающий в качестве заполнителя.
Итерируйте строки, возвращаемые функцией SearchCursor в цикле for.
import arcpy
fc = "c:/data/base.gdb/roads"
field = "StreetName"
cursor = arcpy.SearchCursor(fc)
for row in cursor:
print(row.getValue(field))
Итерируйте строки, возвращаемые функцией SearchCursor в цикле while.
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 | The feature class or table containing the rows to be searched. | String |
where_clause | An expression that limits the rows returned in the cursor. For more information about where clauses and SQL statements, see Introduction to query expressions. | String |
spatial_reference | Coordinates are returned in the spatial reference provided. | SpatialReference |
fields | A semicolon-delimited string of fields to be included in the cursor. By default, all fields are included. | String |
sort_fields | The fields to sort the rows in the cursor. Ascending and descending order for each field is denoted by A for ascending and D for descending, using the form "field1 A;field2 D". | String |
Тип данных | Описание |
Cursor | Объект Cursor, возвращающий объекты Row. |
Пример кода
Список содержания полей для класса объектов. Курсор отсортирован по имени штата и численности населения.
import arcpy
# Create a search cursor for a feature class
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")))