Join the Stack Overflow Community
Stack Overflow is a community of 6.4 million programmers, just like you, helping each other.
Join them; it only takes a minute:
Sign up

How do I declare an array in Python?

I can't find any reference to arrays in the documentation.

share|improve this question
57  
For some unfathomable reason, Python calls arrays "lists". The "everyone-knows-what-this-is-called-so-we're-going-to-call-i‌​t-something-else" school of language design. It's a particularly bad choice of name, since it looks like a linked list rather than an array. – Glenn Maynard Oct 3 '09 at 19:11
26  
@Glenn Maynard: probably because in C-like languages arrays are fixed length while Python lists are not. Its more like STL vector in C++ or ArrayList in Java. – MAK Oct 3 '09 at 19:36
82  
It's called a list, because it's a list. [A(), 1, 'Foo', u'öäöäö', 67L, 5.6]. A list. An array is "an arrangement of items at equally spaced addresses in computer memory" (wikipedia). – Lennart Regebro Oct 3 '09 at 19:40
24  
Nothing about the universally-understood term "array" suggests a fixed length or anything about the content; those are just limitations of C's particular implementation of arrays. Python lists are equally spaced (pointers to objects, internally), or else __getitem__ wouldn't be O(1). – Glenn Maynard Oct 3 '09 at 20:13
14  
@Glenn, from en.wikipedia.org/wiki/Array_data_structure : "the elements of an array data structure are required to have the same size" (true for Python's arrays, not true for Python lists) and "set of valid index tuples and the addresses of the elements (and hence the element addressing formula) are usually fixed while the array is in use" (not true in Python for either list or array). – Alex Martelli Oct 3 '09 at 22:27

14 Answers 14

variable = []

Now variable refers to an empty list*.

Of course this is an assignment, not a declaration. There's no way to say in Python "this variable should never refer to anything other than a list", since Python is dynamically typed.


*The default built-in Python type is called a list, not an array. It is an ordered container of arbitrary length that can hold a heterogenous collection of objects (their types do not matter and can be freely mixed). This should not be confused with the array module, which offers a type closer to the C array type; the contents must be homogenous (all of the same type), but the length is still dynamic.

share|improve this answer
5  
Would it be possible to initialize the contents of the array, as in JavaScript? (e.g., as variable = ["Hi", "Hello"];?) – Anderson Green Mar 18 '13 at 4:31
2  
@AndersonGreen Yes. – sepp2k Mar 18 '13 at 10:30
2  
How would you declare a multidimensional array, then (e. g., a 2D array?) – Anderson Green Apr 5 '13 at 1:45
3  
@AndersonGreen As I said there's no such thing as a variable declaration in Python. You would create a multidimensional list by taking an empty list and putting other lists inside it or, if the dimensions of the list are known at write-time, you could just write it as a literal like this: my_2x2_list = [[a, b], [c, d]]. Depending on what you need multi-dimensional arrays for, you also might consider using numpy, which defines array types for multi-dimensional, homogeneous, unboxed arrays that can be much more efficient where applicable, so they're preferable for numeric computations. – sepp2k Apr 5 '13 at 9:43
1  
@IfanIqbal Yes, if it contains at least one element, you can. – sepp2k Oct 9 '13 at 23:34

You don't actually declare things, but this is how you create an array in Python:

from array import array
intarray = array('i')

For more info see the array module: http://docs.python.org/library/array.html

Now possible you don't want an array, but a list, but others have answered that already. :)

share|improve this answer
5  
This is sort of funny, but not really a good answer for a question tagged "beginner". Just to make it clear: In Python you usually use a data type called a list. Python has a special-purpose data type called an array which is more like a C array and is little used. – steveha Oct 4 '09 at 2:48
36  
No, but everyone else already used a list. I thought it would be a good answer to point out that there are arrays too. – Lennart Regebro Oct 4 '09 at 7:38
2  
super mad props for this answer. I've been programming in Python for years and only recently realized that there was an actual Python array object that is different from list objects. While the data struct is very similar, arrays limit what type of objects the array can hold. Great answer @LennartRegebro! – Josh Brown Jul 4 '15 at 10:38
1  
This should be the right answer List and Arrays are two different things @LennartRegebro thanks – Mina Gabriel Oct 28 at 10:48

I think you (meant)want an list with the first 30 cells already filled. So

   f = []

   for i in range(30):
       f.append(0)

An example to where this could be used is in Fibonacci sequence. See problem 2 in Project Euler

share|improve this answer
47  
That's a rather baroque way of initialising a list. Try f = [0] * 30 instead. – John Machin Dec 18 '10 at 6:24
5  
+1 to explain also append. Thx!. – albciff Aug 22 '14 at 21:48
    
Is not the same than a = range(10) from @slehar anwer? Love python, it's syntax and it's Zen. – erm3nda Jun 12 '15 at 16:16

You don't declare anything in Python. You just use it. I recommend you start out with something like http://diveintopython.net.

share|improve this answer
1  
Some times you must declare the type of a variable: if you don't use it before, a control structure, it doesn't exist outside the control structure and you will then be constructing a new variable. The assumption is then that the variable is an int, which clashes if you use it as a more complex type. – Clearer Feb 19 '15 at 11:31
    
@Clearer yes, using functions sometimes need to declare it, and sometimes to play some globals when using functions and don't wanna write too much arguments on functions. – erm3nda Jun 12 '15 at 16:13
    
It's not just function; a simple if statement could give you the same problem. – Clearer Jul 29 '15 at 12:04

This is how:

my_array = [1, 'rebecca', 'allard', 15]
share|improve this answer

I would normally just do a = [1,2,3] which is actually a list but for arrays look at this formal definition

share|improve this answer

for calculations, use numpy arrays like this:

import numpy as np

a = np.ones((3,2))        # a 2D array with 3 rows, 2 columns, filled with ones
b = np.array([1,2,3])     # a 1D array initialised using a list [1,2,3]
c = np.linspace(2,3,100)  # an array with 100 points beteen (and including) 2 and 3

print(a*1.5)  # all elements of a times 1.5
print(a.T+b)  # b added to the transpose of a

these numpy arrays can be saved and loaded from disk (even compressed) and complex calculations with large amounts of elements is C-like fast. Much used in scientific environments. See here for more...

share|improve this answer

This is surprisingly complex topic in Python.

Practical answer

Arrays are represented by class list (see reference and do not mix them with generators).

Check out usage examples:

# empty array
arr = [] 

# init with values (can contain mixed types)
arr = [1, "eels"]

# get item by index (can be negative to access end of array)
arr = [1, 2, 3, 4, 5, 6]
arr[0]  # 1
arr[-1] # 6

# get length
length = len(arr)

# supports append and insert
arr.append(8)
arr.insert(6, 7)

Theoretical answer

Under the hood Python's list is a wrapper for a real array which contains references to items. Also, underlying array is created with some extra space.

Consequences of this are:

  • random access is really cheap (arr[6653] is same to arr[0])
  • append operation is 'for free' while some extra space
  • insert operation is expensive

Check this awesome table of operations complexity.

Also, please see this picture, where I've tried to show most important differences between array, array of references and linked list: arrays, arrays everywhere

share|improve this answer
1  
Just to add, there is a really cool way to cut arrays in python: for [1, 2, 3, 4, 5, 6, 7, 8, 9][1:-2] result will be [2, 3, 4, 5, 6, 7] – Anton Purin Mar 16 at 17:19
1  
I see some down votes for this post time to time. It would be great if someone could post a word why. Thanks. – Anton Purin Oct 31 at 12:29

Following on from Lennart, there's also numpy which implements homogeneous multi-dimensional arrays.

share|improve this answer

How about this...

>>> a = range(12)
>>> a
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]
>>> a[7]
6
share|improve this answer

To add to Lennart's answer, an array may be created like this:

from array import array
float_array = array("f",values)

where values can take the form of a tuple, list, or np.array, but not array:

values = [1,2,3]
values = (1,2,3)
values = np.array([1,2,3],'f')
# 'i' will work here too, but if array is 'i' then values have to be int
wrong_values = array('f',[1,2,3])
# TypeError: 'array.array' object is not callable

and the output will still be the same:

print(float_array)
print(float_array[1])
print(isinstance(float_array[1],float))

# array('f', [1.0, 2.0, 3.0])
# 2.0
# True

Most methods for list work with array as well, common ones being pop(), extend(), and append().

Judging from the answers and comments, it appears that the array data structure isn't that popular. I like it though, the same way as one might prefer a tuple over a list.

The array structure has stricter rules than a list or np.array, and this can reduce errors and make debugging easier, especially when working with numerical data.

Attempts to insert/append a float to an int array will throw a TypeError:

values = [1,2,3]
int_array = array("i",values)
int_array.append(float(1))
# or int_array.extend([float(1)])

# TypeError: integer argument expected, got float

Keeping values which are meant to be integers (e.g. list of indices) in the array form may therefore prevent a "TypeError: list indices must be integers, not float", since arrays can be iterated over, similar to np.array and lists:

int_array = array('i',[1,2,3])
data = [11,22,33,44,55]
sample = []
for i in int_array:
    sample.append(data[i])

Annoyingly, appending an int to a float array will cause the int to become a float, without throwing an exception.

np.array retain the same data type for its entries too, but instead of giving an error it will change its data type to fit new entries (usually to double or str):

import numpy as np
numpy_int_array = np.array([1,2,3],'i')
for i in numpy_int_array:
    print(type(i))
    # <class 'numpy.int32'>
numpy_int_array_2 = np.append(numpy_int_array,int(1))
# still <class 'numpy.int32'>
numpy_float_array = np.append(numpy_int_array,float(1))
# <class 'numpy.float64'> for all values
numpy_str_array = np.append(numpy_int_array,"1")
# <class 'numpy.str_'> for all values
data = [11,22,33,44,55]
sample = []
for i in numpy_int_array_2:
    sample.append(data[i])
    # no problem here, but TypeError for the other two

This is true during assignment as well. If the data type is specified, np.array will, wherever possible, transform the entries to that data type:

int_numpy_array = np.array([1,2,float(3)],'i')
# 3 becomes an int
int_numpy_array_2 = np.array([1,2,3.9],'i')
# 3.9 gets truncated to 3 (same as int(3.9))
invalid_array = np.array([1,2,"string"],'i')
# ValueError: invalid literal for int() with base 10: 'string'
# Same error as int('string')
str_numpy_array = np.array([1,2,3],'str')
print(str_numpy_array)
print([type(i) for i in str_numpy_array])
# ['1' '2' '3']
# <class 'numpy.str_'>

or, in essence:

data = [1.2,3.4,5.6]
list_1 = np.array(data,'i').tolist()
list_2 = [int(i) for i in data]
print(list_1 == list_2)
# True

while array will simply give:

invalid_array = array([1,2,3.9],'i')
# TypeError: integer argument expected, got float

Because of this, it is not a good idea to use np.array for type-specific commands. The array structure is useful here. list preserves the data type of the values.

And for something I find rather pesky: the data type is specified as the first argument in array(), but (usually) the second in np.array(). :|

The relation to C is referred to here: Python List vs. Array - when to use?

Have fun exploring!

Note: The typed and rather strict nature of array leans more towards C rather than Python, and by design Python does not have many type-specific constraints in its functions. Its unpopularity also creates a positive feedback in collaborative work, and replacing it mostly involves an additional [int(x) for x in file]. It is therefore entirely viable and reasonable to ignore the existence of array. It shouldn't hinder most of us in any way. :D

share|improve this answer

Python calls them lists. You can write a list literal with square brackets and commas:

>>> [6,28,496,8128]
[6, 28, 496, 8128]
share|improve this answer

A couple of contributions suggested that arrays in python are represented by lists. Perhaps theoretically/under the hood that is correct however a major distinction between the two is the fact that lists accept mixed data types and mixed numeric types, on the other hand array requires a type-code restricting all elements to the determined type:

list_01 = [4, 6.2, 7-2j, 'flo', 'cro']

list_01
Out[85]: [4, 6.2, (7-2j), 'flo', 'cro']

This is not possible using array().

share|improve this answer

I had an array of strings and needed an array of the same length of booleans initiated to True. This is what I did

strs = ["Hi","Bye"] 
bools = [ True for s in strs ]
share|improve this answer

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.