您的位置:首页 > 数据库 > Redis

Redis缓存命令整理—String字符串操作命令

2017-04-28 10:40 190 查看
String字符串操作命令

APPEND:APPEND key value
描述:如果key 已经存在并且是一个字符串,APPEND
命令将 value 追加到
key 原来的值的末尾。
如果
key 不存在,
APPEND 就简单地将给定
key 设为 value ,就像执行
SET key value 一样。

返回值:追加
value 之后, key 中字符串的长度。

BITCOUNT:BITCOUNT key [start] [end]
描述:计算给定字符串中,被设置为1 的比特位的数量。一般情况下,给定的整个字符串都会被进行计数,通过指定额外的start 或end
参数,可以让计数只在特定的位上进行。start 和end 参数的设置和

GETRANGE 命令类似,都可以使用负数值:比如-1 表示最后一个位,而-2 表示倒数第二个位,以此类推。不存在的
key 被当成是空字符串来处理,因此对一个不存在的key 进行BITCOUNT 操作,结果为
0 。

返回值:被设置为
1 的位的数量。

BITOP:BITOP operation destkey key [key ...]
描述:对一个或多个保存二进制位的字符串key 进行位元操作,并将结果保存到destkey 上。
operation 可以是AND 、OR 、
NOT 、
XOR 这四种操作中的任意一种:

BITOP AND destkey key [key ...] ,对一个或多个key 求逻辑并,并将结果保存到destkey


BITOP OR destkey key [key ...] ,对一个或多个key 求逻辑或,并将结果保存到destkey


BITOP XOR destkey key [key ...] ,对一个或多个key 求逻辑异或,并将结果保存到destkey


BITOP NOT destkey key ,对给定key 求逻辑非,并将结果保存到destkey


除了
NOT 操作之外,其他操作都可以接受一个或多个 key 作为输入。
处理不同长度的字符串

BITOP 处理不同长度的字符串时,较短的那个字符串所缺少的部分会被看作0 。空的key 也被看作是包含
0 的字符串序列。

返回值:保存到
destkey 的字符串的长度,和输入 key 中最长的字符串长度相等。

DECR:DECR key
描述:将key 中储存的数字值减一。
如果
key 不存在,那么 key 的值会先被初始化为
0 ,然后再执行
DECR 操作。
如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。
关于递增(increment) / 递减(decrement)操作的更多信息,请参见INCR
命令。

返回值:执行
DECR 命令之后
key 的值。

DECRBY:DECRBY key decrement
描述:将key 所储存的值减去减量decrement 。
如果
key 不存在,那么 key 的值会先被初始化为
0 ,然后再执行
DECRBY 操作。
如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。
关于更多递增(increment) / 递减(decrement)操作的更多信息,请参见INCR
命令。

返回值:减去
decrement 之后, key 的值。

GET:GET key
描述:返回key 所关联的字符串值。
如果
key 不存在那么返回特殊值 nil 。
假如
key 储存的值不是字符串类型,返回一个错误,因为
GET 只能用于处理字符串值。

返回值:当 key 不存在时,返回nil ,否则,返回key 的值。

如果 key 不是字符串类型,那么返回一个错误。

GETBIT:GETBIT key offset
描述:对key 所储存的字符串值,获取指定偏移量上的位(bit)。

offset 比字符串值的长度大,或者 key 不存在时,返回0 。
返回值:字符串值指定偏移量上的位(bit)。

GETRANGE:GETRANGE key start end
描述:返回key 中字符串值的子字符串,字符串的截取范围由start 和
end 两个偏移量决定(包括
start 和 end 在内)。
负数偏移量表示从字符串最后开始计数,-1 表示最后一个字符,-2 表示倒数第二个,以此类推。
GETRANGE 通过保证子字符串的值域(range)不超过实际字符串的值域来处理超出范围的值域请求。
返回值:截取得出的子字符串。

GETSET:GETSET key value
描述:将给定key 的值设为value ,并返回
key 的旧值(old value)。

key 存在但不是字符串类型时,返回一个错误
返回值:返回给定key 的旧值。

当 key 没有旧值时,也即是,
key 不存在时,返回 nil 。

INCR:INCR key
描述:将key 中储存的数字值增一。
如果
key 不存在,那么 key 的值会先被初始化为
0 ,然后再执行
INCR 操作。
如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。
返回值:执行INCR
命令之后key 的值。

INCRBY:INCRBY key increment
描述:将key 所储存的值加上增量increment 。
如果
key 不存在,那么 key 的值会先被初始化为
0 ,然后再执行
INCRBY 命令。
如果值包含错误的类型,或字符串类型的值不能表示为数字,那么返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。
关于递增(increment) / 递减(decrement)操作的更多信息,参见INCR
命令。
返回值:加上increment 之后,key 的值。

INCRBYFLOAT:INCRBYFLOAT key increment
描述:为key 中所储存的值加上浮点数增量increment 。
如果
key 不存在,那么
INCRBYFLOAT 会先将
key 的值设为 0 ,再执行加法操作。
如果命令执行成功,那么
key 的值会被更新为(执行加法之后的)新值,并且新值会以字符串的形式返回给调用者。
无论是
key 的值,还是增量 increment ,都可以使用像
2.0e7 、 3e5 、
90e-2 那样的指数符号(exponential notation)来表示,但是,执行 INCRBYFLOAT 命令之后的值总是以同样的形式储存,也即是,它们总是由一个数字,一个(可选的)小数点和一个任意位的小数部分组成(比如3.14 、69.768
,诸如此类),小数部分尾随的 0 会被移除,如果有需要的话,还会将浮点数改为整数(比如3.0 会被保存成3 )。
除此之外,无论加法计算所得的浮点数的实际精度有多长,INCRBYFLOAT
的计算结果也最多只能表示小数点的后十七位。
当以下任意一个条件发生时,返回一个错误:

key 的值不是字符串类型(因为 Redis 中的数字和浮点数都以字符串的形式保存,所以它们都属于字符串类型)

key 当前的值或者给定的增量
increment 不能解释(parse)为双精度浮点数(double precision floating point number)

返回值:执行命令之后key 的值。

MGET:MGET key [key ...]
描述:返回所有(一个或多个)给定key 的值。
如果给定的
key 里面,有某个 key 不存在,那么这个
key 返回特殊值 nil 。因此,该命令永不失败。
返回值:一个包含所有给定key 的值的列表。

MSET:MSET key value [key value ...]
描述:同时设置一个或多个key-value 对。
如果某个给定
key 已经存在,那么
MSET 会用新值覆盖原来的旧值,如果这不是你所希望的效果,请考虑使用MSETNX
命令:它只会在所有给定key 都不存在的情况下进行设置操作。
MSET 是一个原子性(atomic)操作,所有给定key
都会在同一时间内被设置,某些给定 key 被更新而另一些给定
key 没有改变的情况,不可能发生。
返回值:总是返回OK (因为MSET 不可能失败)

MSETNX :MSETNX key value [key value ...]
描述:同时设置一个或多个key-value 对,当且仅当所有给定key 都不存在。
即使只有一个给定
key 已存在,
MSETNX 也会拒绝执行所有给定key 的设置操作。
MSETNX 是原子性的,因此它可以用作设置多个不同key
表示不同字段(field)的唯一性逻辑对象(unique logic object),所有字段要么全被设置,要么全不被设置。
返回值:当所有key 都成功设置,返回1 。

如果所有给定 key 都设置失败(至少有一个
key 已经存在),那么返回 0 。

PSETEX:PSETEX key milliseconds value
描述:这个命令和SETEX
命令相似,但它以毫秒为单位设置key 的生存时间,而不是像
SETEX 命令那样,以秒为单位。
返回值:设置成功时返回OK 。

SET:SET key value [EX seconds] [PX milliseconds] [NX|XX]
描述:将字符串值value 关联到key 。
如果
key 已经持有其他值,
SET 就覆写旧值,无视类型。
对于某个原本带有生存时间(TTL)的键来说, 当SET
命令成功在这个键上执行时, 这个键原有的 TTL 将被清除。
可选参数
从 Redis 2.6.12 版本开始,SET
命令的行为可以通过一系列参数来修改:

EX second :设置键的过期时间为
second 秒。 SET key value EX second 效果等同于SETEX key second value 。

PX millisecond :设置键的过期时间为
millisecond 毫秒。 SET key value PX millisecond 效果等同于PSETEX key millisecond value 。

NX :只在键不存在时,才对键进行设置操作。
SET key value NX 效果等同于 SETNX key value 。

XX :只在键已经存在时,才对键进行设置操作。

因为
SET 命令可以通过参数来实现和SETNX
SETEXPSETEX
三个命令的效果,所以将来的 Redis 版本可能会废弃并最终移除SETNXSETEX
PSETEX 这三个命令。
返回值:在 Redis 2.6.12 版本以前,SET
命令总是返回OK 。

从 Redis 2.6.12 版本开始,
SET 在设置操作成功完成时,才返回OK 。

如果设置了 NX 或者
XX ,但因为条件没达到而造成设置操作未执行,那么命令返回空批量回 复(NULL Bulk Reply)。

SETBIT:SETBIT key offset value
描述:对key 所储存的字符串值,设置或清除指定偏移量上的位(bit)。
位的设置或清除取决于
value 参数,可以是 0 也可以是
1 。

key 不存在时,自动生成一个新的字符串值。
字符串会进行伸展(grown)以确保它可以将value 保存在指定的偏移量上。当字符串值进行伸展时,空白位置以0 填充。
offset 参数必须大于或等于0 ,小于 2^32 (bit 映射被限制在 512 MB 之内)。
对使用大的
offset 的
SETBIT 操作来说,内存分配可能造成 Redis 服务器被阻塞。具体参考SETRANGE
命令,warning(警告)部分。
返回值:指定偏移量原来储存的位。

SETEX:SETEX key seconds value
描述:将值value 关联到key ,并将
key 的生存时间设为
seconds (以秒为单位)。
如果
key 已经存在,
SETEX 命令将覆写旧值。
这个命令类似于以下两个命令:
SET key valueEXPIRE key seconds # 设置生存时间
不同之处是,
SETEX 是一个原子性(atomic)操作,关联值和设置生存时间两个动作会在同一时间内完成,该命令在 Redis 用作缓存时,非常实用。
返回值:设置成功时返回OK 。

当 seconds 参数不合法时,返回一个错误。

SETNX:SETNX key value
描述:将key 的值设为value ,当且仅当
key 不存在。
若给定的
key 已经存在,则
SETNX 不做任何动作。
SETNX 是『SET if Not eXists』(如果不存在,则
SET)的简写。

返回值:设置成功,返回
1 。

设置失败,返回 0 。

SETRANGE:SETRANGE key offset value
描述:用value 参数覆写(overwrite)给定key 所储存的字符串值,从偏移量
offset 开始。
不存在的
key 当作空白字符串处理。
SETRANGE 命令会确保字符串足够长以便将value
设置在指定的偏移量上,如果给定 key 原来储存的字符串长度比偏移量小(比如字符串只有5 个字符长,但你设置的offset 是10 ),那么原字符和偏移量之间的空白将用零字节(zerobytes,
"\x00" )来填充。
注意你能使用的最大偏移量是 2^29-1(536870911) ,因为 Redis 字符串的大小被限制在 512 兆(megabytes)以内。如果你需要使用比这更大的空间,你可以使用多个key 。
当生成一个很长的字符串时,Redis 需要分配内存空间,该操作有时候可能会造成服务器阻塞(block)。在2010年的Macbook Pro上,设置偏移量为 536870911(512MB 内存分配),耗费约 300 毫秒, 设置偏移量为 134217728(128MB 内存分配),耗费约 80 毫秒,设置偏移量 33554432(32MB 内存分配),耗费约 30 毫秒,设置偏移量为
8388608(8MB 内存分配),耗费约 8 毫秒。 注意若首次内存分配成功之后,再对同一个
key 调用
SETRANGE 操作,无须再重新内存。
返回值:被SETRANGE
修改之后,字符串的长度。

STRLEN:STRLEN key
描述:返回key 所储存的字符串值的长度。

key 储存的不是字符串值时,返回一个错误。
返回值:字符串值的长度。

当 key 不存在时,返回
0 。
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息