Browse files

Refs #2217 -- Updated DB API docs to discuss filtering using objects …

…rather than IDs. Second attempt - forgot to save before commit last time.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 8818939 commit c431ade5f5a98fca990a3996be7f7707a31df858 @freakboy3742 freakboy3742 committed Jul 9, 2006
Showing with 11 additions and 5 deletions.
  1. +11 −5 docs/db-api.txt
@@ -1555,11 +1555,17 @@ of ``INSTALLED_APPS`` is to tell Django the entire model domain.
Queries over related objects
-When specifying a query over a related object, you have the option of
- b = Blog.objects.get(id=5)
- e1 = Entry.objects.filter()
+Queries involving related objects follow the same rules as queries involving
+normal value fields. When specifying the the value for a query to match, you
+may use either an object instance itself, or the primary key value for the
+For example, if you have a Blog object ``b`` with ``id=5``, the following
+three queries would be identical::
+ Entry.objects.filter(blog=b) # Query using object instance
+ Entry.objects.filter( # Query using id from instance
+ Entry.objects.filter(blog=5) # Query using id directly
Deleting objects

0 comments on commit c431ade

Please sign in to comment.