min
ReQL command: min
Command syntax
sequence.min(field | function) → element sequence.min(index=<indexname>) → element r.min(sequence, field | function) → element r.min(sequence, index=<indexname>) → element
Description
Finds the minimum element of a sequence.
The min
command can be called with:
- a field name, to return the element of the sequence with the smallest value in that field;
- an index (the primary key or a secondary index), to return the element of the sequence with the smallest value in that index;
- a function, to apply the function to every element within the sequence and return the element which returns the smallest value from the function, ignoring any elements where the function produces a non-existence error.
For more information on RethinkDB’s sorting order, read the section in ReQL data types.
Calling min
on an empty sequence will throw a non-existence error; this can be handled using the default command.
Example: Return the minimum value in the list [3, 5, 7]
.
r.expr([3, 5, 7]).min().run(conn)
Example: Return the user who has scored the fewest points.
r.table('users').min('points').run(conn)
Example: The same as above, but using a secondary index on the points
field.
r.table('users').min(index='points').run(conn)
Example: Return the user who has scored the fewest points, adding in bonus points from a separate field using a function.
r.table('users').min(lambda user: user['points'] + user['bonus_points'] ).run(conn)
Example: Return the smallest number of points any user has ever scored. This returns the value of that points
field, not a document.
r.table('users').min('points')['points'].run(conn)
Example: Return the user who has scored the fewest points, but add a default None
return value to prevent an error if no user has ever scored points.
r.table('users').min('points').default(None).run(conn)
Related commands
Get more help
Couldn't find what you were looking for?
- Ask a question on Stack Overflow
- Chat with us and our community on Slack
- Talk to the team on IRC on #rethinkdb@freenode.net — via Webchat
- Ping @rethinkdb on Twitter
- Post an issue on the documentation issue tracker on GitHub
© RethinkDB contributors
Licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License.
https://rethinkdb.com/api/python/min/