Commit 804a6db8 authored by Adrian Holovaty's avatar Adrian Holovaty
Browse files

Added a bit to 'Saving ManyToMany Fields' explicitly explaining how to add... 

Added a bit to 'Saving ManyToMany Fields' explicitly explaining how to add multiple relations in one statement

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16689 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent 5eeb2d56

docs/topics/db/queries.txt

+9 −0
Original line number Diff line number Diff line
@@ -113,6 +113,15 @@ method on the field to add a record to the relation. This example adds the 
    >>> joe = Author.objects.create(name="Joe")

    >>> entry.authors.add(joe)



To add multiple records to a ``ManyToManyField`` in one go, include multiple

arguments in the call to ``add()``, like this::



    >>> john = Author.objects.create(name="John")

    >>> paul = Author.objects.create(name="Paul")

    >>> george = Author.objects.create(name="George")

    >>> ringo = Author.objects.create(name="Ringo")

    >>> entry.authors.add(john, paul, george, ringo)



Django will complain if you try to assign or add an object of the wrong type.



Retrieving objects