Type code C Type Python Type Minimum size in bytes 
    'c' char character 1 
    'b' signed char int 1 
    'B' unsigned char int 1 
    'u' Py_UNICODE Unicode character 2 
    'h' signed short int 2 
    'H' unsigned short int 2 
    'i' signed int int 2 
    'I' unsigned int long 2 
    'l' signed long int 4 
    'L' unsigned long long 4 
    'f' float float 4 
    'd' double float 8 

array( typecode[, initializer])

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. Changed in version 2.4: Formerly, only lists or strings were accepted. If given a list or string, the initializer is passed to the new array's fromlist(), fromstring(), or fromunicode() method (see below) to add initial items to the array. Otherwise, the iterable initializer is passed to the extend() method.

append( x) - Append a new item with value x to the end of the array.

    a = array('i', [5,3,12])
    a   # array('i', [5, 3, 12])
    a.append(8)
    a   # array('i', [5, 3, 12, 8])

buffer_info( ) - Return a tuple (address, length) giving the current memory address and the length in elements of the buffer used to hold array's contents. The size of the memory buffer in bytes can be computed as array.buffer_info()[1] * array.itemsize. This is occasionally useful when working with low-level (and inherently unsafe) I/O interfaces that require memory addresses, such as certain ioctl() operations. The returned numbers are valid as long as the array exists and no length-changing operations are applied to it.

    a.buffer_info()   # (12262912, 4)

byteswap( ) - ``Byteswap'' all items of the array. This is only supported for values which are 1, 2, 4, or 8 bytes in size; for other types of values, RuntimeError is raised. It is useful when reading data from a file written on a machine with a different byte order.

    a   # array('i', [5, 3, 12, 8])
    a.byteswap()
    a   # array('i', [83886080, 50331648, 201326592, 134217728])
    a.byteswap()
    a   # array('i', [5, 3, 12, 8])

count( x) - Return the number of occurrences of x in the array.

    a           # array('i', [5, 3, 12, 5, 8])
    a.count(5)  # 2

extend( iterable) - Append items from iterable to the end of the array. If iterable is another array, it must have exactly the same type code; if not, TypeError will be raised. If iterable is not an array, it must be iterable and its elements must be the right type to be appended to the array. Changed in version 2.4: Formerly, the argument could only be another array.

    a   # array('i', [5, 3, 12, 8])
    a.extend([1,2])
    a   # array('i', [5, 3, 12, 8, 1, 2])

fromfile( f, n) - Read n items (as machine values) from the file object f and append them to the end of the array. If less than n items are available, EOFError is raised, but the items that were available are still inserted into the array. f must be a real built-in file object; something else with a read() method won't do.

fromlist( list) - Append items from the list. This is equivalent to "for x in list: a.append(x)"except that if there is a type error, the array is unchanged.

    a   # array('i', [5, 3, 12, 8, 1, 2])
    a.fromlist([3,4])
    a   # array('i', [5, 3, 12, 8, 1, 2, 3, 4])

fromstring( s) - Appends items from the string, interpreting the string as an array of machine values (as if it had been read from a file using the fromfile() method). fromunicode() - same but array and string must both be unicode.

    b   # array('c', 'abc')
    b.fromstring('de')
    b   # array('c', 'abcde')

index( x) - Return the smallest i such that i is the index of the first occurrence of x in the array.

    b               # array('c', 'abcde')
    b.index('b')    # 1

insert( i, x) - Insert a new item with value x in the array before position i. Negative values are treated as being relative to the end of the array.

    b   # array('c', 'abcde')
    b.insert(3, 'z')
    b   # array('c', 'abczde')

pop( [i]) - Removes the item with the index i from the array and returns it. The optional argument defaults to -1, so that by default the last item is removed and returned.

    b         # array('c', 'abczde')
    b.pop()   # 'e'
    b         # array('c', 'abczd')

remove( x) - Remove the first occurrence of x from the array.

    b   # array('c', 'abczdc')
    b.remove('c')
    b   # array('c', 'abzdc')

reverse( ) - Reverse the order of the items in the array.

    b   # array('c', 'abzd')
    b.reverse()
    b   # array('c', 'dzba')

tofile( f) - Write all items (as machine values) to the file object f.

tolist( ) - Convert the array to an ordinary list with the same items (return list).

    b            # array('c', 'dzba')
    b.tolist()   # ['d', 'z', 'b', 'a']

tostring( ) - Convert the array to an array of machine values and return the string representation (the same sequence of bytes that would be written to a file by the tofile() method.) tounicode() is the same but array has to be unicode and resulting string will be unicode.

    b              # array('c', 'dzba')
    b.tostring()   # 'dzba'