summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorChristian Ledermann <christian.ledermann@gmail.com>2018-06-16 20:53:54 +0100
committerTim Graham <timograham@gmail.com>2018-06-16 15:53:54 -0400
commit11bfe3a83d79c832bd861b6b87f254197fde1659 (patch)
tree3a438cb925bd99a3380bddf26681730933396c59 /docs/ref
parent78972af367a1da54aa7e539e4b1ffa2b56571e77 (diff)
Refs #29493 -- Doc'd that the QuerySet in lookup accepts a string.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/models/querysets.txt9
1 files changed, 6 insertions, 3 deletions
diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt
index 06f153fb8e..bae2c33a1d 100644
--- a/docs/ref/models/querysets.txt
+++ b/docs/ref/models/querysets.txt
@@ -2622,15 +2622,18 @@ SQL equivalent::
``in``
~~~~~~
-In a given iterable; often a list, tuple, or queryset.
+In a given iterable; often a list, tuple, or queryset. It's not a common use
+case, but strings (being iterables) are accepted.
-Example::
+Examples::
Entry.objects.filter(id__in=[1, 3, 4])
+ Entry.objects.filter(headline__in='abc')
-SQL equivalent::
+SQL equivalents::
SELECT ... WHERE id IN (1, 3, 4);
+ SELECT ... WHERE headline IN ('a', 'b', 'c');
You can also use a queryset to dynamically evaluate the list of values
instead of providing a list of literal values::