summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMarc Tamlyn <marc.tamlyn@gmail.com>2015-05-30 21:22:36 +0100
committerMarc Tamlyn <marc.tamlyn@gmail.com>2015-05-30 21:39:45 +0100
commit74fe4428e51030cbed768083489f0497f4453c17 (patch)
treec5e4c483897bb0ab6f4a61b287329e84fbbbfcc8 /docs
parent38eacbde62cd83ffaa64db7719c2c643f69551e0 (diff)
Add HasAnyKeys lookup for HStoreField.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/contrib/postgres/fields.txt17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/ref/contrib/postgres/fields.txt b/docs/ref/contrib/postgres/fields.txt
index 235dbc9079..5313ac4092 100644
--- a/docs/ref/contrib/postgres/fields.txt
+++ b/docs/ref/contrib/postgres/fields.txt
@@ -385,6 +385,23 @@ Returns objects where the given key is in the data. Uses the SQL operator
>>> Dog.objects.filter(data__has_key='owner')
[<Dog: Meg>]
+.. fieldlookup:: hstorefield.has_any_keys
+
+has_any_keys
+~~~~~~~~~~~~
+
+.. versionadded:: 1.9
+
+Returns objects where any of the given keys are in the data. Uses the SQL
+operator ``?|``. For example::
+
+ >>> Dog.objects.create(name='Rufus', data={'breed': 'labrador'})
+ >>> Dog.objects.create(name='Meg', data={'owner': 'Bob'})
+ >>> Dog.objects.create(name='Fred', data={})
+
+ >>> Dog.objects.filter(data__has_any_keys=['owner', 'breed'])
+ [<Dog: Rufus>, <Dog: Meg>]
+
.. fieldlookup:: hstorefield.has_keys
has_keys