Array

Summary

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

Syntax

 Array  ({items})

Parameter	Explanation	Data Type
items	Items can include a list, a Point object, or another Array object.	Object

Properties

Property	Explanation	Data Type
count (Read Only)	The element count of the array.	Integer

Method Overview

Method	Explanation
add (value)	Adds a Point or Array object to the end of the array.
append (value)	Appends an object to the array in the last position.
clone (point_object)	Clone the Point object.
extend (items)	Extends the array by appending elements.
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].
insert (index, value)	Adds an object to the Array object at the specified index.
next ()	Returns the next object at the current index.
remove (index)	Removes the object at the specified index position from the array.
removeAll ()	Removes all values and creates an empty object.
replace (index, value)	Replaces the object at the specified index position in the Array object.
reset ()	Sets the current enumeration index (used by the next method) back to the first element.

Methods

add (value)

Parameter	Explanation	Data Type
value	Either a Point or Array object can be appended to the array.	Object

append (value)

Parameter	Explanation	Data Type
value	Either a Point or Array object can be appended to the array.	Object

clone (point_object)

Parameter	Explanation	Data Type
point_object	A Point object.	Point

extend (items)

Parameter	Explanation	Data Type
items	Extends the array by adding strings, integers, or lists.	Object

getObject (index)

Parameter	Explanation	Data Type
index	The index position of the array.	Integer

Return Value

Data Type	Explanation
Object	The Array or Point object at the index position.

insert (index, value)

Parameter	Explanation	Data Type
index	The index position of the Array object.	Integer
value	The Point or Array object to be inserted.	Object

next ()

Return Value

Data Type	Explanation
Object	The next object at the current index.

remove (index)

Parameter	Explanation	Data Type
index	The index position that will be removed.	Integer

removeAll ()

replace (index, value)

Parameter	Explanation	Data Type
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 ()

Code sample

Array example

Create a polyline feature class from scratch.

import arcpy

# A list of features and coordinate pairs
feature_info = [[[1, 2], [2, 4], [3, 7]],
                [[6, 8], [5, 7], [7, 2], [9, 5]]]

# 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])))

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