哈希(hash)函数
hSet 命令/方法/函数 Adds a value to the hash stored at key. If this value is already in the hash, FALSE is returned. 添加一个VALUE到HASH中。如果VALUE已经存在于HASH中,则返回FALSE。 Parameters key hashKey value Return value LONG 1 if value didn't exist and was added successfully, 0 if the value was already present and was replaced, FALSE if there was an error. Example $redis->delete('h') $redis->hSet('h', 'key1', 'hello'); /* 1, 'key1' => 'hello' in the hash at "h" */ $redis->hGet('h', 'key1'); /* returns "hello" */ $redis->hSet('h', 'key1', 'plop'); /* 0, value was replaced. */ $redis->hGet('h', 'key1'); /* returns "plop" */
hSetNx 命令/方法/函数 Adds a value to the hash stored at key only if this field isn't already in the hash. 添加一个VALUE到HASH STORE中,如果FIELD不存在。 Return value BOOL TRUE if the field was set, FALSE if it was already present. Example $redis->delete('h') $redis->hSetNx('h', 'key1', 'hello'); /* TRUE, 'key1' => 'hello' in the hash at "h" */ $redis->hSetNx('h', 'key1', 'world'); /* FALSE, 'key1' => 'hello' in the hash at "h". No change since the field wasn't replaced. */
hGet 命令/方法/函数 Gets a value from the hash stored at key. If the hash table doesn't exist, or the key doesn't exist, FALSE is returned. 取得HASH中的VALUE,如何HASH不存在,或者KEY不存在返回FLASE。 Parameters key hashKey Return value STRING The value, if the command executed successfully BOOL FALSE in case of failure
hLen 命令/方法/函数 Returns the length of a hash, in number of items 取得HASH表的长度。 Parameters key Return value LONG the number of items in a hash, FALSE if the key doesn't exist or isn't a hash. Example $redis->delete('h') $redis->hSet('h', 'key1', 'hello'); $redis->hSet('h', 'key2', 'plop'); $redis->hLen('h'); /* returns 2 */
hDel 命令/方法/函数 Removes a value from the hash stored at key. If the hash table doesn't exist, or the key doesn't exist, FALSE is returned. 删除指定的元素。 Parameters key hashKey Return value BOOL TRUE in case of success, FALSE in case of failure
hKeys 命令/方法/函数 Returns the keys in a hash, as an array of strings. 取得HASH表中的KEYS,以数组形式返回。 Parameters Key: key Return value An array of elements, the keys of the hash. This works like PHP's array_keys(). Example $redis->delete('h'); $redis->hSet('h', 'a', 'x'); $redis->hSet('h', 'b', 'y'); $redis->hSet('h', 'c', 'z'); $redis->hSet('h', 'd', 't'); var_dump($redis->hKeys('h')); Output: array(4) { [0]=> string(1) "a" [1]=> string(1) "b" [2]=> string(1) "c" [3]=> string(1) "d" }
hVals 命令/方法/函数 Returns the values in a hash, as an array of strings. 取得HASH表中所有的VALUE,以数组形式返回。 Parameters Key: key Return value An array of elements, the values of the hash. This works like PHP's array_values(). Example $redis->delete('h'); $redis->hSet('h', 'a', 'x'); $redis->hSet('h', 'b', 'y'); $redis->hSet('h', 'c', 'z'); $redis->hSet('h', 'd', 't'); var_dump($redis->hVals('h')); Output: array(4) { [0]=> string(1) "x" [1]=> string(1) "y" [2]=> string(1) "z" [3]=> string(1) "t" }
hGetAll 命令/方法/函数 Returns the whole hash, as an array of strings indexed by strings. 取得整个HASH表的信息,返回一个以KEY为索引VALUE为内容的数组。 Parameters Key: key Return value An array of elements, the contents of the hash. Example $redis->delete('h'); $redis->hSet('h', 'a', 'x'); $redis->hSet('h', 'b', 'y'); $redis->hSet('h', 'c', 'z'); $redis->hSet('h', 'd', 't'); var_dump($redis->hGetAll('h')); Output: array(4) { ["a"]=> string(1) "x" ["b"]=> string(1) "y" ["c"]=> string(1) "z" ["d"]=> string(1) "t" }
hExists 命令/方法/函数 Verify if the specified member exists in a key. 验证HASH表中是否存在指定的KEY-VALUE Parameters key memberKey Return value BOOL: If the member exists in the hash table, return TRUE, otherwise return FALSE. Examples $redis->hSet('h', 'a', 'x'); $redis->hExists('h', 'a'); /* TRUE */ $redis->hExists('h', 'NonExistingKey'); /* FALSE */
hIncrBy 命令/方法/函数 Increments the value of a member from a hash by a given amount. 根据HASH表的KEY,为KEY对应的VALUE自增参数VALUE。 Parameters key member value: (integer) value that will be added to the member's value Return value LONG the new value Examples $redis->delete('h'); $redis->hIncrBy('h', 'x', 2); /* returns 2: h[x] = 2 now. */ $redis->hIncrBy('h', 'x', 1); /* h[x] ← 2 + 1. Returns 3 */
hIncrByFloat 命令/方法/函数 Increments the value of a hash member by the provided float value 根据HASH表的KEY,为KEY对应的VALUE自增参数VALUE。浮点型 Parameters key member value: (float) value that will be added to the member's value Return value FLOAT the new value Examples $redis->delete('h'); $redis->hIncrByFloat('h','x', 1.5); /* returns 1.5: h[x] = 1.5 now */ $redis->hIncrByFLoat('h', 'x', 1.5); /* returns 3.0: h[x] = 3.0 now */ $redis->hIncrByFloat('h', 'x', -3.0); /* returns 0.0: h[x] = 0.0 now */
hMset 命令/方法/函数 Fills in a whole hash. Non-string values are converted to string, using the standard (string) cast. NULL values are stored as empty strings. 批量填充HASH表。不是字符串类型的VALUE,自动转换成字符串类型。使用标准的值。NULL值将被储存为一个空的字符串。 Parameters key members: key → value array Return value BOOL Examples $redis->delete('user:1'); $redis->hMset('user:1', array('name' => 'Joe', 'salary' => 2000)); $redis->hIncrBy('user:1', 'salary', 100); // Joe earns 100 more now.
hMGet 命令/方法/函数 Retrieve the values associated to the specified fields in the hash. 批量取得HASH表中的VALUE。 Parameters key memberKeys Array Return value Array An array of elements, the values of the specified fields in the hash, with the hash keys as array keys. Examples $redis->delete('h'); $redis->hSet('h', 'field1', 'value1'); $redis->hSet('h', 'field2', 'value2'); $redis->hmGet('h', array('field1', 'field2')); /* returns array('field1' => 'value1', 'field2' => 'value2') */