Create a range object python

1. Home
2. Python Built-in Functions
3. Python range() function

(Sponsors) Get started learning Python with DataCamp's free Intro to Python tutorial. Learn Data Science by completing interactive coding challenges and watching videos by expert instructors. Start Now!

Updated on Jan 07, 2020

The range() function is used to generate a sequence of numbers over time. At its simplest, it accepts an integer and returns a range object (a type of iterable). In Python 2, the range() returns a list which is not very efficient to handle large data.

The syntax of the range() function is as follows:

Syntax:

range([start,] stop [, step]) -> range object

Let's now look at a couple of examples to understand how range() works:

Example 1:

>>> 
>>> range(5)
range(0, 5)
>>> 
>>> list(range(5)) # list() call is not required in Python 2
[0, 1, 2, 3, 4]
>>>

Try it out:

When range() is called with a single argument it generates a sequence of numbers from 0 upto the argument specified (but not including it). That's why the number 5 is not included in the sequence.

Example 2:

>>>
>>> range(5, 10)
range(5, 10)
>>> 
>>> list(range(5, 10))
[5, 6, 7, 8, 9]
>>>

Try it out:

Here range() is called with two arguments, 5 and 10. As a result, it will generate a sequence of numbers from 5 up to 10 (but not including 10).

You can also specify negative numbers:

>>> 
>>> list(range(-2, 2))
[-2, -1, 0, 1]
>>> 
>>> list(range(-100, -95))
[-100, -99, -98, -97, -96]
>>>

Try it out:

Example 3:

>>> 
>>> range(1, 20, 3)
range(1, 20, 3)
>>> 
>>> 
>>> list(range(1, 20, 3))
[1, 4, 7, 10, 13, 16, 19]
>>>

Try it out:

Here the range() function is called with a step argument of 3, so it will return every third element from 1 to 20 (off course not including 20).

You can also use the step argument to count backwards.

>>> 
>>> list(range(20, 10, -1))
[20, 19, 18, 17, 16, 15, 14, 13, 12, 11]
>>> 
>>> list(range(20, 10, -5))
[20, 15]
>>>

Try it out:

The range() function is commonly used with for loop to repeat an action certain number of times. For example, in the following listing, we use range() to execute the loop body 5 times.

>>> 
>>> for i in range(5):
...     print(i)
... 
0
1
2
3
4
>>>

Try it out:

This code is functionally equivalent to the following:

>>> 
>>> for i in [0, 1, 2, 3, 4]:
...     print(i)
... 
0
1
2
3
4
>>>

However, in the actual code, you should always use range() because it is concise, flexible and performs better.

Other Tutorials (Sponsors)

This site generously supported by DataCamp. DataCamp offers online interactive Python Tutorials for Data Science. Join over a million other learners and get started learning Python for data science today!

How do you create a range of objects in Python?

What is a range object Python?

How do you make a range inclusive in Python?

What is the syntax for range () function in Python?