How To Use *args and **kwargs In Python

3 min read

Functions are reusable a block of codes performing a specific task, they make the program more effective and modular.

While defining a function in Python, we also specify the parameters it can accept which we later pass as arguments in function call.

However, there might be situations when you are not aware of the total number of arguments required or you suspect that later on, the function may need additional arguments.

We can use the special syntax * args  and **kwargs within a function definition in order to pass any number of arguments to a function. In this article, we guide you on how to use *args and **kwars efficiently in Python.

*args In Python

In Python, *args is used to pass an arbitrary number of arguments to a function. It's worth mentioning that the single asterisk( * ) is the most important element, the word arg is just a naming convention we can name it anything it will work as long as we have a ( * ) before it.

This could be better understood by the following example, Let's create a function which can add numbers,

def total_sum(x, y):
    sum = x + y
    print(sum)

total_sum(3,4)

This simple function adds the two number which we pass in the function call. But what if we want to add three numbers?

Unfortunately passing three arguments in function call will lead to an error.

def total_sum(x, y):
    sum = x + y
    print(sum)

total_sum(3,4,2)

Output:

TypeError: total_sum() takes 2 positional arguments but 3 were given

The *args parameter is helpful in tackling such programming issues. Using  *args parameter gives the function ability to accepts any number of positional arguments.

def total_sum(*args):
    sum = 0
    for num in args:
        sum += num
    print("Sum :", sum)


total_sum(3, 4)
total_sum(3, 6, 7, 8,2)
total_sum(3, 7, 8,2)
total_sum(3, 8, 9)

Output:

Sum : 7
Sum : 26
Sum : 20
Sum : 20

Now we can pass as many arguments we wish and the function will work for all of them, this makes our code more modular and flexible.

As stated above the asterisk(*) is the most important syntax we can replace args with literally anything yet it will work.

def total_sum(*anything):
    sum = 0
    for num in anything:
        sum += num
    print("Sum :", sum)


total_sum(3, 4)
total_sum(3, 6, 7, 8,2)
total_sum(3, 7, 8,2)
total_sum(3, 8, 9)

Output:

Sum : 7
Sum : 26
Sum : 20
Sum : 20

Using **kwargs In Python

Keyword arguments allow passing arguments as parameter names. In order to design a function which takes an arbitrary number of keywords arguments **kwargs in used as a parameter. It's worth noting that the double astrick(**) is the key element here kwargs is just a convention you can use any word.

def print_kwargs(**kwargs):
    print(kwargs)


print_kwargs(a=1, b=2, c="Some Text")

Output:

{'a': 1, 'b': 2, 'c': 'Some Text'}

We received all the keywords and their values in a dictionary(Key: value) form and we can perform every dictionary operation on it. Note that dictionaries are unordered (On Python 3.5 and lower ) so your result may vary for a large dictionary.

Let's extend the function to perform some basic dictionary operations.

def print_kwargs(**kwargs):
    for key in kwargs:
        print("The key {} holds {} value".format(key, kwargs[key]))


print_kwargs(a=1, b=2, c="Some Text")

Output:

The key a holds 1 value
The key b holds 2 value
The key c holds Some Text value

Keywords arguments are making our functions more flexible.

In Python, we can use both *args and **kwargs on the same function as follows:

def function( *args, **kwargs):
    print(args)
    print(kwargs)


function(6, 7, 8, a=1, b=2, c="Some Text")

Output:

(7, 8)

{'a': 1, 'b': 2, 'c': 'Some Text'}

PYTHON

Latest Articles

Latest from djangocentral

Capturing Query Parameters of request.get in Django

In Django, the request object contains a variety of information about the current HTTP request, including the query parameters. Query parameters are a way to pass additional information in the URL and are used to filter or sort data. The request object p…
Read more →

2 min read

Understanding related_name in Django Models

In Django, related_name is an attribute that can be used to specify the name of the reverse relation from the related model back to the model that defines the relation. It is used to specify the name of the attribute that will be used to access the relat…
Read more →

2 min read