Python: enumerate() function

Last update on May 28 2022 12:41:29 (UTC/GMT +8 hours)

enumerate() function

The enumerate() function returns an enumerate object. iterable must be a sequence, an iterator, or some other object which supports iteration.

Note: The __next__() method of the iterator returned by enumerate() returns a tuple containing a count (from start which defaults to 0) and the values obtained from iterating over iterable.

Version:

(Python 3)

Syntax:

enumerate(iterable, start=0)

Parameter:

Name	Description
iterable	A sequence, an iterator, or some other object which supports iteration
start	A Number. Defining the start number of the enumerate object. Default 0.If start is omitted, 0 is taken as start.

Return value:

Return an enumerate object.

Example: Python enumerate() function

<<< seasons = ['Spring', 'Summer', 'Fall', 'Winter']
<<< list(enumerate(seasons))
[(0, 'Spring'), (1, 'Summer'), (2, 'Fall'), (3, 'Winter')]
<<< list(enumerate(seasons, start=1))
[(1, 'Spring'), (2, 'Summer'), (3, 'Fall'), (4, 'Winter')]

Equivalent to:

def enumerate(sequence, start=0):
    n = start
    for elem in sequence:
        yield n, elem
        n += 1

Example: Python enumerate() function

fruits = ['Mango', 'Apple', 'Orange', 'Peach']
print(list(enumerate(fruits)))
print(list(enumerate(fruits, start=1)))

Output:

[(0, 'Mango'), (1, 'Apple'), (2, 'Orange'), (3, 'Peach')]                      
[(1, 'Mango'), (2, 'Apple'), (3, 'Orange'), (4, 'Peach')]

Example:

Fruits = ['Apple', 'Mango', 'Orange']
enumerateFruits = enumerate(Fruits)

print(type(enumerateFruits))

# converting to list
print(list(enumerateFruits))

# changing the default counter
enumerateFruits = enumerate(Fruits, 10)
print(list(enumerateFruits))

Output:

<class 'enumerate'>  
[(0, 'Apple'), (1, 'Mango'), (2, 'Orange')]  [(10, 'Apple'), (11, 'Mango'), (12, 'Orange')]

Example: Looping Over an Enumerate object

Fruits = ['Apple', 'Mango', 'Orange']

for item in enumerate(Fruits):
  print(item)

print('\n')
for count, item in enumerate(Fruits):
  print(count, item)

print('\n')
# changing default start value
for count, item in enumerate(Fruits, 50):
  print(count, item)

Output:


(0, 'Apple')
(1, 'Mango')
(2, 'Orange')


0 Apple
1 Mango
2 Orange


50 Apple
51 Mango
52 Orange

Python Code Editor:

Previous: divmod()
Next: eval()

Test your Python skills with w3resource's quiz

Python: Tips of the Day

Find current directory and file's directory:

To get the full path to the directory a Python file is contained in, write this in that file:

import os dir_path = os.path.dirname(os.path.realpath(__file__))

(Note that the incantation above won't work if you've already used os.chdir() to change your current working directory, since the value of the __file__ constant is relative to the current working directory and is not changed by an os.chdir() call.)

To get the current working directory use

import os cwd = os.getcwd()

Documentation references for the modules, constants and functions used above:

The os and os.path modules.

The __file__ constant

os.path.realpath(path) (returns "the canonical path of the specified filename, eliminating any symbolic links encountered in the path")

os.path.dirname(path) (returns "the directory name of pathname path")

os.getcwd() (returns "a string representing the current working directory")

os.chdir(path) ("change the current working directory to path")

Ref: https://bit.ly/3fy0R6m