Skip to main content

Array

Résumé

The Array object can contain points and arrays and is used to construct geometry objects.

Syntaxe

Array({items})

Nom Explication Type de données

items

(Facultatif)

Items can include a Point object, another Array object, or any iterable object that returns Point objects.

Object

Propriétés

Nom Explication Type de données

count

(Lecture seule)

The element count of the array.

Integer

Méthodes

add(value)

Adds a Point or Array object to the end of the array.

Nom Explication Type de données

value

Either a Point or Array object can be appended to the array.

Object

append(value)

Appends an object to the array in the last position.

Nom Explication Type de données

value

Either a Point or Array object can be appended to the array.

Object

clone(point_object)

Clone the Point object.

Nom Explication Type de données

point_object

A Point object.

Point

extend(items)

Extend the array by appending elements.

Nom Explication Type de données

items

Extend the array by adding strings, integers, or lists.

Object

getObject(index)

Returns the object at the given index position in the array.

The getObject method is equivalent to indexing an object; that is, obj.getObject(0) is equivalent to obj[0].

Nom Explication Type de données

index

The index position of the array.

Integer

Valeur de retour

Type de données Explication

Object

The Array or Point object at the index position.

insert(index, value)

Adds an object to the Array object at the specified index.

Nom Explication Type de données

index

The index position of the Array object.

Integer

value

The Point or Array object to be inserted.

Object

next()

Returns the next object at the current index.

Valeur de retour

Type de données Explication

Object

The next object at the current index.

remove(index)

Removes the object at the specified index position from the array.

Nom Explication Type de données

index

The index position that will be removed.

Integer

removeAll()

Removes all values and creates an empty object.

replace(index, value)

Replaces the object at the specified index position in the Array object.

Nom Explication Type de données

index

The index position that will be replaced.

Integer

value

The new Point or Array object to be added to the Array object.

Object

reset()

Sets the current enumeration index (used by the next method) back to the first element.

Exemple de code

Array example

Create a polyline feature class from scratch.

import arcpy

# A list of features and coordinate pairs
feature_info = [[[425585.75, 3769682.59],
                 [426151.56, 3767215.02],
                 [424941.35, 3764983.2]],
                [[416248.53, 3770551.91],
                 [416229.21, 3769315.87],
                 [417851.51, 3769270.81],
                 [417870.83, 3770493.97]]]

spatial_ref = arcpy.SpatialReference(26911)  # NAD 1983 UTM Zone 11N

# A list that will hold each of the Polyline objects
features = []

for feature in feature_info:
    # Create a Polyline object based on the array of points
    # Append to the list of Polyline objects
    features.append(
        arcpy.Polyline(
            arcpy.Array([arcpy.Point(*coords) for coords in feature]),
            spatial_ref))

# Persist a copy of the Polyline objects using CopyFeatures
arcpy.management.CopyFeatures(features, "c:/geometry/polylines.shp")