mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-05-04 22:17:34 +00:00
Code Issues 32 Releases Wiki Activity

Fixed ReST error in docs/db-api.txt

Browse Source 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@3567 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2006-08-12 05:31:31 +00:00
parent 54ea309a1d
commit aa587cd977
1 changed files with 11 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/db-api.txt
View File

@ -718,12 +718,12 @@ The ``DoesNotExist`` exception inherits from
A convenience method for creating an object and saving it all in one step. Thus:: A convenience method for creating an object and saving it all in one step. Thus::
p = Person.objects.create(first_name="Bruce", last_name="Springsteen") p = Person.objects.create(first_name="Bruce", last_name="Springsteen")
and:: and::
p = Person(first_name="Bruce", last_name="Springsteen") p = Person(first_name="Bruce", last_name="Springsteen")
p.save() p.save()
are equivalent. are equivalent.
``get_or_create(**kwargs)`` ``get_or_create(**kwargs)``
@ -1471,11 +1471,12 @@ the ``ForeignKey`` ``Manager`` has these additional methods:
b.entry_set.remove(e) # Disassociates Entry e from Blog b. b.entry_set.remove(e) # Disassociates Entry e from Blog b.
In order to prevent database inconsistency, this method only exists on In order to prevent database inconsistency, this method only exists on
``ForeignKey``s where ``null=True``. If the related field can't be set to ``ForeignKey`` objects where ``null=True``. If the related field can't be
``None`` (``NULL``), then an object can't be removed from a relation set to ``None`` (``NULL``), then an object can't be removed from a
without being added to another. In the above example, removing ``e`` from relation without being added to another. In the above example, removing
``b.entry_set()`` is equivalent to doing ``e.blog = None``, and because ``e`` from ``b.entry_set()`` is equivalent to doing ``e.blog = None``,
the ``blog`` ``ForeignKey`` doesn't have ``null=True``, this is invalid. and because the ``blog`` ``ForeignKey`` doesn't have ``null=True``, this
is invalid.
* ``clear()``: Removes all objects from the related object set. * ``clear()``: Removes all objects from the related object set.
@ -1559,13 +1560,13 @@ Queries over related objects
---------------------------- ----------------------------
Queries involving related objects follow the same rules as queries involving 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 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 may use either an object instance itself, or the primary key value for the
object. object.
For example, if you have a Blog object ``b`` with ``id=5``, the following For example, if you have a Blog object ``b`` with ``id=5``, the following
three queries would be identical:: three queries would be identical::
Entry.objects.filter(blog=b) # Query using object instance Entry.objects.filter(blog=b) # Query using object instance
Entry.objects.filter(blog=b.id) # Query using id from instance Entry.objects.filter(blog=b.id) # Query using id from instance
Entry.objects.filter(blog=5) # Query using id directly Entry.objects.filter(blog=5) # Query using id directly