# HVALS ```json metadata { "schema_version": 2, "title": "HVALS", "description": "Returns all values in a hash.", "categories": ["docs","develop","stack","oss","rs","rc","oss","kubernetes","clients"], "arguments": [{"display_text":"key","key_spec_index":0,"name":"key","type":"key"}], "syntax_fmt": "HVALS key", "complexity": "O(N) where N is the size of the hash.", "group": "hash", "command_flags": ["readonly"], "acl_categories": ["@read","@hash","@slow"], "since": "2.0.0", "arity": 2, "key_specs": [{"RO":true,"access":true,"begin_search":{"spec":{"index":1},"type":"index"},"find_keys":{"spec":{"keystep":1,"lastkey":0,"limit":0},"type":"range"}}], "tableOfContents": {"sections":[{"id":"required-arguments","title":"Required arguments"},{"id":"examples","title":"Examples"},{"id":"redis-software-and-redis-cloud-compatibility","title":"Redis Software and Redis Cloud compatibility"},{"id":"return-information","title":"Return information"}]} , "codeExamples": [{"codetabsId":"cmds_hash-stephvals","commands":[{"acl_categories":["@write","@hash","@fast"],"complexity":"O(1)","name":"HSET"},{"acl_categories":["@read","@hash","@slow"],"complexity":"O(N)","name":"HVALS"}],"description":"Foundational: Retrieve all values from a hash using HVALS (returns only values without field names, useful when you only need the data)","difficulty":"beginner","id":"hvals","languages":[{"id":"redis-cli","panelId":"panel_redis-cli_cmds_hash-stephvals"},{"clientId":"redis-py","clientName":"redis-py","id":"Python","langId":"python","panelId":"panel_Python_cmds_hash-stephvals"},{"id":"Node-js","panelId":"panel_Nodejs_cmds_hash-stephvals"},{"clientId":"ioredis","clientName":"ioredis","id":"ioredis","langId":"javascript","panelId":"panel_ioredis_cmds_hash-stephvals"},{"clientId":"jedis","clientName":"Jedis","id":"Java-Sync","langId":"java","panelId":"panel_Java-Sync_cmds_hash-stephvals"},{"clientId":"lettuce","clientName":"Lettuce","id":"Lettuce-Sync","langId":"java","panelId":"panel_Lettuce-Sync_cmds_hash-stephvals"},{"clientId":"lettuce","clientName":"Lettuce","id":"Java-Async","langId":"java","panelId":"panel_Java-Async_cmds_hash-stephvals"},{"clientId":"lettuce","clientName":"Lettuce","id":"Java-Reactive","langId":"java","panelId":"panel_Java-Reactive_cmds_hash-stephvals"},{"clientId":"go-redis","clientName":"go-redis","id":"Go","langId":"go","panelId":"panel_Go_cmds_hash-stephvals"},{"clientId":"hiredis","clientName":"hiredis","id":"C","langId":"c","panelId":"panel_C_cmds_hash-stephvals"},{"id":"dotnet-Sync (SE-Redis)","panelId":"panel_Csharp-Sync (SERedis)_cmds_hash-stephvals"},{"clientId":"predis","clientName":"Predis","id":"PHP","langId":"php","panelId":"panel_PHP_cmds_hash-stephvals"},{"clientId":"redis-rb","clientName":"redis-rb","id":"Ruby","langId":"ruby","panelId":"panel_Ruby_cmds_hash-stephvals"},{"clientId":"redis-rs","clientName":"redis-rs","id":"Rust-Sync","langId":"rust","panelId":"panel_Rust-Sync_cmds_hash-stephvals"},{"clientId":"redis-rs","clientName":"redis-rs","id":"Rust-Async","langId":"rust","panelId":"panel_Rust-Async_cmds_hash-stephvals"}]}] } ``` ## Code Examples Legend The code examples below show how to perform the same operations in different programming languages and client libraries: - **Redis CLI**: Command-line interface for Redis - **C# (Synchronous)**: StackExchange.Redis synchronous client - **C# (Asynchronous)**: StackExchange.Redis asynchronous client - **Go**: go-redis client - **Java (Synchronous - Jedis)**: Jedis synchronous client - **Java (Asynchronous - Lettuce)**: Lettuce asynchronous client - **Java (Reactive - Lettuce)**: Lettuce reactive/streaming client - **JavaScript (Node.js)**: node-redis client - **PHP**: Predis client - **Python**: redis-py client - **Rust (Synchronous)**: redis-rs synchronous client - **Rust (Asynchronous)**: redis-rs asynchronous client Each code example demonstrates the same basic operation across different languages. The specific syntax and patterns vary based on the language and client library, but the underlying Redis commands and behavior remain consistent. --- Returns all values in the hash stored at `key`. ## Required arguments
key The name of the key that holds the hash.
## Examples Foundational: Retrieve all values from a hash using HVALS (returns only values without field names, useful when you only need the data) **Difficulty:** Beginner **Commands:** HSET, HVALS **Complexity:** - HSET: O(1) - HVALS: O(N) **Available in:** Redis CLI, C, C#, Go, Java, Java (Asynchronous - Lettuce), Java (Reactive - Lettuce), Java (Synchronous - Jedis), JavaScript (Node.js), JavaScript (Node.js), PHP, Python, Ruby, Rust (Asynchronous), Rust (Synchronous) ##### Redis CLI ``` redis> HSET myhash field1 "Hello" (integer) 1 redis> HSET myhash field2 "World" (integer) 1 redis> HVALS myhash 1) "Hello" 2) "World" ``` ##### C ```c reply = redisCommand(c, "HSET myhash field1 Hello field2 World"); freeReplyObject(reply); reply = redisCommand(c, "HVALS myhash"); for (size_t i = 0; i < reply->elements; i++) { printf("%s\n", reply->element[i]->str); } // >>> Hello // >>> World freeReplyObject(reply); ``` ##### C# ```csharp db.HashSet("myhash", [ new("field1", "Hello"), new("field2", "World") ] ); RedisValue[] hValsResult = db.HashValues("myhash"); Array.Sort(hValsResult); Console.WriteLine(string.Join(", ", hValsResult)); // >>> Hello, World ``` ##### Go ```go hValsResult1, err := rdb.HSet(ctx, "myhash", "field1", "Hello", "field2", "World", ).Result() if err != nil { panic(err) } fmt.Println(hValsResult1) // >>> 2 hValsResult2, err := rdb.HVals(ctx, "myhash").Result() if err != nil { panic(err) } sort.Strings(hValsResult2) fmt.Println(hValsResult2) // >>> [Hello World] ``` ##### Java ```java Map hValsFields = new HashMap<>(); hValsFields.put("field1", "Hello"); hValsFields.put("field2", "World"); syncCommands.hset("myhash", hValsFields); // The order of the values isn't guaranteed, so sort them before // printing. List res15 = syncCommands.hvals("myhash"); List sortedValues = new ArrayList<>(res15); Collections.sort(sortedValues); System.out.println(sortedValues); // >>> [Hello, World] ``` ##### Java (Asynchronous - Lettuce) ```java Map hValsExampleParams = new HashMap<>(); hValsExampleParams.put("field1", "Hello"); hValsExampleParams.put("field2", "World"); CompletableFuture hValsExample = asyncCommands.hset("myhash", hValsExampleParams).thenCompose(res1 -> { return asyncCommands.hvals("myhash"); }).thenAccept(res2 -> { List sortedValues = new ArrayList<>(res2); Collections.sort(sortedValues); System.out.println(sortedValues); // >>> [Hello, World] }).toCompletableFuture(); ``` ##### Java (Reactive - Lettuce) ```java Map hValsExampleParams = new HashMap<>(); hValsExampleParams.put("field1", "Hello"); hValsExampleParams.put("field2", "World"); Mono hValsExample1 = reactiveCommands.hset("myhash", hValsExampleParams).doOnNext(result -> { }); hValsExample1.block(); Mono> hValsExample2 = reactiveCommands.hvals("myhash").collectList().doOnNext(result -> { List sortedValues = new ArrayList<>(result); Collections.sort(sortedValues); System.out.println(sortedValues); // >>> [Hello, World] }); ``` ##### Java (Synchronous - Jedis) ```java Map hValsExampleParams = new HashMap<>(); hValsExampleParams.put("field1", "Hello"); hValsExampleParams.put("field2", "World"); long hValsResult1 = jedis.hset("myhash", hValsExampleParams); System.out.println(hValsResult1); // >>> 2 List hValsResult2 = jedis.hvals("myhash"); Collections.sort(hValsResult2); System.out.println(hValsResult2); // >>> [Hello, World] ``` ##### JavaScript (Node.js) ```javascript const res12 = await client.hSet( 'myhash', { 'field1': 'Hello', 'field2': 'World' } ) // HVALS follows the hash's field order, which Redis does not promise, so sort. const res13 = (await client.hVals('myhash')).sort() console.log(res13) // [ 'Hello', 'World' ] ``` ##### JavaScript (Node.js) ```javascript await redis.hset('myhash', { field1: 'Hello', field2: 'World' }); // HVALS follows the hash's field order, which Redis does not promise, so sort. const hvalsRes = await redis.hvals('myhash'); console.log(hvalsRes.sort()); // >>> [ 'Hello', 'World' ] ``` ##### JavaScript (Node.js) ```javascript const res12 = await client.hSet( 'myhash', { 'field1': 'Hello', 'field2': 'World' } ) // HVALS follows the hash's field order, which Redis does not promise, so sort. const res13 = (await client.hVals('myhash')).sort() console.log(res13) // [ 'Hello', 'World' ] ``` ##### JavaScript (Node.js) ```javascript await redis.hset('myhash', { field1: 'Hello', field2: 'World' }); // HVALS follows the hash's field order, which Redis does not promise, so sort. const hvalsRes = await redis.hvals('myhash'); console.log(hvalsRes.sort()); // >>> [ 'Hello', 'World' ] ``` ##### PHP ```php $hValsResult1 = $this->redis->hmset('myhash', ['field1' => 'Hello', 'field2' => 'World']); echo "HMSET myhash field1 Hello field2 World: " . ($hValsResult1 ? 'OK' : 'FAIL') . "\n"; // >>> OK // HVALS follows the hash's field order, which Redis does not promise, so sort. $hValsResult2 = $this->redis->hvals('myhash'); sort($hValsResult2); echo "HVALS myhash: " . json_encode($hValsResult2) . "\n"; // >>> ["Hello","World"] ``` ##### Python ```python res10 = r.hset("myhash", mapping={"field1": "Hello", "field2": "World"}) # HVALS follows the hash's field order, which Redis does not promise, so sort. res11 = r.hvals("myhash") print(sorted(res11)) # >>> [ "Hello", "World" ] ``` ##### Ruby ```ruby r.hset('myhash', { 'field1' => 'Hello', 'field2' => 'World' }) # HVALS follows the hash's field order, which Redis does not promise, so sort. res15 = r.hvals('myhash').sort puts res15.inspect # >>> ["Hello", "World"] ``` ##### Rust (Asynchronous) ```rust let hash_fields = [ ("field1", "Hello"), ("field2", "World"), ]; if let Ok(_) = r.hset_multiple::<&str, &str, &str, String>("myhash", &hash_fields).await { // Fields set successfully } match r.hvals("myhash").await { Ok(res11) => { let res11: Vec = res11; println!("{res11:?}"); // >>> ["Hello", "World"] }, Err(e) => { println!("Error getting hash values: {e}"); return; } } ``` ##### Rust (Synchronous) ```rust let hash_fields = [ ("field1", "Hello"), ("field2", "World"), ]; if let Ok(_) = r.hset_multiple::<&str, &str, &str, String>("myhash", &hash_fields) { // Fields set successfully } match r.hvals("myhash") { Ok(res11) => { let res11: Vec = res11; println!("{res11:?}"); // >>> ["Hello", "World"] }, Err(e) => { println!("Error getting hash values: {e}"); return; } } ``` ## Redis Software and Redis Cloud compatibility | Redis
Software | Redis
Cloud | Notes | |:----------------------|:-----------------|:------| | ✅ Standard
✅ Active-Active | ✅ Standard
✅ Active-Active | | ## Return information **RESP2:** [Array reply](../../develop/reference/protocol-spec#arrays): a list of values in the hash, or an empty list when the key does not exist **RESP3:** [Array reply](../../develop/reference/protocol-spec#arrays): a list of values in the hash, or an empty list when the key does not exist.