Краткая информация
Функция SearchCursor устанавливает курсор "только для чтения" на класс объектов или таблицу. SearchCursor можно использовать для циклической обработки Row объектов и извлечения значений полей. Поиск можно ограничить условием where или полем и, дополнительно, отсортировать.
Обсуждение
Прежние версии:
Эта функция была заменена на arcpy.da.SearchCursor в ArcGIS 10.1. Для более быстрой работы, используйте arcpy.da.SearchCursor.
Курсоры поиска могут работать циклически с помощью цикла for или while, с использованием метода курсора next для перехода к следующей строке. При использовании метода next для курсора с целью выбора всех строк таблицы с количеством строк n, скрипт должен выполнить количество вызовов n к методу next. Вызов next после последней строки в полученном наборе результатов возвращает None, являющийся типом данных Python, который действует здесь в качестве местозаполнителя.
Использование 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 | Класс пространственных объектов, шейп-файл или таблица со строками для поиска. | String |
where_clause | Дополнительное выражение, ограничивающее строки, возвращаемые в курсоре. Для получения более подробной информации об SQL выражениях запроса where см. Написание запроса в конструкторе запросов. | String |
spatial_reference | Если задано, объекты будет проецироваться «на лету» с использованием предоставляемой spatial_reference. | SpatialReference |
fields | Строка полей, разделенных точкой с запятой, которые будут включены в курсор. По умолчанию включаются все поля. | String |
sort_fields | Поля, используемые для сортировки строк в курсоре. Порядок по возрастанию и убыванию для каждого поля обозначается буквами A и D, соответственно, в виде "field1 A;field2 D". | String |
Тип данных | Описание |
Cursor | Объект Cursor, который может обрабатывать объекты Row. |
Пример кода
Получение списка содержания полей Counties.shp. Курсор отсортирован по State Name и Population.
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")))