mirror of
https://github.com/kennethreitz-archive/redis-docs.git
synced 2026-06-05 23:40:18 +00:00
Kenneth Reitz
32 lines
1.1 KiB
ReStructuredText
32 lines
1.1 KiB
ReStructuredText
`|Redis Documentation| <index.html>`_
|
||
**GetsetCommand: Contents**
|
||
`GETSET \_key\_ \_value\_ <#GETSET%20_key_%20_value_>`_
|
||
`Return value <#Return%20value>`_
|
||
`Design patterns <#Design%20patterns>`_
|
||
GetsetCommand
|
||
=============
|
||
|
||
#sidebar `StringCommandsSidebar <StringCommandsSidebar.html>`_
|
||
GETSET \_key\_ \_value\_
|
||
========================
|
||
|
||
*Time complexity: O(1)*
|
||
GETSET is an atomic *set this value and return the old value*
|
||
command.Set *key* to the string *value* and return the old value
|
||
stored at *key*.The string can't be longer than 1073741824 bytes (1
|
||
GB).
|
||
|
||
Return value
|
||
------------
|
||
|
||
`Bulk reply <ReplyTypes.html>`_
|
||
Design patterns
|
||
---------------
|
||
|
||
GETSET can be used together with INCR for counting with atomic
|
||
reset whena given condition arises. For example a process may call
|
||
INCR against thekey *mycounter* every time some event occurred, but
|
||
from time totime we need to get the value of the counter and reset
|
||
it to zero atomicallyusing ``GETSET mycounter 0``.
|
||
|
||
.. |Redis Documentation| image:: redis.png |