SADD 

SADD key member [member ...]
Available since:
Redis Open Source 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,
Compatibility:
Redis Software and Redis Cloud compatibility

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.

Required arguments

key

The name of the key that holds the set.

member [member ...]

One or more members to add to the set.

Examples

Foundational: Add one or more members to a set using SADD (creates set if needed, ignores duplicates, returns count of new members)
SADD myset "Hello" "World" SADD myset "World" SMEMBERS myset
Redis CLI guide
Also, check out our other client tools Redis Insight and Redis for VS Code. 
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'}
Python Quick-Start 
const res1 = await client.sAdd('myset', ['Hello', 'World']);
console.log(res1);  // 2

const res2 = await client.sAdd('myset', ['World']);
console.log(res2);  // 0

const res3 = await client.sMembers('myset')
console.log(res3);  // ['Hello', 'World']
Node.js Quick-Start 
const res1 = await redis.sadd('myset', 'Hello', 'World');
console.log(res1); // >>> 2

const res2 = await redis.sadd('myset', 'World');
console.log(res2); // >>> 0

const res3 = await redis.smembers('myset');
console.log(res3); // >>> ['Hello', 'World']
ioredis Quick-Start 
        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]
Java-Sync Quick-Start 
            CompletableFuture<Void> sadd = asyncCommands.sadd("myset", "Hello").thenCompose(r -> {
                System.out.println(r); // >>> 1
                return asyncCommands.sadd("myset", "World");
            }).thenCompose(r -> {
                System.out.println(r); // >>> 1
                return asyncCommands.sadd("myset", "World");
            }).thenCompose(r -> {
                System.out.println(r); // >>> 0
                return asyncCommands.smembers("myset");
            })
                    .thenAccept(System.out::println)
                    // >>> [Hello, World]
                    .toCompletableFuture();
Java-Async Quick-Start 
            Mono<Void> sadd = reactiveCommands.sadd("myset", "Hello").doOnNext(r -> {
                System.out.println(r); // >>> 1
            }).flatMap(r -> reactiveCommands.sadd("myset", "World")).doOnNext(r -> {
                System.out.println(r); // >>> 1
            }).flatMap(r -> reactiveCommands.sadd("myset", "World")).doOnNext(r -> {
                System.out.println(r); // >>> 0
            }).flatMap(r -> reactiveCommands.smembers("myset").collectList()).doOnNext(r -> {
                System.out.println(r); // >>> [Hello, World]
            }).then();
Java-Reactive Quick-Start 
	sAddResult1, err := rdb.SAdd(ctx, "myset", "Hello").Result()

	if err != nil {
		panic(err)
	}

	fmt.Println(sAddResult1) // >>> 1

	sAddResult2, err := rdb.SAdd(ctx, "myset", "World").Result()

	if err != nil {
		panic(err)
	}

	fmt.Println(sAddResult2) // >>> 1

	sAddResult3, err := rdb.SAdd(ctx, "myset", "World").Result()

	if err != nil {
		panic(err)
	}

	fmt.Println(sAddResult3) // >>> 0

	sMembersResult, err := rdb.SMembers(ctx, "myset").Result()

	if err != nil {
		panic(err)
	}

	fmt.Println(sMembersResult) // >>> [Hello World]
Go Quick-Start 
        bool sAddResult1 = db.SetAdd("myset", "Hello");
        Console.WriteLine(sAddResult1); // >>> True

        bool sAddResult2 = db.SetAdd("myset", "World");
        Console.WriteLine(sAddResult2); // >>> True

        bool sAddResult3 = db.SetAdd("myset", "World");
        Console.WriteLine(sAddResult2); // >>> False

        RedisValue[] sAddResult4 = db.SetMembers("myset");
        Array.Sort(sAddResult4);
        Console.WriteLine(string.Join(", ", sAddResult4));
        // >>> Hello, World
C#-Sync (SE.Redis) Quick-Start 
        $res1 = $r->sadd('myset', ['Hello', 'World']);
        echo $res1 . PHP_EOL;
        // >>> 2

        $res2 = $r->sadd('myset', ['World']);
        echo $res2 . PHP_EOL;
        // >>> 0

        $res3 = $r->smembers('myset');
        sort($res3);
        echo json_encode($res3) . PHP_EOL;
        // >>> ["Hello","World"]
PHP Quick-Start 
res1 = r.sadd('myset', ['Hello', 'World'])
puts res1 # >>> 2

res2 = r.sadd('myset', ['World'])
puts res2 # >>> 0

res3 = r.smembers('myset')
puts res3.inspect # >>> ["Hello", "World"]
Ruby Quick-Start 
        if let Ok(res1) = r.sadd("myset", &["Hello", "World"]) {
            let res1: i32 = res1;
            println!("{res1}"); // >>> 2
        }

        if let Ok(res2) = r.sadd("myset", "World") {
            let res2: i32 = res2;
            println!("{res2}"); // >>> 0
        }

        if let Ok(res3) = r.smembers("myset") {
            let res3: HashSet<String> = res3;
            println!("{res3:?}"); // >>> {"Hello", "World"}
        }
Rust-Sync Quick-Start 
        if let Ok(res1) = r.sadd("myset", &["Hello", "World"]).await {
            let res1: i32 = res1;
            println!("{res1}"); // >>> 2
        }

        if let Ok(res2) = r.sadd("myset", "World").await {
            let res2: i32 = res2;
            println!("{res2}"); // >>> 0
        }

        if let Ok(res3) = r.smembers("myset").await {
            let res3: HashSet<String> = res3;
            println!("{res3:?}"); // >>> {"Hello", "World"}
        }
Rust-Async Quick-Start

Redis Software and Redis Cloud compatibility

Redis
Software		 Redis
Cloud		 Notes
✅ Standard
✅ Active-Active		 ✅ Standard
✅ Active-Active

Return information

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.
RATE THIS PAGE
Back to top ↑