How do I write a function with output parameters (call by reference)?
PythonLevel: Intermediate
How do I write a function with output parameters (call by reference)?
Hints
- Identify object types, mutability and execution order.
- Trace a minimal example: which values and references change?
Answer
Remember that arguments are passed by assignment in Python. Since assignment just creates references to objects, there’s no alias between an argument name in the caller and callee, and so no call-by-reference per se. You can achieve the desired effect in a number of ways.
- By returning a tuple of the results:
>>> def func1(a, b):
... a = 'new-value' # a and b are local names
... b = b + 1 # assigned to new objects
... return a, b # return new values
...
>>> x, y = 'old-value', 99
>>> func1(x, y)
('new-value', 100)
This is almost always the clearest solution.
-
By using global variables. This isn’t thread-safe, and is not recommended.
-
By passing a mutable (changeable in-place) object:
>>> def func2(a):
... a[0] = 'new-value' # 'a' references a mutable list
... a[1] = a[1] + 1 # changes a shared object
...
>>> args = ['old-value', 99]
>>> func2(args)
>>> args
['new-value', 100]
- By passing in a dictionary that gets mutated:
>>> def func3(args):
... args['a'] = 'new-value' # args is a mutable dictionary
... args['b'] = args['b'] + 1 # change it in-place
...
>>> args = {'a': 'old-value', 'b': 99}
>>> func3(args)
>>> args
{'a': 'new-value', 'b': 100}
- Or bundle up values in a class instance:
>>> class Namespace:
... def __init__(self, /, **args):
... for key, value in args.items():
... setattr(self, key, value)
...
>>> def func4(args):
... args.a = 'new-value' # args is a mutable Namespace
... args.b = args.b + 1 # change object in-place
...
>>> args = Namespace(a='old-value', b=99)
>>> func4(args)
>>> vars(args)
{'a': 'new-value', 'b': 100}
There’s almost never a good reason to get this complicated.
Your best choice is to return a tuple containing the multiple results.
Source and licence: Python 3.14.0 Programming FAQ — Python Software Foundation · PSF-2.0