p15693087
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Documented in_bulk behavior with nonexistent id_list items. 

Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
This commit is contained in:
Claude Paroz 2021-05-17 09:19:18 +02:00 committed by Carlton Gibson
parent 6a5ef557f8
commit 7309393c3a
1 changed files with 4 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/ref/models/querysets.txt
View File

@ -2294,7 +2294,10 @@ database query like ``count()`` would.
Takes a list of field values (``id_list``) and the ``field_name`` for those
values, and returns a dictionary mapping each value to an instance of the
object with the given field value. If ``id_list`` isn't provided, all objects
object with the given field value. No
:exc:`django.core.exceptions.ObjectDoesNotExist` exceptions will ever be raised
by ``in_bulk``; that is, any ``id_list`` value not matching any instance will
simply be ignored. If ``id_list`` isn't provided, all objects
in the queryset are returned. ``field_name`` must be a unique field or a
distinct field (if there's only one field specified in :meth:`distinct`).
``field_name`` defaults to the primary key.