SearchCursor

Сводка

Функция 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})

Parameter	Объяснение	Тип данных
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.

Пример кода

SearchCursor, пример

Получение списка содержания полей 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")))