From 676636ac8f2fa612d68045dd747df7bf2bf8da99 Mon Sep 17 00:00:00 2001 From: Alex Morozov Date: Mon, 2 Nov 2015 15:42:43 +0300 Subject: [PATCH] [1.8.x] Fixed #25132 -- Documented how to retrieve a single value using values_list() and get(). Backport of 4373eac99828d99718a7b245d160e7e64fce2e95 from master --- docs/ref/models/querysets.txt | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index e6b855372a..1971964c0f 100644 --- a/docs/ref/models/querysets.txt +++ b/docs/ref/models/querysets.txt @@ -655,6 +655,12 @@ like a list. Most of the time this is enough, but if you require an actual Python list object, you can simply call ``list()`` on it, which will evaluate the queryset. +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 ~~~~~