test0908
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

added documentation for the query kwargs introduced by [1534] 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@1536 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Georg Bauer 2005-12-04 14:04:56 +00:00
parent 7dbff908b5
commit 4ed3d57184
1 changed files with 45 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/db-api.txt
View File

@ -152,9 +152,9 @@ translates (roughly) into the following SQL::
The DB API supports the following lookup types: The DB API supports the following lookup types:
=========== ============================================================== ============= ==============================================================
Type Description Type Description
=========== ============================================================== ============= ==============================================================
exact Exact match: ``polls.get_object(id__exact=14)``. exact Exact match: ``polls.get_object(id__exact=14)``.
iexact Case-insensitive exact match: iexact Case-insensitive exact match:
``polls.get_list(slug__iexact="foo")`` matches a slug of ``polls.get_list(slug__iexact="foo")`` matches a slug of
@ -164,7 +164,9 @@ The DB API supports the following lookup types:
that contain "spam" in the question. (PostgreSQL and MySQL that contain "spam" in the question. (PostgreSQL and MySQL
only. SQLite doesn't support case-sensitive LIKE statements; only. SQLite doesn't support case-sensitive LIKE statements;
``contains`` will act like ``icontains`` for SQLite.) ``contains`` will act like ``icontains`` for SQLite.)
notcontains negated ``contains``
icontains Case-insensitive containment test. icontains Case-insensitive containment test.
inotcontains negated ``icontains``
gt Greater than: ``polls.get_list(id__gt=4)``. gt Greater than: ``polls.get_list(id__gt=4)``.
gte Greater than or equal to. gte Greater than or equal to.
lt Less than. lt Less than.
@ -177,9 +179,13 @@ The DB API supports the following lookup types:
and MySQL only. SQLite doesn't support case-sensitive LIKE and MySQL only. SQLite doesn't support case-sensitive LIKE
statements; ``startswith`` will act like ``istartswith`` for statements; ``startswith`` will act like ``istartswith`` for
SQLite.) SQLite.)
notstartswith negated ``startswith``
endswith Case-sensitive ends-with. (PostgreSQL and MySQL only.) endswith Case-sensitive ends-with. (PostgreSQL and MySQL only.)
notendswith negated ``endswith``
istartswith Case-insensitive starts-with. istartswith Case-insensitive starts-with.
inotstartswith negated ``istartswith``
iendswith Case-insensitive ends-with. iendswith Case-insensitive ends-with.
inotendswith negated ``iendswith``
range Range test: range Range test:
``polls.get_list(pub_date__range=(start_date, end_date))`` ``polls.get_list(pub_date__range=(start_date, end_date))``
returns all polls with a pub_date between ``start_date`` returns all polls with a pub_date between ``start_date``
@ -190,7 +196,7 @@ The DB API supports the following lookup types:
day For date/datetime fields, exact day match. day For date/datetime fields, exact day match.
isnull True/False; does is IF NULL/IF NOT NULL lookup: isnull True/False; does is IF NULL/IF NOT NULL lookup:
``polls.get_list(expire_date__isnull=True)``. ``polls.get_list(expire_date__isnull=True)``.
=========== ============================================================== ============= ==============================================================
Multiple lookups are allowed, of course, and are translated as "AND"s:: Multiple lookups are allowed, of course, and are translated as "AND"s::