Module array :: Class array
[hide private]
[frames] | no frames]

type array

object --+
         |
        array

array(typecode [, initializer]) -> array

Return a new array whose items are restricted by typecode, and initialized from the optional initializer value, which must be a list, string. or iterable over elements of the appropriate type.

Arrays represent basic values and behave very much like lists, except the type of objects stored in them is constrained.

Methods:

append() -- append a new item to the end of the array buffer_info() -- return information giving the current memory info byteswap() -- byteswap all the items of the array count() -- return number of occurences of an object extend() -- extend array by appending multiple elements from an iterable fromfile() -- read items from a file object fromlist() -- append items from the list fromstring() -- append items from the string index() -- return index of first occurence of an object insert() -- insert a new item into the array at a provided position pop() -- remove and return item (default last) read() -- DEPRECATED, use fromfile() remove() -- remove first occurence of an object reverse() -- reverse the order of the items in the array tofile() -- write all items to a file object tolist() -- return the array converted to an ordinary list tostring() -- return the array converted to a string write() -- DEPRECATED, use tofile()

Attributes:

typecode -- the typecode character used to create the array itemsize -- the length in bytes of one array item

Instance Methods [hide private]
 
__add__(x, y)
x+y
 
__contains__(x, y)
y in x
 
__copy__(array)
Return a copy of the array.
 
__deepcopy__(array)
Return a copy of the array.
 
__delitem__(x, y)
del x[y]
 
__delslice__(x, i, j)
del x[i:j]
 
__eq__(x, y)
x==y
 
__ge__(x, y)
x>=y
 
__getattribute__(...)
x.__getattribute__('name') <==> x.name
 
__getitem__(x, y)
x[y]
 
__getslice__(x, i, j)
x[i:j]
 
__gt__(x, y)
x>y
 
__iadd__(x, y)
x+=y
 
__imul__(x, y)
x*=y
 
__iter__(x)
iter(x)
 
__le__(x, y)
x<=y
 
__len__(x)
len(x)
 
__lt__(x, y)
x<y
 
__mul__(x, n)
x*n
 
__ne__(x, y)
x!=y
a new object with type S, a subtype of T
__new__(T, S, ...)
 
__reduce__(...)
Return state information for pickling.
 
__repr__(x)
repr(x)
 
__rmul__(x, n)
n*x
 
__setitem__(x, i, y)
x[i]=y
 
__setslice__(x, i, j, y)
x[i:j]=y
 
append(x)
Append new value x to the end of the array.
(address, length)
buffer_info()
Return a tuple (address, length) giving the current memory address and the length in items of the buffer used to hold array's contents The length should be multiplied by the itemsize attribute to calculate the buffer length in bytes.
 
byteswap()
Byteswap all items of the array.
 
count(x)
Return number of occurences of x in the array.
 
extend(...)
extend(array or iterable)
 
fromfile(f, n)
Read n objects from the file object f and append them to the end of the array.
 
fromlist(list)
Append items to array from list.
 
fromstring(string)
Appends items from the string, interpreting it as an array of machine values,as if it had been read from a file using the fromfile() method).
 
fromunicode(ustr)
Extends this array with data from the unicode string ustr.
 
index(x)
Return index of first occurence of x in the array.
 
insert(i, x)
Insert a new item x into the array before position i.
 
pop(i=...)
Return the i-th element and delete it from the array.
 
read(f, n)
Read n objects from the file object f and append them to the end of the array.
 
remove(x)
Remove the first occurence of x in the array.
 
reverse()
Reverse the order of the items in the array.
 
tofile(f)
Write all items (as machine values) to the file object f.
list
tolist()
Convert array to an ordinary list with the same items.
string
tostring()
Convert the array to an array of machine values and return the string representation.
unicode
tounicode()
Convert the array to a unicode string.
 
write(f)
Write all items (as machine values) to the file object f.
Properties [hide private]
  itemsize
the size, in bytes, of one array item
  typecode
the typecode character used to create the array
Method Details [hide private]

__delslice__(x, i, j)
(Slice deletion operator)

 

del x[i:j]

Use of negative indices is not supported.

__getattribute__(...)

 

x.__getattribute__('name') <==> x.name

Overrides: object.__getattribute__

__getslice__(x, i, j)
(Slicling operator)

 

x[i:j]

Use of negative indices is not supported.

__new__(T, S, ...)

 
Returns: a new object with type S, a subtype of T
Overrides: object.__new__

__reduce__(...)

 

Return state information for pickling.

Overrides: object.__reduce__

__repr__(x)
(Representation operator)

 

repr(x)

Overrides: object.__repr__

__setslice__(x, i, j, y)
(Slice assignment operator)

 

x[i:j]=y

Use of negative indices is not supported.

byteswap()

 

Byteswap all items of the array. If the items in the array are not 1, 2, 4, or 8 bytes in size, RuntimeError is raised.

extend(...)

 

extend(array or iterable)

Append items to the end of the array.

fromfile(f, n)

 

Read n objects from the file object f and append them to the end of the array. Also called as read.

fromunicode(ustr)

 

Extends this array with data from the unicode string ustr. The array must be a type 'u' array; otherwise a ValueError is raised. Use array.fromstring(ustr.decode(...)) to append Unicode data to an array of some other type.

pop(i=...)

 

Return the i-th element and delete it from the array. i defaults to -1.

read(f, n)

 

Read n objects from the file object f and append them to the end of the array. Also called as read.

tofile(f)

 

Write all items (as machine values) to the file object f. Also called as write.

tounicode()

 

Convert the array to a unicode string. The array must be a type 'u' array; otherwise a ValueError is raised. Use array.tostring().decode() to obtain a unicode string from an array of some other type.

Returns: unicode

write(f)

 

Write all items (as machine values) to the file object f. Also called as write.