Redis字符串类型命令介绍(二)

谁借莪１个温暖的怀抱￠ 2022-06-12 12:38 186阅读 0赞

# 概述 #

Redis介绍和安装参考：[Redis介绍与安装][Redis]  
字符串类型是Redis中最基本的数据类型，它可以存储任何形式的字符串，包括二进制数据。  
上一篇介绍参考：[Redis字符串类型命令介绍(一)][Redis 1]

# 命令介绍 #

## incr命令 ##

语法：INCR key
    起始版本：1.0.0
    简述：将key存储的整型的值加1
    所属类型：string
    时间复杂度：O(1)

参数介绍：

*  key：需要进行加1操作的键

返回值：

*  进行增加操作后的值

说明：  
incr命令，对存储在指定key的整型数值进行加1操作。如果key不存在，在执行incr操作之前先将key的值设置为0。如果指定的key中存储的字符串类型值不能转换成一个整数，那么执行incr命令时将报错：`(error) ERR value is not an integer or out of range`。如果指定key存储的值不是字符串类型将报错：`(error) WRONGTYPE Operation against a key holding the wrong kind of value`。

注意：  
由于redis并没有一个明确的类型来表示整型数据，所以这个操作是一个字符串操作。执行这个操作的时候，key存储的字符串被解析成10进制的64位有符号整型数据。

示例参考：

127.0.0.1:6379> set num1 1        # 设置一个key，值为1
    OK
    127.0.0.1:6379> incr num1         # 对num1进行incr操作，返回增加后的值
    (integer) 2
    
    
    127.0.0.1:6379> incr num2         # key不存在时，先将key设置为0，然后在进行incr操作，返回操作后的值
    (integer) 1
    
    
    127.0.0.1:6379> set name sgl      # 设置一个key存储非整型的值
    OK
    127.0.0.1:6379> incr name         # 对存储非整型值的key进行incr操作，报错
    (error) ERR value is not an integer or out of range
    
    
    127.0.0.1:6379> lpush numbers 1   # 设置一个不是字符串类型的key
    (integer) 1
    127.0.0.1:6379> incr numbers      # 对非字符串类型的key进行incr操作，返回类型错误
    (error) WRONGTYPE Operation against a key holding the wrong kind of value

## decr命令 ##

语法：DECR key
    起始版本：1.0.0
    简述：将key存储的整型的值减1
    所属类型：string
    时间复杂度：O(1)

参数介绍：

*  key：需要进行减1操作的键

返回值：

*  进行减1操作后的值

说明：  
decr命令，对存储在指定key的整型数值进行减1操作，与incr命令相反。同样，如果key不存在，在执行decr操作之前先将key对应的值设置为0，然后再进行减1操作。  
如果指定的key中存储的字符串类型值不能转换成一个整数，那么执行decr命令时将报错：`(error) ERR value is not an integer or out of range`。如果指定key存储的值不是字符串类型将报错：`(error) WRONGTYPE Operation against a key holding the wrong kind of value`。

注意：  
decr操作最大支持在64位有符号的整型数字。

示例参考：

127.0.0.1:6379> set num 10           # 设置一个key，值为10
    OK
    127.0.0.1:6379> get num
    "10"
    127.0.0.1:6379> decr num             # 对num进行decr操作，返回操作后的值
    (integer) 9
    127.0.0.1:6379> get num
    "9"
    
    
    127.0.0.1:6379> get num1             # 对不存在的key进行decr操作，会先将key设置为0，然后再进行后续操作
    (nil)
    127.0.0.1:6379> decr num1
    (integer) -1
    
    
    
    127.0.0.1:6379> set name sgl         # 对非整型值的key进行操作，报错
    OK
    127.0.0.1:6379> decr name
    (error) ERR value is not an integer or out of range
    
    
    
    127.0.0.1:6379> lpush numbers 1      # 对非字符串型的key进行操作，报错
    (integer) 1
    127.0.0.1:6379> decr numbers
    (error) WRONGTYPE Operation against a key holding the wrong kind of value

## incrby命令 ##

语法：INCRBY key increment
    起始版本：1.0.0
    简述：将key存储的整型的值增加给定的数
    所属类型：string
    时间复杂度：O(1)

参数介绍：

*  key：需要进行操作的键
 *  increment：需要增加的大小，如果increment为负整数，就相当于减少，等同于decrby命令。

返回值：

*  进行增加操作后的值

说明：  
incrby命令和incr命令一样，只是增加的大小不是1，而是给定的值。如果key不存在，同样在操作前先将key的值设置为0。

注意：  
decr操作最大支持在64位有符号的整型数字。

示例参考：

127.0.0.1:6379> set num 1      # 设置一个key，值为1
    OK
    127.0.0.1:6379> incrby num 5   # 将num增加5，返回增加后的结果，即6
    (integer) 6
    
    
    127.0.0.1:6379> get num1       # 对不存在的key进行incrby,会先将key设置为0再操作
    (nil)
    127.0.0.1:6379> incrby num1 5
    (integer) 5
    
    
    127.0.0.1:6379> get num1
    "6"
    127.0.0.1:6379> incrby num -3  # 如果给定要增加的值为负整数，则相当于减少，等同于decrby命令
    (integer) 3
    
    
    127.0.0.1:6379> set name sgl
    OK
    127.0.0.1:6379> incrby name 2  # 如果key对应的值不是整数，则报错
    (error) ERR value is not an integer or out of range
    
    
    
    127.0.0.1:6379> lpush numbers 1  # 如果key对应的值不是字符串类型，则报错
    (integer) 1
    127.0.0.1:6379> incrby numbers 4
    (error) WRONGTYPE Operation against a key holding the wrong kind of value

## decrby命令 ##

语法：DECRBY key decrement
    起始版本：1.0.0
    简述：将key存储的整型的值减去给定的数
    所属类型：string
    时间复杂度：O(1)

参数介绍：

*  key：需要进行操作的键
 *  decrement：需要减少的数值大小，如果decrement为负整数，就相当于增加，等同于incrby命令。

返回值：

*  进行减少操作后的值

说明：  
decrby命令和decr命令一样，只是减少的大小不是1，而是给定的值。如果key不存在，同样在操作前先将key的值设置为0。

注意：  
decrby操作最大支持在64位有符号的整型数字。

示例参考：

127.0.0.1:6379> set num 10
    OK
    127.0.0.1:6379> decrby num 3   # 对num键进行减3操作，返回减3后的值
    (integer) 7
    
    
    127.0.0.1:6379> get num1 
    (nil)
    127.0.0.1:6379> decrby num1 2  # 对不存在的key进行减2操作，先将key设置为0，再进行后续操作
    (integer) -2
    
    
    127.0.0.1:6379> get num
    "7"
    127.0.0.1:6379> decrby num -5  # 如果给定的值为负数，则相当于增加，等同于incrby命令
    (integer) 12
    
    
    127.0.0.1:6379> set name sgl
    OK
    127.0.0.1:6379> decrby name 2  # 对存储非整型值的key进行decrby操作，将报错
    (error) ERR value is not an integer or out of range
    
    
    127.0.0.1:6379> lpush numbers 1
    (integer) 1
    127.0.0.1:6379> decrby numbers 2  # 对存储的非字符串类型的key进行decrby操作，将报错
    (error) WRONGTYPE Operation against a key holding the wrong kind of value
    
    
    127.0.0.1:6379> set floatnum 2.4   # 对存储的值为非整型或者减少的大小为非整型时，将报错
    OK
    127.0.0.1:6379> decrby floatnum 1.2
    (error) ERR value is not an integer or out of range
    127.0.0.1:6379> decrby floatnum 2
    (error) ERR value is not an integer or out of range

注：  
示例基于redis-3.2.9，centos6.9，Redis命令不区分大小写，示例中全部采用小写方式。  
参考资料：redis自带帮助文档、官方文档以及《Redis入门指南》等。

[Redis]: http://blog.csdn.net/gnail_oug/article/details/73206258
[Redis 1]: http://blog.csdn.net/gnail_oug/article/details/73350689