pub/mongoengine
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated docs to clarify or != | (##288)

Browse Source
This commit is contained in:
Ross Lawley 2013-04-24 11:17:21 +00:00
parent 9bd8b3e9a5
commit c59ea26845
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/guide/querying.rst
View File

@ -392,6 +392,7 @@ You can also turn off all dereferencing for a fixed period by using the
Advanced queries Advanced queries
================ ================
Sometimes calling a :class:`~mongoengine.queryset.QuerySet` object with keyword Sometimes calling a :class:`~mongoengine.queryset.QuerySet` object with keyword
arguments can't fully express the query you want to use -- for example if you arguments can't fully express the query you want to use -- for example if you
need to combine a number of constraints using *and* and *or*. This is made need to combine a number of constraints using *and* and *or*. This is made
@ -410,6 +411,11 @@ calling it with keyword arguments::
# Get top posts # Get top posts
Post.objects((Q(featured=True) & Q(hits__gte=1000)) | Q(hits__gte=5000)) Post.objects((Q(featured=True) & Q(hits__gte=1000)) | Q(hits__gte=5000))
.. warning:: You have to use bitwise operators. You cannot use ``or``, ``and``
to combine queries as ``Q(a=a) or Q(b=b)`` is not the same as
``Q(a=a) | Q(b=b)``. As ``Q(a=a)`` equates to true ``Q(a=a) or Q(b=b)`` is
the same as ``Q(a=a)``.
.. _guide-atomic-updates: .. _guide-atomic-updates:
Atomic updates Atomic updates