SADD

Syntax

SADD key member [member ...]

Available since:: 1.0.0
Time complexity:: O(1) for each element added, so O(N) to add N elements when the command is called with multiple arguments.
ACL categories:: @write, @set, @fast,

Add the specified members to the set stored at key. Specified members that are already a member of this set are ignored. If key does not exist, a new set is created before adding the specified members.

An error is returned when the value stored at key is not a set.

Examples

>_ Redis CLI

redis> SADD myset "Hello"
(integer) 1
redis> SADD myset "World"
(integer) 1
redis> SADD myset "World"
(integer) 0
redis> SMEMBERS myset
1) "Hello"
2) "World"

Python

import redis

r = redis.Redis(decode_responses=True)

res1 = r.sadd("myset", "Hello", "World")
print(res1)  # >>> 2

res2 = r.sadd("myset", "World")
print(res2)  # >>> 0

res3 = r.smembers("myset")
print(res3)  # >>> {'Hello', 'World'}


res4 = r.sadd("myset", "Hello", "World")
print(res4)  # >>> 2

res5 = r.smembers("myset")
print(res5)  # >>> {'Hello', 'World'}

Java-Sync

import static java.util.stream.Collectors.toList;

import java.util.Set;

import redis.clients.jedis.UnifiedJedis;

public class CmdsSetExample {

    public void run() {
        UnifiedJedis jedis = new UnifiedJedis("redis://localhost:6379");

        long sAddResult1 = jedis.sadd("myset", "Hello");
        System.out.println(sAddResult1); // >>> 1

        long sAddResult2 = jedis.sadd("myset", "World");
        System.out.println(sAddResult2); // >>> 1

        long sAddResult3 = jedis.sadd("myset", "World");
        System.out.println(sAddResult3); // >>> 0

        Set<String> sAddResult4 = jedis.smembers("myset");
        System.out.println(sAddResult4.stream().sorted().collect(toList()));
        // >>> [Hello, World]

        long sMembersResult1 = jedis.sadd("myset", "Hello", "World");
        System.out.println(sMembersResult1); // >>> 2

        Set<String> sMembersResult2 = jedis.smembers("myset");
        System.out.println(sMembersResult2.stream().sorted().collect(toList()));
        // >>> [Hello, World]

        jedis.close();
    }
}

Give these commands a try in the interactive console:

redis> SADD myset "Hello"
(nil)
redis> SADD myset "World"
(integer) 5
redis> SADD myset "World"
1) "mylist"
2) 1) "five"
redis> SMEMBERS myset
1) "four"
2) "three"
3) "two"
4) "one"

redis>

RESP2/RESP3 Reply

Integer reply: the number of elements that were added to the set, not including all the elements already present in the set.

History

Starting with Redis version 2.4.0: Accepts multiple member arguments.

Products

Tools

Get Redis

Connect

Learn

Latest

See how it works

SADD

Examples

RESP2/RESP3 Reply

History