From 3c72a46f621d04189b48aba678e45fe3d23df5cb Mon Sep 17 00:00:00 2001 From: Luke Plant Date: Sat, 6 May 2006 22:55:30 +0000 Subject: [PATCH] Updated docs regarding QuerySet slicing and IndexError, in line with r2859 git-svn-id: http://code.djangoproject.com/svn/django/trunk@2862 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/db-api.txt | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/db-api.txt b/docs/db-api.txt index c2078120819..e3303ea5760 100644 --- a/docs/db-api.txt +++ b/docs/db-api.txt @@ -335,18 +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``), using a simple index instead of a +(e.g. ``SELECT foo FROM bar LIMIT 1``), use 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')[0] -This is equivalent to:: +This is roughly 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. +Note, however, that the first of these will raise ``IndexError`` while the +second will raise ``DoesNotExist`` if no objects match the given criteria. QuerySet methods that return new QuerySets ------------------------------------------