Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Simplified example in 'Limiting QuerySets' section of docs/db-api.txt.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@2855 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 862328a98f63febb501a6ebb5d09c2db0574b53d 1 parent 4bc4aa2
@adrianholovaty adrianholovaty authored
Showing with 11 additions and 4 deletions.
  1. +11 −4 docs/db-api.txt
View
15 docs/db-api.txt
@@ -335,11 +335,18 @@ return a list of every *second* object of the first 10::
Entry.objects.all()[:10:2]
To retrieve a *single* object rather than a list
-(e.g. ``SELECT foo FROM bar LIMIT 1``), slice the ``QuerySet`` to ``[:1]`` and
-call ``get()`` on that. For example, this returns the first ``Entry`` in the
-database, after ordering entries alphabetically by headline::
+(e.g. ``SELECT foo FROM bar LIMIT 1``), using a simple index instead of a
+slice. For example, this returns the first ``Entry`` in the database, after
+ordering entries alphabetically by headline::
- Entry.objects.order_by('headline')[:1].get()
+ Entry.objects.order_by('headline')[0]
+
+This is equivalent to::
+
+ Entry.objects.order_by('headline')[0:1].get()
+
+Note that either of these two examples will raise ``DoesNotExist`` if no
+objects match the given criteria.
QuerySet methods that return new QuerySets
------------------------------------------
Please sign in to comment.
Something went wrong with that request. Please try again.