sorted

Return a new list sorted from smallest to largest. Items with equal comparison values keep their original order, even with reverse=True.

Syntax

sorted(iterable, /, *, key=None, reverse=False)

Parameters

NameDescription
iterableString | list | tuple | dict | set
A value whose items can be read one at a time, such as a list or string. For dict, sort keys.
Required · Positional only
No default
keyCallable?
A function called with each item; compare its result instead of the item. None compares items directly.
Optional · Keyword only
Default: None
reverseBoolean
Sort descending when True.
Optional · Keyword only
Default: False

Returns

list — A new sorted list. The input value is not modified.

Example

values = sorted([3, 1, 2])
text(str(values))