mirror of
https://github.com/django/django.git
synced 2025-10-24 06:06:09 +00:00
Fixed #19173 -- Made EmptyQuerySet a marker class only
The guarantee that no queries will be made when accessing results is done by new EmptyWhere class which is used for query.where and having. Thanks to Simon Charette for reviewing and valuable suggestions.
This commit is contained in:
@@ -593,15 +593,17 @@ none
|
||||
|
||||
.. method:: none()
|
||||
|
||||
Returns an ``EmptyQuerySet`` — a ``QuerySet`` subclass that always evaluates to
|
||||
an empty list. This can be used in cases where you know that you should return
|
||||
an empty result set and your caller is expecting a ``QuerySet`` object (instead
|
||||
of returning an empty list, for example.)
|
||||
Calling none() will create a queryset that never returns any objects and no
|
||||
query will be executed when accessing the results. A qs.none() queryset
|
||||
is an instance of ``EmptyQuerySet``.
|
||||
|
||||
Examples::
|
||||
|
||||
>>> Entry.objects.none()
|
||||
[]
|
||||
>>> from django.db.models.query import EmptyQuerySet
|
||||
>>> isinstance(Entry.objects.none(), EmptyQuerySet)
|
||||
True
|
||||
|
||||
all
|
||||
~~~
|
||||
|
||||
@@ -31,6 +31,11 @@ Minor features
|
||||
Backwards incompatible changes in 1.6
|
||||
=====================================
|
||||
|
||||
* The ``django.db.models.query.EmptyQuerySet`` can't be instantiated any more -
|
||||
it is only usable as a marker class for checking if
|
||||
:meth:`~django.db.models.query.QuerySet.none` has been called:
|
||||
``isinstance(qs.none(), EmptyQuerySet)``
|
||||
|
||||
.. warning::
|
||||
|
||||
In addition to the changes outlined in this section, be sure to review the
|
||||
|
||||
Reference in New Issue
Block a user