format strings and named arguments in Python

Case 1:

    "{arg1} {arg2}".format (10, 20)

It will give KeyError: 'arg1' because I didn't pass the named arguments.

Case 2:

    "{arg1} {arg2}".format(arg1 = 10, arg2 = 20)

Now it will work properly because I passed the named arguments. And it prints '10 20'

Case 3:

And, If I pass wrong name it will show KeyError: 'arg1'

     "{arg1} {arg2}".format(wrong = 10, arg2 = 20)


Case 4:

If I pass the named arguments in wrong order

    "{arg1} {arg2}".format(arg2 = 10, arg1 = 20)

It works...

and it prints '20 10'

My question is why it works and what's the use of named arguments in this case.

Named replacement fields (the {...} parts in a format string) match against keyword arguments to the .format() method, and not positional arguments.

Keyword arguments are like keys in a dictionary; order doesn't matter, as they are matched against a name.

If you wanted to match against positional arguments, use numbers:

    "{0} {1}".format(10, 20)

In Python 2.7 and up, you can omit the numbers; the {} replacement fields are then auto-numbered in order of appearance in the formatting string:

    "{} {}".format(10, 20)

The formatting string can match against both positional and keyword arguments, and can use arguments multiple times:

    "{1} {ham} {0} {foo} {1}".format(10, 20, foo='bar', ham='spam')

Quoting from the format string specification:

The _fieldname itself begins with an _argname that is either a number or a keyword. If it’s a number, it refers to a positional argument, and if it’s a keyword, it refers to a named keyword argument.

Emphasis mine.

If you are creating a large formatting string, it is often much more readable and maintainable to use named replacement fields, so you don't have to keep counting out the arguments and figure out what argument goes where into the resulting string.

You can also use the **keywords calling syntax to apply an existing dictionary to a format, making it easy to turn a CSV file into formatted output:

    import csv

    fields = ('category', 'code', 'price', 'description', 'link', 'picture', 'plans')
    table_row = '''\
          <td><img src="{picture}"></td>
          <td><a href="{link}">{description}</a> ({price:.2f})</td>

    with open(filename, 'rb') as infile:
        reader = csv.DictReader(infile, fieldnames=fields, delimiter='\t')
        for row in reader:
            row['price'] = float(row['price'])  # needed to make `.2f` formatting work
            print table_row.format(**row)

Here, picture, link, description and price are all keys in the row dictionary, and it is much easier to see what happens when I apply the row to the formatting string.


Back to homepage or read more recommendations: