目录
String字符串
常见命令
SET
GET
MGET
MSET
SETNX
计数命令
INCR
INCRBY
DECR
DECRBY
INCRFLOAT
其它命令
APPEND
GETRANGE
SETRANGE
STRLEN
String字符串
字符串是Redis最基础的数据类型, 关于字符串需要特别注意: (1)首先Redis中所有的键的类型都是字符串类型, 而且其它几种数据结构也是在字符串类型的基础上构建的, 例如列表和集合的元素都是字符串类型, 所以字符串类型能为其它4种数据结构的学习奠定基础. (2)其次, 如图, 字符串类型的值实际可以是字符串, 包含一般格式的字符串类似JSON, XML格式的字符串; 数字, 可以是整型或者浮点型; 甚至是二进制数据, 例如图片, 音频等. 不过一个字符串的最大值不能超过512MB.
由于Redis内部存储的字符串完全是按照二进制流的形式保存的, 所以Redis是不处理字符集编码问题的, 客户端传入的命令中使用的是什么字符集编码, 就存储什么字符集编码.
常见命令
SET
将string类型的value设置到key中. 如果key之前存在, 则覆盖, 无论原来的数据类型是什么. 之前关于此key的TTL也全部失效.
语法:
SET key value [expiration EX seconds | PX milliseconds] [NX|XX]
命令有效版本: 1.0.0之后. 时间复杂度:O(1)
选项:
EX seconds: 使用秒为单位设置key的过期时间.
PX milliseconds: 使用毫秒为单位设置key的过期时间.
NX: 只在key不存在时才进行设置, 即如果key之前已经存在, 设置不执行.
XX: 旨在key存在时才进行设置, 即如果key之前不存在, 设置不执行.
注: 由于带选项的SET命令可以被SETNX, SETEX, PSETEX等命令代替, 所以之后版本中, Redis可能进行合并.
返回值:
如果设置成功, 则返回OK.
如果由于SET制定了NX或XX但条件不满足, SET不会执行, 并返回(nil).
示例:
GET
获取key对应的value. 如果key不存在, 返回nil. 如果value的数据类型不是string, 会报错.
语法:
GET key
命令有效版本: 1.0.0之后. 时间复杂度: O(1).
返回值: key对应的value, 或者nil当key不存在.
MGET
一次性获取多个key的值. 如果对应的key不存在或者对应的数据类型不是string, 返回nil.
语法:
MGET key [key...]
命令有效版本: 1.0.0之后. 时间复杂度: O(N) N是key的数量.
返回值: 对应value的列表.
示例:
MSET
一次性设置多个key的值.
语法:
MSET key value [key value...]
命令有效版本: 1.0.1之后. 时间复杂度: O(N) N是key的数量.
返回值: 永远是OK.
SETNX
设置key-value但只允许在key之前不存在的情况下.
语法:
SETEX key value
命令有效版本: 1.0.0之后 时间复杂度: O(1)
返回值: 1表示设置成功. 0表示没有设置.
示例:
计数命令
INCR
将key对应的string表示的数字加一. 如果key不存在, 则视为key对应的value是0. 如果key对应的string不是一个整型或者范围超过了64位有符号整型, 则报错.
语法:
INCR key
命令有效版本: 1.0.0之后 时间复杂度:O(1)
返回值: integer类型的加完后的数值.
示例:
INCRBY
将key对应的string表示的数字加上对应的值. 如果key不存在, 则视为key对应的value是0. 如果key对应的string不是一个整型或者范围超过了64位有符号整型, 则报错.
语法:
INCRBY key decrement
命令有效版本: 1.0.0之后. 时间复杂度: O(1)
返回值: integer类型加完后的数值.
示例:
DECR
将key对应的string表示的数字-1. 如果key不存在, 则视为key对应的value是0. 如果key对应的string不是一个整型或者范围超过了64位有符号整型, 则报错.
语法:
DECR key
命令有效版本: 1.0.0之后 时间复杂度: O(1)
返回值: integer类型减完后的值.
DECRBY
将key对应的string表示的数字减去对应的值. 如果key不存在, 则视为key对应的value是0. 如果key对应的string不是一个整型或者范围超过了64位有符号整型, 则报错.
语法:
DECRBY key decrement
命令有效版本: 1.0.0之后. 时间复杂度: O(1)
返回值: integer类型减完后的数值.
INCRFLOAT
将key对应的string表示的浮点数加上对应的值. 如果对应的值是负数, 则视为减去对应的值(因此没有DECRFLOAT). 如果key不存在, 则视为key对应的value是0. 如果key对应的不是string, 或者不是一个浮点数, 则报错. 允许采用科学计数法表示浮点数.
语法:
INCRBYFLOAT key increment
命令有效版本: 2.6.0之后 时间复杂度: O(1)
返回值: 加/减完后的数值.
示例:
很多存储系统和编程语言内部使用CAS机制实现计数功能, 会有一定的CPU开销, 但在Redis中完全不存在这个问题, 因为Redis是单线程架构, 任何命令到了Redis服务端都要顺序执行.
其它命令
APPEND
如果key已经存在并且一个是string, 命令会将value追加到原有string的后面. 如果key不存在, 则效果等同于SET命令.
语法:
APPEND KEY VALUE
命令有效版本: 2.0.0之后. 时间复杂度:O(1). 追加的字符串长度比较短, 可以视为O(1).
返回值: 追加完成之后string的长度.
示例:
GETRANGE
返回key对应的string的字串, 由start和end确定(左闭右闭) . 可以使用负数表示倒数. -1代表倒数第一个字符, -2表示倒数第二个. 0是正数开始. 超过范围的偏移量会根据string的长度调整成正确的值.
语法:
GETRANGE key start end
命令有效版本: 2.4.0之后. 时间复杂度: O(N) N为[start,end]长度. 由于string通常较短, 可视为O(1)
返回值: string类型的字串.
SETRANGE
覆盖字符串的一部分, 从指定的偏移开始.
语法:
SETRANGE key offset value
命令有效版本: 2.2.0之后. 时间复杂度: O(N), N为value的长度. 由于value一般较短, 可视为O(1)
返回值: 替换后string的长度.
示例:
STRLEN
获取key对应的string长度. 当key存放的类型不是string时, 报错.
语法:
STRLEN key
命令有效版本: 2.2.0之后. 时间复杂度:O(1)
返回值: string的长度. 或者当key不存在时, 返回0.