diff --git a/doc/commands.md b/doc/commands.md index 793ec23..4da215e 100644 --- a/doc/commands.md +++ b/doc/commands.md @@ -6,7 +6,7 @@ ledisdb all commands return RESP fomrat and it will use int64 instead of RESP i ## KV -### decr key +### DECR key Decrements the number stored at key by one. If the key does not exist, it is set to 0 before decrementing. An error returns if the value for the key is a wrong type that can not be represented as a signed 64 bit integer. @@ -17,19 +17,20 @@ int64: the value of key after the decrement **Examples** ``` -ledis> decr mykey +ledis> DECR mykey (integer) -1 -ledis> decr mykey +ledis> DECR mykey (integer) -2 ledis> SET mykey "234293482390480948029348230948" OK -ledis> decr mykey +ledis> DECR mykey ERR strconv.ParseInt: parsing "234293482390480948029348230948“: invalid syntax ``` -### decrby key decrement -Decrements the number stored at key by decrement. like decr. +### DECRBY key decrement + +Decrements the number stored at key by decrement. like DECR. **Return value** @@ -38,13 +39,13 @@ int64: the value of key after the decrement **Examples** ``` -ledis> set mykey “10“ +ledis> SET mykey “10“ OK -ledis> decrby mykey “5“ +ledis> DECRBY mykey “5“ (integer) 5 ``` -### del key [key ...] +### DEL key [key ...] Removes the specified keys. @@ -55,36 +56,37 @@ int64: The number of input keys **Examples** ``` -ledis> set key1 "hello" +ledis> SET key1 "hello" OK -ledis> set key2 "world" +ledis> SET key2 "world" OK -ledis> del key1 key2 +ledis> DEL key1 key2 (integer) 2 ``` -### exists key +### EXISTS key Returns if key exists **Return value** int64, specifically: + - 1 if the key exists. - 0 if the key does not exists. **Examples** ``` -ledis> set key1 "hello" +ledis> SET key1 "hello" OK -ledis> exists key1 +ledis> EXISTS key1 (integer) 1 -ledis> exists key2 +ledis> EXISTS key2 (integer) 0 ``` -### get key +### GET key Get the value of key. If the key does not exists, it returns nil value. @@ -96,15 +98,15 @@ bulk: the value of key, or nil when key does not exist. **Examples** ``` -ledis> get nonexisting +ledis> GET nonexisting (nil) -ledis> set mykey "hello" +ledis> SET mykey "hello" OK -ledis> get mykey +ledis> GET mykey "hello" ``` -### getset key value +### GETSET key value Atomically sets key to value and returns the old value stored at key. @@ -115,17 +117,17 @@ bulk: the old value stored at key, or nil when key did not exists. **Examples** ``` -ledis> set mykey "hello" +ledis> SET mykey "hello" OK -ledis> getset mykey "world" +ledis> GETSET mykey "world" "hello" -ledis> get mykey +ledis> GET mykey "world" ``` -### incr key +### INCR key -Increments the number stored at key by one. If the key does not exists, it is set to 0 before incrementing. +Increments the number stored at key by one. If the key does not exists, it is SET to 0 before incrementing. **Return value** @@ -134,17 +136,17 @@ int64: the value of key after the increment **Examples** ``` -ledis> set mykey "10" +ledis> SET mykey "10" OK -ledis> incr mykey +ledis> INCR mykey (integer) 11 -ledis> get mykey +ledis> GET mykey "11" ``` -### incrby key increment +### INCRBY key increment -Increments the number stored at key by increment. If the key does not exists, it is set to 0 before incrementing. +Increments the number stored at key by increment. If the key does not exists, it is SET to 0 before incrementing. **Return value** @@ -153,13 +155,13 @@ int64: the value of key after the increment **Examples** ``` -ledis> set mykey "10" +ledis> SET mykey "10" OK -ledis> incrby mykey 5 +ledis> INCRBY mykey 5 (integer) 15 ``` -### mget key [key ...] +### MGET key [key ...] Returns the values of all specified keys. If the key does not exists, a nil will return. @@ -170,17 +172,17 @@ array: list of values at the specified keys **Examples** ``` -ledis> set key1 "hello" +ledis> SET key1 "hello" OK -ledis> set key2 "world" +ledis> SET key2 "world" OK -ledis> mget key1 key2 nonexisting +ledis> MGET key1 key2 nonexisting 1) "hello" 2) "world" 3) (nil) ``` -### mset key value [key value ...] +### MSET key value [key value ...] Sets the given keys to their respective values. @@ -191,15 +193,15 @@ string: always OK **Examples** ``` -ledis> mset key1 "hello" key2 "world" +ledis> MSET key1 "hello" key2 "world" OK -ledis> get key1 +ledis> GET key1 "hello" -ledis> get key2 +ledis> GET key2 "world" ``` -### set key value +### SET key value Set key to the value. @@ -210,13 +212,13 @@ string: OK **Examples** ``` -ledis> set mykey "hello" +ledis> SET mykey "hello" OK -ledis> get mykey +ledis> GET mykey "hello" ``` -### setnx key value +### SETNX key value Set key to the value if key does not exist. If key already holds a value, no operation is performed. @@ -224,21 +226,21 @@ Set key to the value if key does not exist. If key already holds a value, no ope int64: -- 1 if the key was set -- 0 if the key was not set +- 1 if the key was SET +- 0 if the key was not SET **Examples** ``` -ledis> setnx mykey "hello" +ledis> SETNX mykey "hello" (integer) 1 -ledis> setnx mykey "world" +ledis> SETNX mykey "world" (integer) 0 -ledis> get mykey +ledis> GET mykey "hello" ``` -### expire key seconds +### EXPIRE key seconds Set a timeout on key. After the timeout has expired, the key will be deleted. @@ -252,19 +254,19 @@ int64: **Examples** ``` -ledis> set mykey "hello" +ledis> SET mykey "hello" OK -ledis> expire mykey 60 +ledis> EXPIRE mykey 60 (integer) 1 -ledis> expire mykey 60 +ledis> EXPIRE mykey 60 (integer) 1 -ledis> ttl mykey +ledis> TTL mykey (integer) 58 -ledis> persist mykey +ledis> PERSIST mykey (integer) 1 ``` -### expireat key timestamp +### EXPIREAT key timestamp Set an expired unix timestamp on key. @@ -278,15 +280,15 @@ int64: **Examples** ``` -ledis> set mykey "Hello" +ledis> SET mykey "Hello" OK -ledis> expireat mykey 1293840000 +ledis> EXPIREAT mykey 1293840000 (integer) 1 -ledis> exists mykey +ledis> EXISTS mykey (integer) 0 ``` -### ttl key +### TTL key Returns the remaining time to live of a key that has a timeout. If the key was not set a timeout, -1 returns. @@ -297,15 +299,15 @@ int64: TTL in seconds **Examples** ``` -ledis> set mykey "hello" +ledis> SET mykey "hello" OK -ledis> expire mykey 10 +ledis> EXPIRE mykey 10 (integer) 1 -ledis> ttl mykey +ledis> TTL mykey (integer) 8 ``` -### persist key +### PERSIST key Remove the existing timeout on key @@ -319,21 +321,22 @@ int64: **Examples** ``` -ledis> set mykey "hello" +ledis> SET mykey "hello" OK -ledis> expire mykey 60 +ledis> EXPIRE mykey 60 (integer) 1 -ledis> ttl mykey +ledis> TTL mykey (integer) 57 -ledis> persist mykey +ledis> PERSIST mykey (integer) 1 -ledis> ttl mykey +ledis> TTL mykey (integer) -1 ``` + ## Hash -### hdel key field [field ...] +### HDEL key field [field ...] Removes the specified fiedls from the hash stored at key. @@ -344,13 +347,13 @@ int64: the number of fields that were removed from the hash. **Examples** ``` -ledis> hset myhash field1 "foo" +ledis> HSET myhash field1 "foo" (integer) 1 -ledis> hdel myhash field1 field2 +ledis> HDEL myhash field1 field2 (integer) 1 ``` -### hexists key field +### HEXISTS key field Returns if field is an existing field in the hash stored at key. @@ -364,15 +367,15 @@ int64: **Examples** ``` -ledis> hset myhash field1 "foo" +ledis> HSET myhash field1 "foo" (integer) 1 -ledis> hexists myhash field1 +ledis> HEXISTS myhash field1 (integer) 1 -ledis> hexists myhash field2 +ledis> HEXISTS myhash field2 (integer) 0 ``` -### hget key field +### HGET key field Returns the value associated with field in the hash stored at key. @@ -383,15 +386,15 @@ bulk: the value associated with field, or nil. **Examples** ``` -ledis> hset myhash field1 "foo" +ledis> HSET myhash field1 "foo" (integer) 1 -ledis> hget myhash field1 +ledis> HGET myhash field1 "foo" -ledis> hget myhash field2 +ledis> HGET myhash field2 (nil) ``` -### hgetall key +### HGETALL key Returns all fields and values of the hash stored at key. @@ -402,18 +405,18 @@ array: list of fields and their values stored in the hash, or an empty list (usi **Examples** ``` -ledis> hset myhash field1 "hello" +ledis> HSET myhash field1 "hello" (integer) 1 -ledis> hset myhash field2 "world" +ledis> HSET myhash field2 "world" (integer) 1 -ledis> hgetall myhash +ledis> HGETALL myhash 1) "field1" 2) "hello" 3) "field2" 4) "world" ``` -### hincrby key field increment +### HINCRBY key field increment Increments the number stored at field in the hash stored at key by increment. If key does not exist, a new hash key is created. If field does not exists the value is set to 0 before incrementing. @@ -425,17 +428,17 @@ int64: the value at field after the increment. **Examples** ``` -ledis> hincrby myhash field 1 +ledis> HINCRBY myhash field 1 (integer) 1 -ledis> hget myhash field +ledis> HGET myhash field "1" -ledis> hincrby myhash field 5 +ledis> HINCRBY myhash field 5 (integer) 6 -ledis> hincrby myhash field -10 +ledis> HINCRBY myhash field -10 (integer) -4 ``` -### hkeys key +### HKEYS key Return all fields in the hash stored at key. @@ -446,16 +449,16 @@ array: list of fields in the hash, or an empty list. **Examples** ``` -ledis> hset myhash field1 "hello" +ledis> HSET myhash field1 "hello" (integer) 1 -ledis> hset myhash field2 "world" +ledis> HSET myhash field2 "world" (integer) 1 -ledis> hkeys myhash +ledis> HKEYS myhash 1) "field1" 2) "field2" ``` -### hlen key +### HLEN key Returns the number of fields contained in the hash stored at key @@ -466,15 +469,15 @@ int64: number of fields in the hash, or 0 when key does not exist. **Examples** ``` -ledis> hset myhash field1 "hello" +ledis> HSET myhash field1 "hello" (integer) 1 -ledis> hset myhash field2 "world" +ledis> HSET myhash field2 "world" (integer) 1 -ledis> hlen myhash +ledis> HLEN myhash (integer) 2 ``` -### hmget key field [field ...] +### HMGET key field [field ...] Returns the values associated with the specified fields in the hash stored at key. If field does not exist in the hash, a nil value is returned. @@ -485,17 +488,17 @@ array: list of values associated with the given fields. **Examples** ``` -ledis> hset myhash field1 "hello" +ledis> HSET myhash field1 "hello" (integer) 1 -ledis> hset myhash field2 "world" +ledis> HSET myhash field2 "world" (integer) 1 -ledis> hmget myhash field1 field2 nofield +ledis> HMGET myhash field1 field2 nofield 1) "hello" 2) "world" 3) (nil) ``` -### hmset key field value [field value ...] +### HMSET key field value [field value ...] Sets the specified fields to their respective values in the hash stored at key. @@ -506,14 +509,14 @@ string: OK **Examples** ``` -ledis> hmset myhash field1 "hello" field2 "world" +ledis> HMSET myhash field1 "hello" field2 "world" OK -ledis> hmget myhash field1 field2 +ledis> HMGET myhash field1 field2 1) "hello" 2) "world" ``` -### hset key field value +### HSET key field value Sets field in the hash stored at key to value. If key does not exists, a new hash key is created. @@ -527,17 +530,17 @@ int64: **Examples** ``` -ledis> hset myhash field1 "hello" +ledis> HSET myhash field1 "hello" (integer) 1 -ledis> hget myhash field1 +ledis> HGET myhash field1 "hello" -ledis> hset myhash field1 "world" +ledis> HSET myhash field1 "world" (integer) 0 -ledis> hget myhash field1 +ledis> HGET myhash field1 "world" ``` -### hvals key +### HVALS key Returns all values in the hash stored at key. @@ -548,16 +551,16 @@ array: list of values in the hash, or an empty list. **Examples** ``` -ledis> hset myhash field1 "hello" +ledis> HSET myhash field1 "hello" (integer) 1 -ledis> hset myhash field2 "world" +ledis> HSET myhash field2 "world" (integer) 1 -ledis> hvals myhash +ledis> HVALS myhash 1) "hello" 2) "world" ``` -### hclear key +### HCLEAR key Deletes the specified hash keys @@ -568,13 +571,13 @@ int64: the number of fields in the hash stored at key **Examples** ``` -ledis> hmset myhash field1 "hello" field2 "world" +ledis> HMSET myhash field1 "hello" field2 "world" OK -ledis> hclear myhash +ledis> HCLEAR myhash (integer) 2 ``` -### hmclear key [key...] +### HMCLEAR key [key...] Deletes the specified hash keys @@ -585,180 +588,952 @@ int64: the number of input keys **Examples** ``` -ledis> hmset myhash field1 "hello" field2 "world" +ledis> HMSET myhash field1 "hello" field2 "world" OK -ledis> hclear myhash +ledis> HMCLEAR myhash (integer) 1 ``` -### hexpire key seconds +### HEXPIRE key seconds Sets a hash key's time to live in seconds, like expire similarly. -### hexpireat key timestamp +**Return value** + +int64: + +- 1 if the timeout was set +- 0 if key does not exist or the timeout could not be set + + +**Examples** + +``` +27.0.0.1:6666> HSET myhash a 100 +(integer) 1 +127.0.0.1:6666> HGET myhash a +100 +127.0.0.1:6666> HEXPIRE myhash 100 +(integer) 1 +127.0.0.1:6666> HTTL myhash +(integer) 94 +127.0.0.1:6666> HPERSIST myhash +(integer) 1 +127.0.0.1:6666> HTTL myhash +(integer) -1 +127.0.0.1:6666> HEXPIRE not_exists_key 100 +(integer) 0 +``` + +### HEXPIREAT key timestamp Sets the expiration for a hash key as a unix timestamp, like expireat similarly. -### httl key +**Return value** -Gets the tiem to live for a hash key in seconds, like ttl similarly. +int64: -### hpersist key +- 1 if the timeout was set +- 0 if key does not exist or the timeout could not be set + +**Examples** + +``` +127.0.0.1:6666> HSET myhash a 100 +(integer) 1 +127.0.0.1:6666> HEXPIREAT myhash 1404999999 +(integer) 1 +127.0.0.1:6666> HTTL myhash +(integer) 802475 +127.0.0.1:6666> HEXPIREAT not_exists_key 1404999999 +(integer) 0 +``` + +### HTTL key + +Returns the remaining time to live of a key that has a timeout. If the key was not set a timeout, -1 returns. + +**Return value** + +int64: TTL in seconds + +**Examples** + +``` +127.0.0.1:6666> HSET myhash a 100 +(integer) 1 +127.0.0.1:6666> HEXPIREAT myhash 1404999999 +(integer) 1 +127.0.0.1:6666> HTTL myhash +(integer) 802475 +127.0.0.1:6666> HTTL not_set_timeout +(integer) -1 +``` + +### HPERSIST key Remove the expiration from a hash key, like persist similarly. +Remove the existing timeout on key + +**Return value** + +int64: + +- 1 if the timeout was removed +- 0 if key does not exist or does not have an timeout + +``` +127.0.0.1:6666> HSET myhash a 100 +(integer) 1 +127.0.0.1:6666> HEXPIREAT myhash 1404999999 +(integer) 1 +127.0.0.1:6666> HTTL myhash +(integer) 802475 +127.0.0.1:6666> HPERSIST myhash +(integer) 1 +127.0.0.1:6666> HTTL myhash +(integer) -1 +127.0.0.1:6666> HPERSIST not_exists_key +(integer) 0 +``` + ## List -### lindex +### LINDEX key index +Returns the element at index index in the list stored at key. The index is zero-based, so 0 means the first element, 1 the second element and so on. Negative indices can be used to designate elements starting at the tail of the list. Here, -1 means the last element, -2 means the penultimate and so forth. +When the value at key is not a list, an error is returned. + **Return value** -**Examples** -### llen -**Return value** +string: the requested element, or nil when index is out of range. **Examples** -### lpop + +``` +ledis > RPUSH a 1 2 3 +(integer) 3 +ledis > LINDEX a 0 +1 +ledis > LINDEX a 1 +2 +ledis > LINDEX a 2 +3 +ledis > LINDEX a 3 +(nil) +ledis > LINDEX a -1 +3 +``` + +### LLEN key +Returns the length of the list stored at key. If key does not exist, it is interpreted as an empty list and 0 is returned. An error is returned when the value stored at key is not a list. + **Return value** -**Examples** -### lrange -**Return value** +int64: the length of the list at key. **Examples** -### lpush + +``` +ledis > RPUSH a 'foo' +(integer) 1 +ledis > RPUSH a 'bar' +(integer) 2 +ledis > LLEN a +(integer) 2 +``` + +### LPOP key +Removes and returns the first element of the list stored at key. + **Return value** -**Examples** -### rpop -**Return value** +bulk: the value of the first element, or nil when key does not exist. **Examples** -### rpush + +``` +ledis > RPUSH a 'one' +(integer) 1 +ledis > RPUSH a 'two' +(integer) 2 +ledis > RPUSH a 'three' +(integer) 3 +ledis > LPOP a +one +``` + +### LRANGE key start stop +Returns the specified elements of the list stored at key. The offsets start and stop are zero-based indexes, with 0 being the first element of the list (the head of the list), 1 being the next element and so on. + **Return value** -**Examples** -### lclear -**Return value** +array: list of elements in the specified range. **Examples** -### lexpire + +``` +ledis > RPUSH a 'one' 'two' 'three' +(integer) 3 +ledis > LRANGE a 0 0 +1) "one" +ledis > LRANGE a -100 100 +1) "one" +2) "two" +3) "three" +ledis > LRANGE a -3 2 +1) "one" +2) "two" +3) "three" +ledis > LRANGE a 0 -1 +(empty list or set) +``` + +### LPUSH key value [value ...] +Insert all the specified values at the head of the list stored at key. If key does not exist, it is created as empty list before performing the push operations. When key holds a value that is not a list, an error is returned. + **Return value** -**Examples** -### lexpireat -**Return value** +int64: the length of the list after the push operations. **Examples** -### lttl + +``` +ledis > LPUSH a 1 +(integer) 1 +ledis > LPUSH a 2 +(integer) 2 +ledis > LRANGE a 0 2 +1) "2" +2) "1" +``` + +### RPOP key +Removes and returns the last element of the list stored at key. + **Return value** -**Examples** -### lpersist -**Return value** +bulk: the value of the last element, or nil when key does not exist. **Examples** +``` +edis > RPUSH a 1 +(integer) 1 +ledis > RPUSH a 2 +(integer) 2 +ledis > RPUSH a 3 +(integer) 3 +ledis > RPOP a +3 +ledis > LRANGE a 0 3 +1) "1" +2) "2" +``` + +### RPUSH key value [value ...] +Insert all the specified values at the tail of the list stored at key. If key does not exist, it is created as empty list before performing the push operation. When key holds a value that is not a list, an error is returned. + +**Return value** + +int64: the length of the list after the push operation. + +**Examples** + +``` +ledis > RPUSH a 'hello' +(integer) 1 +ledis > RPUSH a 'world' +(integer) 2 +ledis > LRANGE a 0 2 +1) "hello" +2) "world" +``` + +### LCLEAR key +Deletes the specified list key + +**Return value** + +int64: the number of values in the list stored at key + +**Examples** + +``` +ledis > RPUSH a 1 2 3 +(integer) 3 +ledis > LLEN a +(integer) 3 +ledis > LCLEAR a +(integer) 3 +ledis > LLEN a +(integer) 0 +``` + +### LEXPIRE key seconds +Set a timeout on key. After the timeout has expired, the key will be deleted. + +**Return value** + +int64: + +- 1 if the timeout was set +- 0 if key does not exist or the timeout could not be set + +**Examples** + +``` +ledis > RPUSH a 1 +(integer) 1 +ledis > LEXPIRE a 100 +(integer) 1 +ledis > LTTL a +(integer) 96 +ledis > LPERSIST a +(integer) 1 +ledis > LTTL a +(integer) -1 +``` + +### LEXPIREAT key timestamp +Set an expired unix timestamp on key. + +**Return value** + +int64: + +- 1 if the timeout was set +- 0 if key does not exist or the timeout could not be set + +**Examples** + +``` +ledis > RPUSH a 1 +(integer) 1 +ledis > LEXPIREAT a 1404140183 +(integer) 1 +ledis > LTTL a +(integer) 570 +ledis > LPERSIST a +(integer) 1 +ledis > LTTL a +(integer) -1 +ledis > +``` + +### LTTL key +Returns the remaining time to live of a key that has a timeout. If the key was not set a timeout, -1 returns. + +**Return value** + +int64: TTL in seconds + +**Examples** + +``` +ledis > RPUSH a 1 +(integer) 1 +ledis > LEXPIREAT a 1404140183 +(integer) 1 +ledis > LTTL a +(integer) 570 +ledis > LPERSIST a +(integer) 1 +ledis > LTTL a +(integer) -1 +``` + +### LPERSIST key +Remove the existing timeout on key + +**Return value** + +int64: + +- 1 if the timeout was removed +- 0 if key does not exist or does not have an timeout + +**Examples** + +``` +ledis > RPUSH a 1 +(integer) 1 +ledis > LEXPIREAT a 1404140183 +(integer) 1 +ledis > LTTL a +(integer) 570 +ledis > LPERSIST a +(integer) 1 +ledis > LTTL a +(integer) -1 +ledis > LPERSIST b +(integer) 0 +``` + + ## ZSet -### zadd +### ZADD key score member [score member ...] +Adds all the specified members with the specified scores to the sorted set stored at key. It is possible to specify multiple score / member pairs. If a specified member is already a member of the sorted set, the score is updated and the element reinserted at the right position to ensure the correct ordering. + +If key does not exist, a new sorted set with the specified members as sole members is created, like if the sorted set was empty. If the key exists but does not hold a sorted set, an error is returned. + +The score values should be the string representation of a double precision floating point number. +inf and -inf values are valid values as well. + **Return value** -**Examples** -### zcard -**Return value** +int64, specifically: + +The number of elements added to the sorted sets, ** not ** including elements already existing for which the score was updated. + **Examples** -### zcount + +``` +ledis > ZADD myset 1 'one' +(integer) 1 +ledis > ZADD myset 1 'uno' +(integer) 1 +ledis > ZADD myset 2 'two' 3 'three' +(integer) 2 +ledis > ZRANGE myset 0 -1 WITHSCORES +1) "one" +2) "1" +3) "uno" +4) "1" +5) "two" +6) "2" +7) "three" +8) "3" +``` + +### ZCARD key +Returns the sorted set cardinality (number of elements) of the sorted set stored at key. + **Return value** -**Examples** -### zincrby -**Return value** +int64: the cardinality (number of elements) of the sorted set, or 0 if key does not exist. **Examples** -### zrange + +``` +edis > ZADD myset 1 'one' +(integer) 1 +ledis > ZADD myset 1 'uno' +(integer) 1 +ledis > ZADD myset 2 'two' 3 'three' +(integer) 2 +ledis > ZRANGE myset 0 -1 WITHSCORES +1) "one" +2) "1" +3) "uno" +4) "1" +5) "two" +6) "2" +7) "three" +8) "3" +ledis > zcard myset +(integer) 4 +``` + +### ZCOUNT key min max +Returns the number of elements in the sorted set at key with a score between min and max. +The min and max arguments have the same semantic as described for ZRANGEBYSCORE. + **Return value** -**Examples** -### zrangebyscore -**Return value** +int64: the number of elements in the specified score range. **Examples** -### zrank + +``` +ledis > ZADD myset 1 'one' +(integer) 1 +ledis > ZADD myset 1 'uno' +(integer) 1 +ledis > ZADD myset 2 'two' 3 'three' +(integer) 2 +ledis > ZRANGE myset 0 -1 WITHSCORES +1) "one" +2) "1" +3) "uno" +4) "1" +5) "two" +6) "2" +7) "three" +8) "3" +ledis > zcount myset -inf +inf +(integer) 4 +ledis > zcount myset (1 3 +(integer) 2 +``` + +### ZINCRBY key increment member + +Increments the score of member in the sorted set stored at key by increment. If member does not exist in the sorted set, it is added with increment as its score (as if its previous score was 0.0). If key does not exist, a new sorted set with the specified member as its sole member is created. +An error is returned when key exists but does not hold a sorted set. +The score value should be the string representation of a numeric value, and accepts double precision floating point numbers. It is possible to provide a negative value to decrement the score. + **Return value** -**Examples** -### zrem -**Return value** +bulk: the new score of member (a double precision floating point number), represented as string. **Examples** -### zremrangebyrank + +``` +ledis > ZADD myset 1 'one' +(integer) 1 +ledis > ZADD myset 2 'two' +(integer) 1 +ledis > ZINCRBY myset 2 'one' +3 +ledis > ZRANGE myset 0 -1 WITHSCORES +1) "two" +2) "2" +3) "one" +4) "3" +``` + +### ZRANGE key start stop [WITHSCORES] +Returns the specified range of elements in the sorted set stored at key. The elements are considered to be ordered from the lowest to the highest score. Lexicographical order is used for elements with equal score. + **Return value** -**Examples** -### zremrangebyscore -**Return value** +array: list of elements in the specified range (optionally with their scores). **Examples** -### zrevrange + +``` +ledis > ZADD myset 1 'one' +(integer) 1 +ledis > ZADD myset 2 'two' +(integer) 1 +ledis > ZADD myset 3 'three' +(integer) 1 +ledis > ZRANGE myset 0 -1 +1) "one" +2) "two" +3) "three" +ledis > ZRANGE myset 2 3 +1) "three" +ledis > ZRANGE myset -2 -1 +1) "two" +2) "three" +``` + +### ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count] + +Returns all the elements in the sorted set at key with a score between min and max (including elements with score equal to min or max). The elements are considered to be ordered from low to high scores. + **Return value** -**Examples** -### zrevrangebyscore -**Return value** +array: list of elements in the specified score range (optionally with their scores). **Examples** -### zscore + +``` +127.0.0.1:6666> ZADD myzset 1 'one' +(integer) 1 +127.0.0.1:6666> ZADD myzset 2 'two' +(integer) 1 +127.0.0.1:6666> ZADD myzset 3 'three' +(integer) 1 +127.0.0.1:6666> ZRANGEBYSCORE myzset -inf +inf WITHSCORES +1) "one" +2) "1" +3) "two" +4) "2" +5) "three" +6) "3" +127.0.0.1:6666> ZRANGEBYSCORE myzset -inf +inf WITHSCORES LIMIT 2 5 +1) "three" +2) "3" +127.0.0.1:6666> ZRANGEBYSCORE myzset (1 2 WITHSCORES +1) "two" +2) "2" +127.0.0.1:6666> ZRANGEBYSCORE myzset (1 (2 WITHSCORES +``` + +### ZRANK key member +Returns the rank of member in the sorted set stored at key, with the scores ordered from low to high. The rank (or index) is 0-based, which means that the member with the lowest score has rank 0. + **Return value** -**Examples** -### zclear -**Return value** +Return value + +- If member exists in the sorted set, Integer reply: the rank of member. +- If member does not exist in the sorted set or key does not exist, Bulk string reply: nil. **Examples** -### zexpire + +``` +127.0.0.1:6666> ZADD myzset 1 'one' +(integer) 1 +127.0.0.1:6666> ZADD myzset 2 'two' +(integer) 1 +127.0.0.1:6666> ZADD myzset 3 'three' +(integer) 1 +127.0.0.1:6666> ZRANGEBYSCORE myzset -inf +inf WITHSCORES +1) "one" +2) "1" +3) "two" +4) "2" +5) "three" +6) "3" +127.0.0.1:6666> ZRANK myzset 'three' +(integer) 2 +``` + + +### ZREM key member [member ...] +Removes the specified members from the sorted set stored at key. Non existing members are ignored. +An error is returned when key exists and does not hold a sorted set. + **Return value** -**Examples** -### zexpireat -**Return value** +int64 reply, specifically: + +The number of members removed from the sorted set, not including non existing members. **Examples** -### zttl + +``` +127.0.0.1:6666> ZADD myset 1 one 2 two 3 three 4 four +(integer) 3 +127.0.0.1:6666> ZRANGE myset 0 -1 +1) "one" +2) "two" +3) "three" +4) "four" +127.0.0.1:6666> ZREM myset three +(integer) 1 +127.0.0.1:6666> ZREM myset one four three +(integer) 2 +``` + +### ZREMRANGEBYRANK key start stop +Removes all elements in the sorted set stored at key with rank between start and stop. Both start and stop are 0 -based indexes with 0 being the element with the lowest score. These indexes can be negative numbers, where they indicate offsets starting at the element with the highest score. For example: -1 is the element with the highest score, -2 the element with the second highest score and so forth. + **Return value** -**Examples** -### zpersist -**Return value** +int64: the number of elements removed. **Examples** +``` +127.0.0.1:6666> ZADD myset 1 one 2 two 3 three 4 four +(integer) 3 +127.0.0.1:6666> ZREMRANGEBYRANK myset 0 2 +(integer) 3 +127.0.0.1:6666> ZRANGE myset 0 -1 WITHSCORES +1) "four" +2) "4" +``` + + +### ZREMRANGEBYSCORE key min max +Removes all elements in the sorted set stored at key with a score between min and max (inclusive). + +**Return value** + +int64: the number of elements removed. + +**Examples** + +``` +127.0.0.1:6666> ZADD myset 1 one 2 two 3 three 4 four +(integer) 4 +127.0.0.1:6666> ZREMRANGEBYSCORE myset -inf (2 +(integer) 1 +127.0.0.1:6666> ZRANGE myset 0 -1 WITHSCORES +1) "two" +2) "2" +3) "three" +4) "3" +5) "four" +6) "4" +``` + +### ZREVRANGE key start stop [WITHSCORES] +Returns the specified range of elements in the sorted set stored at key. The elements are considered to be ordered from the highest to the lowest score. Descending lexicographical order is used for elements with equal score. +Apart from the reversed ordering, ZREVRANGE is similar to ZRANGE. + +**Return value** + +array: list of elements in the specified range (optionally with their scores). + +**Examples** + +``` +127.0.0.1:6666> ZADD myset 1 one 2 two 3 three 4 four +(integer) 4 +127.0.0.1:6666> ZREVRANGE myset 0 -1 +1) "four" +2) "three" +3) "two" +4) "one" +``` + +### ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count] +Returns all the elements in the sorted set at key with a score between max and min (including elements with score equal to max or min). In contrary to the default ordering of sorted sets, for this command the elements are considered to be ordered from high to low scores. +The elements having the same score are returned in reverse lexicographical order. +Apart from the reversed ordering, ZREVRANGEBYSCORE is similar to ZRANGEBYSCORE. + +**Return value** + +array: list of elements in the specified score range (optionally with their scores). + +**Examples** + +``` +127.0.0.1:6666> ZADD myset 1 one 2 two 3 three 4 four +(integer) 4 +127.0.0.1:6666> ZREVRANGEBYSCORE myset +inf -inf +1) "four" +2) "three" +3) "two" +4) "one" +127.0.0.1:6666> ZREVRANGEBYSCORE myset 2 1 +1) "two" +2) "one" +127.0.0.1:6666> ZREVRANGEBYSCORE myset 2 (1 +1) "two" +127.0.0.1:6666> ZREVRANGEBYSCORE myset (2 (1 +(empty list or set) +127.0.0.1:6666> ZREVRANGEBYSCORE myset +inf -inf WITHSCORES LIMIT 1 2 +1) "three" +2) "3" +3) "two" +4) "2" +``` + +### ZSCORE key member +Returns the score of member in the sorted set at key. +If member does not exist in the sorted set, or key does not exist, nil is returned. + +**Return value** + +bulk: the score of member (a double precision floating point number), represented as string. + +**Examples** + +``` +ledis > ZADD myset 1 'one' +(integer) 1 +ledis > ZSCORE myset 'one' +1 +``` + +### ZCLEAR key +Delete the specified key + +**Return value** + +int64: the number of members in the zset stored at key + +**Examples** + +``` +ledis > ZADD myset 1 'one' +(integer) 1 +ledis > ZADD myset 2 'two' +(integer) 1 +ledis > ZADD myset 3 'three' +(integer) 1 +ledis > ZRANGE myset 0 -1 +1) "one" +2) "two" +3) "three" +ledis > ZCLEAR myset +(integer) 3 +``` + +### ZMCLEAR key [key ...] +Delte multiple keys one time. + +**Return value** + +int64: the number of input keys + +**Examples** + +``` +ledis > ZADD myset1 1 'one' +(integer) 1 +ledis > ZADD myset2 2 'two' +(integer) 1 +ledis > ZMCLEAR myset1 myset2 +(integer) 2 +``` + +### ZEXPIRE key seconds + +Set a timeout on key. After the timeout has expired, the key will be deleted. + +**Return value** + +int64: + +- 1 if the timeout was set +- 0 if key does not exist or the timeout could not be set + + +**Examples** + +``` +ledis > ZADD myset 1 'one' +(integer) 1 +ledis > ZEXPIRE myset 100 +(integer) 1 +ledis > ZTTL myset +(integer) 97 +ledis > ZPERSIST myset +(integer) 1 +ledis > ZTTL mset +(integer) -1 +ledis > ZEXPIRE myset1 100 +(integer) 0 +``` + +### ZEXPIREAT key timestamp +Set an expired unix timestamp on key. Similar to ZEXPIRE. + +**Return value** + +int64: + +- 1 if the timeout was set +- 0 if key does not exist or the timeout could not be set + +**Examples** + +``` +ledis > ZADD myset 1 'one' +(integer) 1 +ledis > ZEXPIREAT myset 1404149999 +(integer) 1 +ledis > ZTTL myset +(integer) 7155 +ledis > ZPERSIST myset +(integer) 1 +ledis > ZTTL mset +(integer) -1 +ledis > ZEXPIREAT myset1 1404149999 +(integer) 0 +``` + + +### ZTTL key +Returns the remaining time to live of a key that has a timeout. If the key was not set a timeout, -1 returns. + +**Return value** + +int64: TTL in seconds + +**Examples** + +``` +ledis > zadd myset 1 'one' +(integer) 1 +ledis > zexpire myset 100 +(integer) 1 +ledis > zttl myset +(integer) 97 +ledis > zttl myset2 +(integer) -1 +``` + +### ZPERSIST key +Remove the existing timeout on key. + +**Return value** + +int64: + +- 1 if the timeout was removed +- 0 if key does not exist or does not have an timeout + +**Examples** + +``` +ledis > ZADD myset 1 'one' +(integer) 1 +ledis > ZEXPIRE myset 100 +(integer) 1 +ledis > ZTTL myset +(integer) 97 +ledis > ZPERSIST myset +(integer) 1 +ledis > ZTTL mset +(integer) -1 +``` + + ## Replication -### slaveof +### SLAVEOF **Return value** **Examples** -### fullsync +### FULLSYNC **Return value** **Examples** -### sync +### SYNC **Return value** **Examples** + + ## Server -### ping +### PING +Returns PONG. This command is often used to test if a connection is still alive, or to measure latency. + **Return value** -**Examples** -### echo -**Return value** +String **Examples** -### select + +``` +ledis > PING +PONG +ledis > PING +dial tcp 127.0.0.1:6665: connection refused +ledis > +``` + +### ECHO message + +Returns message. + **Return value** +bulk string reply + **Examples** + +``` +ledis > ECHO "hello" +hello +``` + +### SELECT index +Select the DB with having the specified zero-based numeric index. New connections always use DB 0. Currently, We support 16 DBs(0-15). + +**Return value** + +Simple string reply + +**Examples** + +``` +ledis > SELECT 2 +OK +ledis > SELECT 15 +OK +ledis > SELECT 16 +ERR invalid db index 16 +```