Python Function Arguments
Arguments
Information can be passed into functions as arguments.
Arguments are specified after the function name, inside the parentheses. You can add as many arguments as you want, just separate them with a comma.
The following example has a function with one argument (fname). When the function is called, we pass along a first name, which is used inside the function to print the full name:
Example
A function with one argument:
print(fname + " Refsnes")
my_function("Emil")
my_function("Tobias")
my_function("Linus")
Parameters vs Arguments
The terms parameter and argument can be used for the same thing: information that are passed into a function.
From a function's perspective:
A parameter is the variable listed inside the parentheses in the function definition.
An argument is the actual value that is sent to the function when it is called.
Example
print("Hello", name)
my_function("Emil") # "Emil" is an argument
Number of Arguments
By default, a function must be called with the correct number of arguments.
If your function expects 2 arguments, you must call it with exactly 2 arguments.
Example
This function expects 2 arguments, and gets 2 arguments::
print(fname + " " + lname)
my_function("Emil", "Refsnes")
If you try to call the function with the wrong number of arguments, you will get an error:
Example
This function expects 2 arguments, but gets only 1:
print(fname + " " + lname)
my_function("Emil")
Default Parameter Values
You can assign default values to parameters. If the function is called without an argument, it uses the default value:
Example
print("Hello", name)
my_function("Emil")
my_function("Tobias")
my_function()
my_function("Linus")
Example
Default value for country parameter:
print("I am from", country)
my_function("Sweden")
my_function("India")
my_function()
my_function("Brazil")
Keyword Arguments
You can send arguments with the key = value syntax.
Example
print("I have a", animal)
print("My", animal + "'s name is", name)
my_function(animal = "dog", name = "Buddy")
This way, with keyword arguments, the order of the arguments does not matter.
Example
print("I have a", animal)
print("My", animal + "'s name is", name)
my_function(name = "Buddy", animal = "dog")
The phrase Keyword Arguments is often shortened to kwargs in Python documentation.
Positional Arguments
When you call a function with arguments without using keywords, they are called positional arguments.
Positional arguments must be in the correct order:
Example
print("I have a", animal)
print("My", animal + "'s name is", name)
my_function("dog", "Buddy")
The order matters with positional arguments:
Example
Switching the order changes the result:
print("I have a", animal)
print("My", animal + "'s name is", name)
my_function("Buddy", "dog")
Mixing Positional and Keyword Arguments
You can mix positional and keyword arguments in a function call.
However, positional arguments must come before keyword arguments:
Example
print("I have a", age, "year old", animal, "named", name)
my_function("dog", name = "Buddy", age = 5)
Passing Different Data Types
You can send any data type as an argument to a function (string, number, list, dictionary, etc.).
The data type will be preserved inside the function:
Example
Sending a list as an argument:
for fruit in fruits:
print(fruit)
my_fruits = ["apple", "banana", "cherry"]
my_function(my_fruits)
Example
Sending a dictionary as an argument:
print("Name:", person["name"])
print("Age:", person["age"])
my_person = {"name": "Emil", "age": 25}
my_function(my_person)
Return Values
Functions can return values using the return statement:
Example
return x + y
result = my_function(5, 3)
print(result)
Returning Different Data Types
Functions can return any data type, including lists, tuples, dictionaries, and more.
Example
A function that returns a list:
return ["apple", "banana", "cherry"]
fruits = my_function()
print(fruits[0])
print(fruits[1])
print(fruits[2])
Example
A function that returns a tuple:
return (10, 20)
x, y = my_function()
print("x:", x)
print("y:", y)
Positional-Only Arguments
You can specify that a function can have ONLY positional arguments.
To specify positional-only arguments, add , / after the arguments:
Without the , / you are actually allowed to use keyword arguments even if the function
expects positional arguments:
With , /, you will get an error if you try to use keyword arguments:
Keyword-Only Arguments
To specify that a function can have only keyword arguments, add *, before the arguments:
Without *,, you are allowed to use positional arguments even if the function expects keyword arguments:
With *,, you will get an error if you try to use positional arguments:
Combining Positional-Only and Keyword-Only
You can combine both argument types in the same function.
Arguments before / are positional-only, and arguments after * are keyword-only:
Example
return a + b + c + d
result = my_function(5, 10, c = 15, d = 20)
print(result)