Redis SETNX 命令

发表于2023-06-04|更新于2024-12-04|Redis教程

|浏览量:

从 Redis 2.6.12 版本开始，此命令被标记为已废弃。
在迁移或编写新的代码时，可以使用带有 NX 参数的 SET 命令替代。

语法

1	SETNX key value

可用版本

≥ 1.0.0

时间复杂度

$O(1)$

ACL类别

@write, @string, @fast

如果 key 不存在，则将 key 设置为保存字符串值。在这种情况下，它等于 SET。当 key 已经存在时，则不执行任何操作。

SETNX 是 “SET if Not eXists” 的缩写。

返回值

返回一个整数：

如果 key 被成功设置，则返回 1；
如果 key 没被设置，则返回 0

示例

redis> SETNX john "JOHNSON"
(integer) 1
redis> SETNX john "JOHNSON LIN"
(integer) 0
redis> GET john
"JOHNSON"

（END）

文章作者: Johnson Lin

文章链接: http://linjiangxiong.com/2023/06/04/redis-cmd-strings-setnx/

版权声明: 本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 Johnson Lin！

相关推荐

Redis STRLEN 命令

语法1STRLEN key 可用版本 ≥ 2.2.0 时间复杂度 $O(1)$ ACL类别 @read, @string, @fast 返回存储在 key 处的字符串值的长度。当 key 存储的值不是字符串类型时，则返回错误。返回值返回一个整数： key 对应值的字符串长度；如果 key 不存在，则返回 0。示例 1返回键 user 存储的字符串的长度： 1234redis> SET user "JOHNSON LIN"OKredis> STRLEN user(integer) 11 示例 2键 nonexisting 不存在，STRLEN 操作返回 0： 1234redis> EXISTS nonexisting(integer) 0redis> STRLEN nonexisting(integer) 0 示例 3键 listkey 存储的值不是字符串类型，STRLEN 操作返回错误： 123456redis> RPUSH listkey "JOHNSON LIN"(integer) 1redis...

Redis Set SISMEMBER Command

The Redis SISMEMBER command checks if a given element is a member of the set. SyntaxThe basic syntax of the SISMEMBER command is as follows: 1SISMEMBER key member It returns if member is a member of the set stored at key. Available SinceRedis version >= 1.0.0 Time ComplexityO(1) ACL Categories@read, @set, @fast Return Value 0 if the element is not a member of the set, or when the key does not exist. 1 if the element is a member of the set. Example123456127.0.0.1:6379> SADD key1 a b c d...

Redis Set SINTERSTORE Command

The Redis SINTERSTORE command stores the intersection of the specified sets in a given destination set. If the destination set already exists, it will be overwritten. SyntaxThe basic syntax of the SINTERSTORE command is as follows: 1SINTERSTORE destination key [key ...] This command is equal to SINTER, but instead of returning the resulting set, it is stored in destination. If destination already exists, it is overwritten. Available SinceRedis version >= 1.0.0 Time ComplexityO(N*M) worst c...

Redis INCR 命令

语法1INCR key 可用版本 ≥ 1.0.0 时间复杂度 $O(1)$ ACL 类别 @write, @string, @fast 将存储在键上的数字值增加 1。如果键不存在，在执行操作前先将其设置为 0。如果键包含一个错误类型的值，或者包含一个不能表示为整数的字符串，则返回一个错误。该操作仅限于 64 位有符号的整数。注意：这是一个字符串操作，因为 Redis 没有专门的整数类型。存储在键中的字符串被解释为以 10 为基数的 64 位带符号整数以执行操作。 Redis 以其整数表示法存储整数，因此对于实际包含整数的字符串值，存储整数的字符串表示法没有开销。返回值返回一个整数，表示执行 DECR 操作后，key 对应的值。模式：计数器使用 Redis 原子增量操作可以做的最简单的事情就是计数器模式。其思想就是每次操作发生时向 Redis 发送 INCR 命令。例如，在 Web 应用程序中，我们可能想要知道某个用户每天访问了多少页面。为此，Web 应用程序可以在用户每次浏览页面时，简单地递增一个键——通过将用户 ID 和表示当前日期的字符串连接来创建键名。这个简单的模...

Redis Set SADD Command

The Redis SADD command adds one or more member elements to a set. If an element already exists in the set, it will be ignored. If the set key does not exist, a new set is created with the added elements as its members. If the key is not of the set type, an error is returned. Note: In Redis version 2.4 and earlier, the SADD command only accepts a single member value. SyntaxThe basic syntax of the SADD command is as follows: 1SADD key member [member ...] Available SinceRedis version >= 1.0.0...

Redis MGET 命令

语法1MGET key [key ...] 可用版本 ≥ 1.0.0 时间复杂度 $O(N)$ 其中 N 是要检索的 key 的数量。 ACL类别 @read, @string, @fast 返回所有指定 key 的值。对于每个不持有字符串值或不存在的键，将返回特殊值 nil。正因为如此，该操作永远不会失败。返回值返回一个数组，元素由所有给定的 key 上的值组成。示例12345678redis> SET key1 "Hello""OK"redis> SET key2 "World""OK"redis> MGET key1 key2 nonexisting1) "Hello"2) "World"3) (nil) （END）