HLEN for field count in Redis - Step-by-Step Execution

Concept Flow - HLEN for field count

Start with a Redis hash key

↓

Send HLEN command with the key

↓

Redis checks the hash stored at the key

↓

Count the number of fields in the hash

↓

Return the count as an integer

↓

End

HLEN command counts how many fields are inside a Redis hash stored at a given key and returns that number.

Execution Sample

Redis

HSET user:1 name "Alice" age 30 city "NY"
HLEN user:1

This sets three fields in a hash 'user:1' and then counts how many fields it has.

Execution Table

Step	Command	Action	Hash Fields	Result
1	HSET user:1 name "Alice" age 30 city "NY"	Create hash user:1 with fields name, age, city	{"name":"Alice", "age":"30", "city":"NY"}	3
2	HLEN user:1	Count fields in hash user:1	{"name":"Alice", "age":"30", "city":"NY"}	3
3	HLEN user:2	Key user:2 does not exist	{}	0

💡 HLEN returns the number of fields in the hash or 0 if the key does not exist.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3
user:1 hash fields	none	{"name":"Alice", "age":"30", "city":"NY"}	{"name":"Alice", "age":"30", "city":"NY"}	{"name":"Alice", "age":"30", "city":"NY"}
user:2 hash fields	none	none	none	none

Key Moments - 2 Insights

Why does HLEN return 0 when the key does not exist?

Because Redis treats a non-existing hash as empty, so the field count is zero, as shown in execution_table row 3.

Does HLEN count the values or the fields in the hash?

HLEN counts the number of fields (keys) in the hash, not the values, as shown in execution_table rows 1 and 2.

Visual Quiz - 3 Questions

Look at the execution_table, what is the result of HLEN user:1 at step 2?

A 0

B 3

C 1

D Error

💡 Hint

Check the 'Result' column in execution_table row 2.

At which step does Redis return 0 because the key does not exist?

A Step 1

B Step 2

C Step 3

D Never

💡 Hint

Look at the 'Action' and 'Result' columns in execution_table row 3.

If we add a new field to user:1, how will the HLEN result change?

A It will increase by 1

B It will stay the same

C It will decrease by 1

D It will return an error

💡 Hint

Refer to variable_tracker showing how fields count changes after adding fields.

Concept Snapshot

HLEN key
Returns the number of fields in the hash stored at key.
If key does not exist, returns 0.
Used to quickly count how many fields a hash has.

Full Transcript

The HLEN command in Redis counts how many fields are inside a hash stored at a given key. When you run HLEN with a key, Redis looks up the hash and returns the number of fields it contains. If the key does not exist, Redis returns 0 because it treats the missing hash as empty. For example, if you create a hash with three fields and then run HLEN on it, you get 3. If you check a key that does not exist, you get 0. This helps you quickly know how many fields are in a hash without retrieving all data.

Practice

1. What does the Redis command HLEN do when used on a hash key?

easy

A. It deletes the hash key from the database.

B. It returns the number of fields in the hash.

C. It returns the total number of keys in the database.

D. It returns the value of the first field in the hash.

Solution

1. Step 1: Understand the purpose of HLEN

   The HLEN command is designed to count how many fields exist inside a given hash key in Redis.

2. Step 2: Compare with other Redis commands

   Unlike commands that count keys or delete data, HLEN specifically returns the count of fields inside a hash.

3. Final Answer:

   It returns the number of fields in the hash. -> Option B

4. Quick Check:

   HLEN = field count [OK]

Hint: HLEN counts fields inside a hash, not keys or values [OK]

Common Mistakes:

• Confusing HLEN with commands that count keys
• Thinking HLEN returns field values
• Assuming HLEN deletes data

2. Which of the following is the correct syntax to get the number of fields in a Redis hash named user:1000?

easy

A. HLEN['user:1000']

B. HLEN(user:1000)

C. HLEN user:1000

D. HLEN user:1000 fields

Solution

1. Step 1: Recall Redis command syntax

   Redis commands use the format COMMAND key without parentheses or brackets.

2. Step 2: Identify correct syntax for HLEN

   The correct syntax is simply HLEN key, so HLEN user:1000 is valid.

3. Final Answer:

   HLEN user:1000 -> Option C

4. Quick Check:

   HLEN key [OK]

Hint: Use HLEN followed by the key name without extra symbols [OK]

Common Mistakes:

• Adding parentheses or brackets
• Appending extra words after the key
• Using incorrect command format

3. Given the following Redis commands executed in order:

HSET product:1 name "Laptop" price "1200" stock "30"
HLEN product:1

What will be the output of the HLEN product:1 command?

medium

A. 3

B. 1

C. 0

D. Error

Solution

1. Step 1: Count fields added by HSET

   The HSET command adds three fields: name, price, and stock to the hash product:1.

2. Step 2: Use HLEN to count fields

   HLEN returns the number of fields in the hash, which is 3 in this case.

3. Final Answer:

   3 -> Option A

4. Quick Check:

   HLEN counts fields = 3 [OK]

Hint: Count fields set by HSET, HLEN returns that count [OK]

Common Mistakes:

• Confusing field count with values
• Expecting HLEN to return 1 for one HSET command
• Assuming HLEN returns 0 if fields exist

4. You run the command HLEN session:123 but get 0. What is the most likely reason?

medium

A. Redis server is down.

B. HLEN command syntax is incorrect.

C. HLEN cannot be used on hashes.

D. The key session:123 does not exist in Redis.

Solution

1. Step 1: Understand HLEN behavior on missing keys

   If the hash key does not exist or is empty, HLEN returns 0.

2. Step 2: Check cause

   A result of 0 when expecting fields most likely means the key session:123 does not exist in Redis.

3. Final Answer:

   The key session:123 does not exist in Redis. -> Option D

4. Quick Check:

   HLEN missing key = 0 [OK]

Hint: Check if key exists before using HLEN [OK]

Common Mistakes:

• Assuming syntax error causes this
• Thinking HLEN can't be used on hashes
• Ignoring key existence

5. You have a Redis hash cart:567 with fields: item1, item2, and item3. You want to check if the cart is empty or not using HLEN. Which Redis command sequence correctly checks and prints "Empty" if no items, or "Has items" if there are fields?

hard

A. HLEN cart:567
IF result == 0 THEN print "Empty" ELSE print "Has items"

B. HLEN cart:567
IF result > 3 THEN print "Empty" ELSE print "Has items"

C. HLEN cart:567
IF result == -1 THEN print "Empty" ELSE print "Has items"

D. HLEN cart:567
IF result == 1 THEN print "Empty" ELSE print "Has items"

Solution

1. Step 1: Understand HLEN output

   HLEN returns the number of fields in the hash; 0 means empty, any positive number means fields exist.

2. Step 2: Use conditional check on HLEN result

   If HLEN result is 0, print "Empty"; otherwise, print "Has items".

3. Final Answer:

   HLEN cart:567 IF result == 0 THEN print "Empty" ELSE print "Has items" -> Option A

4. Quick Check:

   HLEN 0 means empty [OK]

Hint: Check if HLEN result equals zero to detect empty hash [OK]

Common Mistakes:

• Checking for wrong values like -1 or 1
• Using greater than 3 instead of zero
• Assuming HLEN returns boolean