# Python Functions

> Learn how functions work in Python: how to define one with def, pass parameters and default values, return one or more values, and call it from your code.

Author: Flavio Copes | Published: 2020-12-22 | Canonical: https://flaviocopes.com/python-functions/

A function lets us create a set of instructions that we can run when needed.

Functions are essential in [Python](https://flaviocopes.com/python-introduction/) and in many other programming languages to create meaningful programs, because they allow us to decompose a program into manageable parts, they promote readability and code reuse.

Here is an example function called `hello` that prints "Hello!":

```python
def hello():
    print('Hello!')
```

This is the function **definition**. There is a name (`hello`) and a body, the set of instructions, which is the part that follows the colon and it's indented one level on the right.

To run this function, we must call it. This is the syntax to call the function:

```python
hello()
```

We can execute this function once, or multiple times.

The name of the function, `hello`, is very important. It should be descriptive, so anyone calling it can imagine what the function does.

A function can accept one or more parameters:

```python
def hello(name):
    print('Hello ' + name + '!')
```

In this case we call the function passing the argument

```python
hello('Roger')
```

> We call _parameters_ the values accepted by the function inside the function definition, and _arguments_ the values we pass to the function when we call it. It's common to get confused about this distinction.

An argument can have a default value that's applied if the argument is not specified:

```python
def hello(name='my friend'):
    print('Hello ' + name + '!')

hello()
#Hello my friend!
```

Here's how we can accept multiple parameters:

```python
def hello(name, age):
    print('Hello ' + name + ', you are ' + str(age) + ' years old!')
```

In this case we call the function passing a set of arguments:

```python
hello('Roger', 8)
```

Parameters are passed by reference. All types in Python are objects but some of them are immutable, including integers, booleans, floats, strings, and tuples. This means that if you pass them as parameters and you modify their value inside the function, the new value is not reflected outside of the function:

```python
def change(value):
    value = 2

val = 1
change(val)

print(val) #1
```

If you pass an object that's not immutable, and you change one of its properties, the change will be reflected outside.

A function can return a value, using the `return` statement. For example in this case we return the `name` parameter name:

```python
def hello(name):
    print('Hello ' + name + '!')
    return name
```

When the function meets the `return` statement, the function ends.

We can omit the value:

```python
def hello(name):
    print('Hello ' + name + '!')
    return
```

We can have the return statement inside a conditional, which is a common way to end a function if a starting condition is not met:

```python
def hello(name):
    if not name:
        return
    print('Hello ' + name + '!')
```

If we call the function passing a value that evaluates to `False`, like an empty string, the function is terminated before reaching the `print()` statement.

You can return multiple values by using comma separated values:

```python
def hello(name):
    print('Hello ' + name + '!')
    return name, 'Roger', 8
```

In this case calling `hello('Syd')` the return value is a tuple containing those 3 values: `('Syd', 'Roger', 8)`.