Add MSETEX command by StavRLevi · Pull Request #14434 · redis/redis (original) (raw)

Introduce a new command MSETEX to set multiple string keys with a shared expiration in a single atomic operation. Also with flexible argument parsing.

Syntax:
MSETEX numkeys key value [key value …] [XX | NX] [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | KEEPTTL]

Sets the given keys to their respective values.
This command is an extension of the MSETNX that adds expiration and XX options.

Options:
EX seconds - Set the specified expiration time, in seconds
PX milliseconds - Set the specified expiration time, in milliseconds
EXAT timestamp-seconds - Set the specified Unix time at which the keys will expire, in seconds
PXAT timestamp-milliseconds - Set the specified Unix time at which the keys will expire, in milliseconds
KEEPTTL - Retain the time to live associated with the keys
XX - Only set the keys and their expiration if all already exist
NX - Only set the keys and their expiration if none exist

Flexible Argument Parsing examples:

• MSETEX 2 k1 v1 k2 v2 EX 10
• MSETEX 2 k1 v1 k2 v2 NX PX 5000
• MSETEX 2 k1 v1 k2 v2 NX EX 10

Return Values:
Integer reply: 1 - All keys were set successfully
Integer reply: 0 - No keys were set (due to NX/XX conditions)
Error reply - Syntax error or invalid arguments