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

Edited docs and docstring changes from [6572] (new cache add() method) 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@6774 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2007-11-30 05:30:43 +00:00
parent 7ea174ef14
commit 9e762f4407
2 changed files with 9 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
django/core/cache/backends/base.py vendored
View File

@ -64,4 +64,3 @@ class BaseCache(object):
return self.get(key) is not None return self.get(key) is not None
__contains__ = has_key __contains__ = has_key

8
docs/cache.txt
View File

@ -370,16 +370,16 @@ get() can take a ``default`` argument::
>>> cache.get('my_key', 'has expired') >>> cache.get('my_key', 'has expired')
'has expired' 'has expired'
To add a key only if it doesn't already exist, there is an add() method. It **New in Django development version:** To add a key only if it doesn't already
takes the same parameters as set(), but will not attempt to update the cache exist, use the ``add()`` method. It takes the same parameters as ``set()``, but
if the key specified is already present:: it will not attempt to update the cache if the key specified is already present::
>>> cache.set('add_key', 'Initial value') >>> cache.set('add_key', 'Initial value')
>>> cache.add('add_key', 'New value') >>> cache.add('add_key', 'New value')
>>> cache.get('add_key') >>> cache.get('add_key')
'Initial value' 'Initial value'
There's also a get_many() interface that only hits the cache once. get_many() There's also a ``get_many()`` interface that only hits the cache once. ``get_many()``
returns a dictionary with all the keys you asked for that actually exist in the returns a dictionary with all the keys you asked for that actually exist in the
cache (and haven't expired):: cache (and haven't expired)::