diff options
| author | Irindu Indeera <nbiindeera@gmail.com> | 2017-07-11 23:45:17 +0530 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2017-07-11 14:15:17 -0400 |
| commit | babe9e64a6172b09e7f70e8d8f01e67f2cb4176d (patch) | |
| tree | ced2a814190c746f21847d0cafc6286694eb6bbb /docs/ref | |
| parent | f816ceedf1ae13bec22363f6d78de53d3f60c3e9 (diff) | |
Fixed #28352 -- Corrected QuerySet.values_list() return type in docs examples.
Diffstat (limited to 'docs/ref')
| -rw-r--r-- | docs/ref/models/conditional-expressions.txt | 8 | ||||
| -rw-r--r-- | docs/ref/models/querysets.txt | 10 |
2 files changed, 9 insertions, 9 deletions
diff --git a/docs/ref/models/conditional-expressions.txt b/docs/ref/models/conditional-expressions.txt index 4331d1185e..af134d4561 100644 --- a/docs/ref/models/conditional-expressions.txt +++ b/docs/ref/models/conditional-expressions.txt @@ -110,7 +110,7 @@ A simple example:: ... output_field=CharField(), ... ), ... ).values_list('name', 'discount') - [('Jane Doe', '0%'), ('James Smith', '5%'), ('Jack Black', '10%')] + <QuerySet [('Jane Doe', '0%'), ('James Smith', '5%'), ('Jack Black', '10%')]> ``Case()`` accepts any number of ``When()`` objects as individual arguments. Other options are provided using keyword arguments. If none of the conditions @@ -132,7 +132,7 @@ the ``Client`` has been with us, we could do so using lookups:: ... output_field=CharField(), ... ) ... ).values_list('name', 'discount') - [('Jane Doe', '5%'), ('James Smith', '0%'), ('Jack Black', '10%')] + <QuerySet [('Jane Doe', '5%'), ('James Smith', '0%'), ('Jack Black', '10%')]> .. note:: @@ -153,7 +153,7 @@ registered more than a year ago:: ... When(account_type=Client.PLATINUM, then=a_year_ago), ... ), ... ).values_list('name', 'account_type') - [('Jack Black', 'P')] + <QuerySet [('Jack Black', 'P')]> Advanced queries ================ @@ -182,7 +182,7 @@ their registration dates. We can do this using a conditional expression and the ... ), ... ) >>> Client.objects.values_list('name', 'account_type') - [('Jane Doe', 'G'), ('James Smith', 'R'), ('Jack Black', 'P')] + <QuerySet [('Jane Doe', 'G'), ('James Smith', 'R'), ('Jack Black', 'P')]> Conditional aggregation ----------------------- diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index d8d063a7a5..64e48c3ff5 100644 --- a/docs/ref/models/querysets.txt +++ b/docs/ref/models/querysets.txt @@ -634,20 +634,20 @@ respective field or expression passed into the ``values_list()`` call — so the first item is the first field, etc. For example:: >>> Entry.objects.values_list('id', 'headline') - [(1, 'First entry'), ...] + <QuerySet [(1, 'First entry'), ...]> >>> from django.db.models.functions import Lower >>> Entry.objects.values_list('id', Lower('headline')) - [(1, 'first entry'), ...] + <QuerySet [(1, 'first entry'), ...]> If you only pass in a single field, you can also pass in the ``flat`` parameter. If ``True``, this will mean the returned results are single values, rather than one-tuples. An example should make the difference clearer:: >>> Entry.objects.values_list('id').order_by('id') - [(1,), (2,), (3,), ...] + <QuerySet[(1,), (2,), (3,), ...]> >>> Entry.objects.values_list('id', flat=True).order_by('id') - [1, 2, 3, ...] + <QuerySet [1, 2, 3, ...]> It is an error to pass in ``flat`` when there is more than one field. @@ -682,7 +682,7 @@ Similarly, when querying a reverse foreign key, ``None`` appears for entries not having any author:: >>> Entry.objects.values_list('authors') - [('Noam Chomsky',), ('George Orwell',), (None,)] + <QuerySet [('Noam Chomsky',), ('George Orwell',), (None,)]> .. versionchanged:: 1.11 |
