功能说明

以下是 arcpy.da.SearchCursor、arcpy.da.InsertCursor、arcpy.da.UpdateCursor

====<<<< Description >>>>====

SearchCursor 用于建立从要素类或表中返回的记录的只读访问权限。
返回一组迭代的元组。元组中值的顺序与 field_names 参数指定的字段顺序相符。使用 For 循环可迭代搜索游标。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

da.SearchCursor (in_table, field_names, {where_clause}, {spatial_reference}, {explode_to_points}, {sql_clause})
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈  in_table：要素类、图层、表或表视图。
◈  field_names、[field_names,...]：字段名称列表（或组）。对于单个字段，可以使用一个字符串，而不使用字符串列表。如果要访问输入表中的所有字段（栅格和 BLOB 字段除外），可以使用星号 (*) 代替字段列表。以令牌（如 OID@）取代字段名称可访问更多的信息：
    SHAPE@XY —一组要素的质心 x,y 坐标。
    SHAPE@TRUECENTROID —一组要素的真正质心 x，y 坐标。
    SHAPE@X —要素的双精度 x 坐标。
    SHAPE@Y —要素的双精度 y 坐标。
    SHAPE@Z —要素的双精度 z 坐标。
    SHAPE@M —要素的双精度 m 值。
    SHAPE@JSON — 表示几何的 esri JSON 字符串。
    SHAPE@WKB —OGC 几何的熟知二进制 (WKB) 制图表达。该存储类型将几何值表示为不间断的字节流形式。
    SHAPE@WKT —OGC 几何的熟知文本 (WKT) 制图表达。其将几何值表示为文本字符串。
    SHAPE@ —要素的几何对象。（Point、Polyline、Polygon）
    SHAPE@AREA —要素的双精度面积。
    SHAPE@LENGTH —要素的双精度长度。
    OID@ —ObjectID 字段的值。
◈  where_clause：用于限制所返回的记录的可选表达式。有关 WHERE 子句和 SQL 语句的详细信息，请参阅构建查询表达式。
(默认值为 None)
----------------------------------------------------------------------------------

====<<<< Properties >>>>====

◈  fields：返回一个使用这个游标的字段名称的元组，与上面的参数对应。
----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈   next ()：将下一行作为元组返回。字段将按照创建光标时所指定的顺序返回。
◈   reset ()：将光标重置回第一行。

# 用来查询 "Fre = 0" 的全部记录（遇到字符串使用单引号，"Name = 'alex'"）

cursor = arcpy.da.SearchCursor("union", "Fre", "Fre = 0")

# 获取查询列的所有值，并赋值为列表（values）

>>> cursor = arcpy.da.SearchCursor("CNTRY92", "NAME")

>>> values = [row[0] for row in cursor]

# 获取经纬度坐标

>>> cursor = arcpy.da.SearchCursor("CNTRY92", "SHAPE@XY")

>>> xy = [row[0] for row in cursor]

>>> xy[0]

(6.299706626866719, 49.77865316900599)

# 获取 polygon 面积

>>> cursor = arcpy.da.SearchCursor("CNTRY92", "SHAPE@AREA")

>>> area = [row[0] for row in cursor]

>>> area[0]

0.33773702035614406

# 获取 polygon 周长

>>> cursor = arcpy.da.SearchCursor("CNTRY92", "SHAPE@LENGTH")

>>> length = [row[0] for row in cursor]

>>> length[0]

2.58749040209765

# 获取 polygon 并输出

>>> cursor = arcpy.da.SearchCursor("CNTRY92", "SHAPE@")

>>> shape = [row[0] for row in cursor]

>>> shape[0]

<Polygon object at 0x2acfa110[0x2acf8b40]>

>>> arcpy.CopyFeatures_management(shape[0], "shape_00.shp")

<Result 'D:\\McDelfino\\Documents\\ArcGIS\\shape_00.shp'>

在 Python 中，构建由三重引号括起的表达式

cursor = arcpy.da.SearchCursor(fc, ["roadclass", "name"],

""""roadclass" = 2""")

for row in cursor:

    print(row[1])

1. 注意操作的时候不要选择数据，否则只会查询选择范围内的信息；

2. 如果想要选择全部 table 内容，则不需要添加 SQL 语句；

3. 注意 SQL 语法等。

====<<<< Description >>>>====

InsertCursor 可在要素类或表上建立写入游标。可以使用 InsertCursor 来添加新行。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

da.InsertCursor (in_table, field_names)
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈  in_table：要素类、图层、表或表视图。
◈  field_names、[field_names,...]：字段名称列表（或组）。对于单个字段，可以使用一个字符串，而不使用字符串列表。如果要访问输入表中的所有字段（栅格和 BLOB 字段除外），可以使用星号 (*) 代替字段列表。
----------------------------------------------------------------------------------
====<<<< Properties >>>>====

◈  fields：返回一个使用这个游标的字段名称的元组，与上面的参数对应。
----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈   insertRow (row)：向表中插入一行。

da.UpdateCursor

====<<<< Description >>>>====

UpdateCursor 用于建立对从要素类或表返回的记录的读写访问权限。
返回一组迭代列表。列表中值的顺序与 field_names 参数指定的字段顺序相符。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

da.UpdateCursor (in_table, field_names, {where_clause}, {spatial_reference}, {explode_to_points}, {sql_clause})
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈  in_table：要素类、图层、表或表视图。
◈  field_names、[field_names,...]：字段名称列表（或组）。对于单个字段，可以使用一个字符串，而不使用字符串列表。如果要访问输入表中的所有字段（栅格和 BLOB 字段除外），可以使用星号 (*) 代替字段列表。
----------------------------------------------------------------------------------
====<<<< Properties >>>>====

◈  fields：返回一个使用这个游标的字段名称的元组，与上面的参数对应。
----------------------------------------------------------------------------------

====<<<< Methods >>>>====

◈  deleteRow ()：删除当前行。
◈  next ()：将下一行作为元组返回。字段将按照创建光标时所指定的顺序返回。
◈  reset ()：将光标重置回第一行。
◈  updateRow (row)：更新表中的当前行。

以下是 arcpy.SearchCursor、arcpy.InsertCursor、arcpy.UpdateCursor

SearchCursor

====<<<< Description >>>>====

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

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

返回值为 Cursor 类，具体属性与方法参见 Cursor 类。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

SearchCursor (dataset, {where_clause}, {spatial_reference}, {fields}, {sort_fields})
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈  dataset：The feature class, shapefile, or table containing the rows to be searched.
◈  where_clause：SQL 语句，用来限定查询注意内容用单引号。

InsertCursor

====<<<< Description >>>>====

向要素类、shapefile 或表中插入行。InsertCursor 返回一个分发行对象的枚举对象。

可使用 newRow 方法从插入行的枚举对象获取新的行对象。每次调用光标上 insertRow 都会在表中创建新行，该行的初始值设置为输入行中的值。

返回值为 Cursor 类，具体属性与方法参见 Cursor 类。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

InsertCursor (dataset, {spatial_reference})
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈  dataset：The feature class, shapefile, or table containing the rows to be searched.

UpdateCursor

====<<<< Description >>>>====

UpdateCursor 函数创建一个用于更新或删除指定要素类、shapefile 和表中的行的游标。该游标将数据锁定保留至脚本完成或更新游标对象被删除时。

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

返回值为 Cursor 类，具体属性与方法参见 Cursor 类。
----------------------------------------------------------------------------------

====<<<< Syntax >>>>====

UpdateCursor (dataset, {where_clause}, {spatial_reference}, {fields}, {sort_fields})
----------------------------------------------------------------------------------

====<<<< Parameters >>>>====

◈  dataset：The feature class, shapefile, or table containing the rows to be searched.
◈  where_clause：SQL 语句，用来限定查询注意内容用单引号。