[1.9.x] Fixed #25132 -- Documented how to retrieve a single value using values_list() and get().

Backport of 4373eac998 from master
This commit is contained in:
Alex Morozov 2015-11-02 15:42:43 +03:00 committed by Tim Graham
parent a3bbc38d54
commit ecb3e314cb
1 changed files with 6 additions and 0 deletions

View File

@ -641,6 +641,12 @@ It is an error to pass in ``flat`` when there is more than one field.
If you don't pass any values to ``values_list()``, it will return all the
fields in the model, in the order they were declared.
A common need is to get a specific field value of a certain model instance. To
achieve that, use ``values_list()`` followed by a ``get()`` call::
>>> Entry.objects.values_list('headline', flat=True).get(pk=1)
'First entry'
dates
~~~~~