Redis-string类型操作命令

APPEND key value

    如果key已经存在，并且为字符串，那么这个命令会把value追加到原来值的末尾。如果key不存在，首先创建一个空字符串，再执行追加操作。

    返回值：返回APPEND后字符串的长度。

1. EXISTS mykey
2. 0
3. APPEND mykey "Hello"
4. 5
5. APPEND mykey " world"
6. 11
7. GET mykey
8. Hello world

SETBIT

    SETBIT key offset value

    对key所存储的字符串值，设置或清除指定偏移量上的位（bit）。

    位的设置或清除取决于value参数。

    当key不存在时，自动生成一个新的字符串值。

    

1. SETBIT bit 100861
2. 0
3. SETBIT bit 100861
4. 1
5. GETBIT bit 10086
6. 1
7. GETBIT bit 100
8. 0

BITCOUNT

   BITCOUNT key [start] [end]

    计算给定字符串中，被设置为1 的比特位的数量。对于不存在的字符串，BITCOUNNT操作返回0。

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

2. BITCOUNT bits
3. 0
4. SETBIT bits 01
5. 0
6. BITCOUNT bits
7. 1
8. SETBIT bits 31
9. 0
10. BITCOUNT bits
11. 2

• 模式：使用bitmap实现用户上线次数统计

可以使用SETBIT key为网站上线的天数，value为1，来确定用户在某天在线，从而统计出用户的上线天数。如设置Peter在第101天在线，则可以使用： 

1. SETBIT peter 1011

    依次类推。最后统计即可获取用户在线天数。

 

GETBIT key offset

    对key所存储的字符串值，获取指定偏移量上的位。

    当offset比字符串的长度大，或者key不存在时，返回0。

1. EXISTS bit
2. 0
3. GETBIT bit 10086
4. 0
5. SETBIT bit 41
6. 0
7. GETBIT bit 4
8. 1

DECR

    将key中存储的数字值减一。

    如果key不存在，那么会初始化key值为0，然后惊醒DECR操作。操作限制在64位有符号数字内，

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

    

1. SET num 10
2. OK
3. DECR num
4. 9
5. EXISTS count
6. 0
7. DECR count
8. -1

DECRBY key decrement

    将key所存储的值减去减量decrement。

    如果key不存在，则先被初始化为0，然后再执行操作。如果值包含错误的类型，则会返回一个错误。

    返回值：操作后的值。

1. SET count 10
2. OK
3. DECRBY count 20
4. -10
5. EXISTS pages
6. 0
7. DECRBY pages 1
8. -1
9. DECRBY pages -1
10. 0
11. DECRBY pages -3
12. 3

GET key

       返回key所关联的字符串的值。如果key不存在，则返回nil。

        返回值：key不存在时，返回nil，否则返回key的值。

        如果key不是字符串类型，则返回一个错误。

1. GET db
3. SET DB redis
4. OK
5. get DB
6. redis
7. DEL db
8. 0
9. EXISTS db
10. 0
11. LPUSH db redis mongodb mysql
12. 3
13. GET db
14. ERR Operation against a key holding the wrong kind of value

GETRANGE key start end

    返回字符串值的字串。start end指定截取范围（包括start end在内）。负数表示从最后开始计数。

    返回值：截取的子串。

1. SET greeting "Hello,my friend"
2. OK
3. GETRANGE greeting 04
4. Hello
5. GETRANGE greeting -1-5
7. GETRANGE greeting -3-1
8. end
9. GETRANGE greeting 0-1
10. Hello,my friend
11. GETRANGE greeting 010000000
12. Hello,my friend

GETSET key value

    将给定key的值设为value，并返回key的旧值。

    当key存在但不是字符串时，返回一个错误。

    返回值：返回给定key的旧值。

                    当key没有旧值，即key不存在时，返回nil。

1. GETSET db mongodb
3. GET db
4. mongodb
5. GETSET db redis
6. mongodb

模式：GETSET和INCR组合使用，实现获取一个原子性操作的执行计数器结果，并对结果进行复位。

    

1. INCR mycount
2. 1
3. INCR mycount
4. 2
5. INCR mycount
6. 3
7. GETSET mycount 0
8. 3

INCR key

    将key中存储的数字值增一。

    如果key不存在，那么key会被初始化0，再执行INCR操作。

    如果包含错误的数据类型，则会返回一个错误。

    返回值：执行INCR操作后key的值。

    

1. SET page_view 20
2. OK
3. INCR page_view
4. 21

模式：计数器

INCRBY key increment

    将key所存储的值增加增量increment。

    如果key不存在，那么key的值会先被初始化为0，再执行INCRBY操作。

    

1. SET rank 50
2. OK
3. INCRBY rank 20
4. 70
5. GET rank
6. 70
7. SET book "REDIS"
8. OK
9. INCRBY book 1
10. ERR value is not an integer or out of range

INCRBYFLOAT key increment

    为key中所存储的 值加上浮点数的增量increment。无论加法计算所得的浮点数的实际精度有多长， 

INCRBYFLOAT 的计算结果也最多只能表示小数点的后十七位。

    返回值：执行之后key的值。

    

1. SET mykey 10.50
2. OK
3. INCRBYFLOAT mykey 0.1
4. 10.6
5. SET mykey 314e-2
6. OK
7. INCRBYFLOAT mykey 0.5
8. 3.64
9. SET mykey 4
10. OK
11. INCRBYFLOAT mykey 0.5
12. 4.5

MGET key[key...]

    返回所所有给定key的值。

    如果给定key里面，某个key不存在，则这个key返回特殊值nil。该命令永不失败。

    返回值：一个包含所有给定key的值的列表。

1. SET redis redis.com
2. OK
3. SET mongodb mongodb.com
4. OK
5. MGET redis mongodb mysql
6. redis.com
7. mongodb.com

MSET key value[key value]

    同时设置一个或多个key-value对。

    如果某个给定key存在，那么覆盖原有值。如果不希望被覆盖，可以使用MSENX命令。

    MSET是一个原子操作，所有给定的key都会在同一时间被设置。

    返回值：总是返回OK。

1. MSET date "2012-05" time "11:00 am" weather "SUNNY"
2. OK
3. MGET date time weather
4. 2012-05
5. 11:00 am
6. SUNNY
7. SET google "google.hk"
8. OK
9. MSET google "google.com"
10. OK
11. GET google
12. google.com

MSETNX key value[key value ...]

    同时设置多个key-value，当且仅当所有给定key都不存在。如果有一个key存在，那么MSETNX操作会拒绝执行所有给定的key。

    MSETNX是原子操作，所有字段要么成功，要么失败。

    返回值：所有key成功，返回1。失败返回0。

1. MSETNX rmdbs "MySql" nosql "MongoDB" key-value-store "Redis"
2. 1
3. MGET rmdbs nosql
4. MySql
5. MongoDB
6. MSETNX rmdbs "MySql" language "Java"
7. 0

PSETEX key milliseconds value

    已milliseconds毫秒为单位，设置key的生存时间。

    返回值：成功返回OK。

1. PSETEX mykey 10000"HELLO"
2. OK
3. PTTL mykey
4. 7110
5. GET mykey
6. HELLO
7. PTTL mykey
8. -1
9. GET mykey

SET key value [EX seconds] [PX milliseconds] [NX] [NX]

    将字符串value关联到key。    

    如果key已经持有其他值，SET操作覆盖旧值。

    对于某个原本都有生存时间TTL的键来说，当SET命令成功在执行时，原TTL会被清除。

    可选参数：

•  EX seconds：设置键的国企时间为second秒。此参数等同于SETEX key second value。
•  PX millisecond：设置键的过期时间为millisecond毫秒。SET key value PX millisecond 效果等同于 PSETEX key millisecond value。
• NX：只在key不存在时，才对key执行操作。set key value NX 等同于： SETNX key value。
• XX：只在键已经存在时，才进行操作。

1. SET key "value"
2. OK
3. GET key
4. value
5. SET key "new-value"
6. OK
7. get key
8. new-value
9. SET key "hello" EX 100860
10. OK
11. TTL key
12. 100856
13. TTL key
14. 100852
15. SET key "moto" PX 123331
16. OK
17. TTL key
18. 121
19. get key
20. moto
21. TTL key
22. 107
23. SET key "value" NX
25. SET key1 "value" NX
26. OK
27. SET key "value" XX
28. OK
29. SET key2 "value" XX

SETEX key seconds value

    将value关联到key，并将key的生存时间设置为seconds秒。

    如果key已经存在，SETEX将会覆盖旧值。

    返回值：设置成功时返回OK。蛋seconds参数不合法时，返回一个错误。

1. SETEX user_id 6010086
2. OK
3. TTL user_id
4. 54
5. get user_id
6. 10086
7. get user_id
8. 10086
9. TTL user_id
10. 36

SETNX key value

    将key的值设为value，当且仅当key不存在。

    若给定的key已经存在，则SETNX不做任何动作。SETNX 是 SET if Not eXists。

    返回值：成功1，失败0。

1. EXISTS job
2. 0
3. SETNX job "code-farmer"
4. 1
5. SETNX job "programmer"
6. 0
7. GET job
8. code-farmer

SETRANGE key offset value

    用value参数overwrite给定key所存储的字符串，从offset开始。

    不存在的key当做空白字符串处理。

    SETRANGE命令会确保字符串足够长以便将value设置在指定的便宜量上。如果字符串长度比偏移量小，则空白处使用零字节(x00)填充。

    使用的最大偏移量为2^29 - 1。

    返回值：修改后的字符串长度。

1. redis> SET greeting "hello world"
2. OK
4. redis> SETRANGE greeting 6"Redis"
5. (integer)11
7. redis> GET greeting
8. "hello Redis"
11. # 对空字符串/不存在的 key 进行 SETRANGE
13. redis> EXISTS empty_string
14. (integer)0
16. redis> SETRANGE empty_string 5"Redis!"# 对不存在的 key 使用 SETRANGE
17. (integer)11
19. redis> GET empty_string # 空白处被"x00"填充
20. "x00x00x00x00x00Redis!"

STRLEN key

    返回字符串的长度。当key不是一个字符串时，返回一个错误。

    返回值： 字符串长度。当key不存在时，返回0。

1. SET mykey "Hello World"
2. OK
3. STRLEN mykey
4. 11
5. STRLEN nonestr
6. 0

------------

以上为Redis中对string类型的基本操作命令。

本文主要参考：http://redisdoc.com/