Redis lists

Introduction to Redis lists

Redis lists are linked lists of string values. Redis lists are frequently used to:

• Implement stacks and queues.
• Build queue management for background worker systems.

Examples

• Treat a list like a queue (first in, first out):

  Language: >_ Redis CLI Python JavaScript (node-redis) Java-Sync Java-Async Go C#-Sync PHP

  Copied!

  Copied!

  Queue pattern: Use LPUSH to add items and RPOP to remove them in FIFO order when you need to process items in the order they were added

  > LPUSH bikes:repairs bike:1
  (integer) 1
  > LPUSH bikes:repairs bike:2
  (integer) 2
  > RPOP bikes:repairs
  "bike:1"
  > RPOP bikes:repairs
  "bike:2"

  ▼ Commands: LPUSH, RPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.
  • RPOP ( @write , @list , @fast )

    Returns and removes the last elements of a list. Deletes the list if the last element was popped.

  Redis CLI guide

  Also, check out our other client tools Redis Insight and Redis for VS Code.

  """
  Code samples for List doc pages:
      https://redis.io/docs/latest/develop/data-types/lists/
  """
  
  import redis
  
  r = redis.Redis(decode_responses=True)
  
  res1 = r.lpush("bikes:repairs", "bike:1")
  print(res1)  # >>> 1
  
  res2 = r.lpush("bikes:repairs", "bike:2")
  print(res2)  # >>> 2
  
  res3 = r.rpop("bikes:repairs")
  print(res3)  # >>> bike:1
  
  res4 = r.rpop("bikes:repairs")
  print(res4)  # >>> bike:2
  
  
  res5 = r.lpush("bikes:repairs", "bike:1")
  print(res5)  # >>> 1
  
  res6 = r.lpush("bikes:repairs", "bike:2")
  print(res6)  # >>> 2
  
  res7 = r.lpop("bikes:repairs")
  print(res7)  # >>> bike:2
  
  res8 = r.lpop("bikes:repairs")
  print(res8)  # >>> bike:1
  
  
  res9 = r.llen("bikes:repairs")
  print(res9)  # >>> 0
  
  
  res10 = r.lpush("bikes:repairs", "bike:1")
  print(res10)  # >>> 1
  
  res11 = r.lpush("bikes:repairs", "bike:2")
  print(res11)  # >>> 2
  
  res12 = r.lmove("bikes:repairs", "bikes:finished", "LEFT", "LEFT")
  print(res12)  # >>> 'bike:2'
  
  res13 = r.lrange("bikes:repairs", 0, -1)
  print(res13)  # >>> ['bike:1']
  
  res14 = r.lrange("bikes:finished", 0, -1)
  print(res14)  # >>> ['bike:2']
  
  
  r.delete("bikes:repairs")
  
  res15 = r.rpush("bikes:repairs", "bike:1")
  print(res15)  # >>> 1
  
  res16 = r.rpush("bikes:repairs", "bike:2")
  print(res16)  # >>> 2
  
  res17 = r.lpush("bikes:repairs", "bike:important_bike")
  print(res17)  # >>> 3
  
  res18 = r.lrange("bikes:repairs", 0, -1)
  print(res18)  # >>> ['bike:important_bike', 'bike:1', 'bike:2']
  
  
  r.delete("bikes:repairs")
  
  res19 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res19)  # >>> 3
  
  res20 = r.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike")
  print(res20)  # >>> 5
  
  res21 = r.lrange("bikes:repairs", 0, -1)
  print(
      res21
  )  # >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
  
  
  r.delete("bikes:repairs")
  
  res22 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res22)  # >>> 3
  
  res23 = r.rpop("bikes:repairs")
  print(res23)  # >>> 'bike:3'
  
  res24 = r.lpop("bikes:repairs")
  print(res24)  # >>> 'bike:1'
  
  res25 = r.rpop("bikes:repairs")
  print(res25)  # >>> 'bike:2'
  
  res26 = r.rpop("bikes:repairs")
  print(res26)  # >>> None
  
  
  res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res27)  # >>> 5
  
  res28 = r.ltrim("bikes:repairs", 0, 2)
  print(res28)  # >>> True
  
  res29 = r.lrange("bikes:repairs", 0, -1)
  print(res29)  # >>> ['bike:1', 'bike:2', 'bike:3']
  
  
  r.delete("bikes:repairs")
  
  res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res27)  # >>> 5
  
  res28 = r.ltrim("bikes:repairs", -3, -1)
  print(res28)  # >>> True
  
  res29 = r.lrange("bikes:repairs", 0, -1)
  print(res29)  # >>> ['bike:3', 'bike:4', 'bike:5']
  
  
  r.delete("bikes:repairs")
  
  res31 = r.rpush("bikes:repairs", "bike:1", "bike:2")
  print(res31)  # >>> 2
  
  res32 = r.brpop("bikes:repairs", timeout=1)
  print(res32)  # >>> ('bikes:repairs', 'bike:2')
  
  res33 = r.brpop("bikes:repairs", timeout=1)
  print(res33)  # >>> ('bikes:repairs', 'bike:1')
  
  res34 = r.brpop("bikes:repairs", timeout=1)
  print(res34)  # >>> None
  
  
  res35 = r.delete("new_bikes")
  print(res35)  # >>> 0
  
  res36 = r.lpush("new_bikes", "bike:1", "bike:2", "bike:3")
  print(res36)  # >>> 3
  
  
  r.delete("new_bikes")
  
  res37 = r.set("new_bikes", "bike:1")
  print(res37)  # >>> True
  
  res38 = r.type("new_bikes")
  print(res38)  # >>> 'string'
  
  try:
      res39 = r.lpush("new_bikes", "bike:2", "bike:3")
      # >>> redis.exceptions.ResponseError:
      # >>> WRONGTYPE Operation against a key holding the wrong kind of value
  except redis.exceptions.ResponseError as e:
      print(e)
  
  
  r.delete("bikes:repairs")
  
  r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res36)  # >>> 3
  
  res40 = r.exists("bikes:repairs")
  print(res40)  # >>> 1
  
  res41 = r.lpop("bikes:repairs")
  print(res41)  # >>> 'bike:3'
  
  res42 = r.lpop("bikes:repairs")
  print(res42)  # >>> 'bike:2'
  
  res43 = r.lpop("bikes:repairs")
  print(res43)  # >>> 'bike:1'
  
  res44 = r.exists("bikes:repairs")
  print(res44)  # >>> False
  
  
  r.delete("bikes:repairs")
  
  res45 = r.delete("bikes:repairs")
  print(res45)  # >>> 0
  
  res46 = r.llen("bikes:repairs")
  print(res46)  # >>> 0
  
  res47 = r.lpop("bikes:repairs")
  print(res47)  # >>> None
  
  
  r.delete("bikes:repairs")
  
  res48 = r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res48)  # >>> 5
  
  res49 = r.ltrim("bikes:repairs", 0, 2)
  print(res49)  # >>> True
  
  res50 = r.lrange("bikes:repairs", 0, -1)
  print(res50)  # >>> ['bike:5', 'bike:4', 'bike:3']
  
  

  ▼ Commands: LPUSH, RPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • lpush(
      • name: KeyT,
      • *values: FieldT
      ) → Union[Awaitable[int], int]
  • RPOP ( @write , @list , @fast )

    Returns and removes the last elements of a list. Deletes the list if the last element was popped.

    ▶ Method

    • rpop(
      • name: KeyT,
      • count: Optional[int] = None
      ) → Union[Awaitable[Union[str, List, None]], Union[str, List, None]]

  Python Quick-Start

  import { createClient } from 'redis';
  
  const client = createClient();
  await client.connect();
  
  const res1 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res1);  // 1
  
  const res2 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res2);  // 2
  
  const res3 = await client.rPop('bikes:repairs');
  console.log(res3);  // bike:1
  
  const res4 = await client.rPop('bikes:repairs');
  console.log(res4);  // bike:2
  
  
  const res5 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res5);  // 1
  
  const res6 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res6); // 2
  
  const res7 = await client.lPop('bikes:repairs');
  console.log(res7);  // bike:2
  
  const res8 = await client.lPop('bikes:repairs');
  console.log(res8);  // bike:1
  
  
  const res9 = await client.lLen('bikes:repairs');
  console.log(res9); // 0
  
  
  const res10 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res10);  // 1
  
  const res11 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res11);  // 2
  
  const res12 = await client.lMove('bikes:repairs', 'bikes:finished', 'LEFT', 'LEFT');
  console.log(res12);  // 'bike:2'
  
  const res13 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res13);  // ['bike:1']
  
  const res14 = await client.lRange('bikes:finished', 0, -1);
  console.log(res14);  // ['bike:2']
  
  
  await client.del('bikes:repairs');
  
  const res15 = await client.rPush('bikes:repairs', 'bike:1');
  console.log(res15);  // 1
  
  const res16 = await client.rPush('bikes:repairs', 'bike:2');
  console.log(res16);  // 2
  
  const res17 = await client.lPush('bikes:repairs', 'bike:important_bike');
  console.log(res17);  // 3
  
  const res18 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res18);  // ['bike:important_bike', 'bike:1', 'bike:2']
  
  
  await client.del('bikes:repairs');
  
  const res19 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res19);  // 3
  
  const res20 = await client.lPush(
    'bikes:repairs', ['bike:important_bike', 'bike:very_important_bike']
  );
  console.log(res20);  // 5
  
  const res21 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res21);  // ['bike:very_important_bike', 'bike:important_bike', 'bike:1', 'bike:2', 'bike:3']
  
  
  await client.del('bikes:repairs');
  
  const res22 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res22);  // 3
  
  const res23 = await client.rPop('bikes:repairs');
  console.log(res23);  // 'bike:3'
  
  const res24 = await client.lPop('bikes:repairs');
  console.log(res24);  // 'bike:1'
  
  const res25 = await client.rPop('bikes:repairs');
  console.log(res25);  // 'bike:2'
  
  const res26 = await client.rPop('bikes:repairs');
  console.log(res26);  // null
  
  
  const res27 = await client.lPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res27);  // 5
  
  const res28 = await client.lTrim('bikes:repairs', 0, 2);
  console.log(res28);  // OK
  
  const res29 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res29);  // ['bike:5', 'bike:4', 'bike:3']
  
  
  await client.del('bikes:repairs');
  
  const res27eol = await client.rPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res27eol);  // 5
  
  const res28eol = await client.lTrim('bikes:repairs', -3, -1);
  console.log(res28eol);  // 'OK'
  
  const res29eol = await client.lRange('bikes:repairs', 0, -1);
  console.log(res29eol);  // ['bike:3', 'bike:4', 'bike:5']
  
  
  await client.del('bikes:repairs');
  
  const res31 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2']);
  console.log(res31);  // 2
  
  const res32 = await client.brPop('bikes:repairs', 1);
  console.log(res32);  // { key: 'bikes:repairs', element: 'bike:2' }
  
  const res33 = await client.brPop('bikes:repairs', 1);
  console.log(res33);  // { key: 'bikes:repairs', element: 'bike:1' }
  
  const res34 = await client.brPop('bikes:repairs', 1);
  console.log(res34);  // null
  
  
  const res35 = await client.del('new_bikes');
  console.log(res35); // 0
  
  const res36 = await client.lPush('new_bikes', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res36); // 3
  
  
  await client.del('new_bikes');
  
  const res37 = await client.set('new_bikes', 'bike:1');
  console.log(res37);  // 'OK'
  
  const res38 = await client.type('new_bikes');
  console.log(res38);  // 'string'
  
  try {
    const res39 = await client.lPush('new_bikes', 'bike:2', 'bike:3');
    // redis.exceptions.ResponseError:
    // [SimpleError: WRONGTYPE Operation against a key holding the wrong kind of value]
  }
  catch(e){
    console.log(e);
  }
  
  
  await client.del('bikes:repairs');
  
  await client.lPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res36);  // 3
  
  const res40 = await client.exists('bikes:repairs')
  console.log(res40);  // 1
  
  const res41 = await client.lPop('bikes:repairs');
  console.log(res41);  // 'bike:3'
  
  const res42 = await client.lPop('bikes:repairs');
  console.log(res42);  // 'bike:2'
  
  const res43 = await client.lPop('bikes:repairs');
  console.log(res43);  // 'bike:1'
  
  const res44 = await client.exists('bikes:repairs');
  console.log(res44);  // 0
  
  
  await client.del('bikes:repairs');
  
  const res45 = await client.del('bikes:repairs');
  console.log(res45);  // 0
  
  const res46 = await client.lLen('bikes:repairs');
  console.log(res46);  // 0
  
  const res47 = await client.lPop('bikes:repairs');
  console.log(res47);  // null
  
  
  await client.del('bikes:repairs');
  
  const res48 = await client.lPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res48);  // 5
  
  const res49 = await client.lTrim('bikes:repairs', 0, 2);
  console.log(res49);  // 'OK'
  
  const res50 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res50);  // ['bike:5', 'bike:4', 'bike:3']
  
  
  await client.close();
  

  ▼ Commands: LPUSH, RPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • LPUSH(
      • key: RedisArgument,
      • elements: RedisVariadicArgument
      ) → Any
  • RPOP ( @write , @list , @fast )

    Returns and removes the last elements of a list. Deletes the list if the last element was popped.

    ▶ Method

    • RPOP(
      • key: RedisArgument
      ) → Any

  Node.js Quick-Start

  import redis.clients.jedis.UnifiedJedis;
  import redis.clients.jedis.args.ListDirection;
  import java.util.List;
  
  
  public class ListExample {
  
      public void run() {
          UnifiedJedis jedis = new UnifiedJedis("redis://localhost:6379");
  
  
          long res1 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res1);  // >>> 1
  
          long res2 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res2);  // >>> 2
  
          String res3 = jedis.rpop("bikes:repairs");
          System.out.println(res3);  // >>> bike:1
  
          String res4 = jedis.rpop("bikes:repairs");
          System.out.println(res4); // >>> bike:2
  
  
          long res5 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res5);  // >>> 1
  
          long res6 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res6);  // >>> 2
  
          String res7 = jedis.lpop("bikes:repairs");
          System.out.println(res7);  // >>> bike:2
  
          String res8 = jedis.lpop("bikes:repairs");
          System.out.println(res8);  // >>> bike:1
  
  
          long res9 = jedis.llen("bikes:repairs");
          System.out.println(res9);  // >>> 0
  
  
          long res10 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res10);  // >>> 1
  
          long res11 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res11);  // >>> 2
  
          String res12 = jedis.lmove("bikes:repairs", "bikes:finished", ListDirection.LEFT, ListDirection.LEFT);
          System.out.println(res12);  // >>> bike:2
  
          List<String> res13 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res13);  // >>> [bike:1]
  
          List<String> res14 = jedis.lrange("bikes:finished", 0, -1);
          System.out.println(res14);  // >>> [bike:2]
  
  
          jedis.del("bikes:repairs");
  
          long res15 = jedis.rpush("bikes:repairs", "bike:1");
          System.out.println(res15);  // >>> 1
  
          long res16 = jedis.rpush("bikes:repairs", "bike:2");
          System.out.println(res16);  // >>> 2
  
          long res17 = jedis.lpush("bikes:repairs", "bike:important_bike");
          System.out.println(res17);  // >>> 3
  
          List<String> res18 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res18);  // >>> [bike:important_bike, bike:1, bike:2]
  
  
          jedis.del("bikes:repairs");
          
          long res19 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res19);  // >>> 3
  
          long res20 = jedis.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike");
          System.out.println(res20);  // >>> 5
  
          List<String> res21 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res21);  // >>> [bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3]
  
  
          jedis.del("bikes:repairs");
  
          long res22 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res22);  // >>> 3
  
          String res23 = jedis.rpop("bikes:repairs");
          System.out.println(res23);  // >>> bike:3
  
          String res24 = jedis.lpop("bikes:repairs");
          System.out.println(res24);  // >>> bike:1
  
          String res25 = jedis.rpop("bikes:repairs");
          System.out.println(res25);  // >>> bike:2
  
          String res26 = jedis.rpop("bikes:repairs");
          System.out.println(res26);  // >>> null
  
  
          long res27 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res27);  // >>> 5
  
          String res28 = jedis.ltrim("bikes:repairs", 0, 2);
          System.out.println(res28);  // >>> OK
  
          List<String> res29 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res29);  // >>> [bike:1, bike:2, bike:3]
  
  
          jedis.del("bikes:repairs");
          
          res27 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res27);  // >>> 5
  
          res28 = jedis.ltrim("bikes:repairs", -3, -1);
          System.out.println(res2);  // >>> OK
  
          res29 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res29);  // >>> [bike:3, bike:4, bike:5]
  
  
          jedis.del("bikes:repairs");
  
          long res31 = jedis.rpush("bikes:repairs", "bike:1", "bike:2");
          System.out.println(res31);  // >>> 2
  
          List<String> res32 = jedis.brpop(1, "bikes:repairs");
          System.out.println(res32);  // >>> (bikes:repairs, bike:2)
  
          List<String>  res33 = jedis.brpop(1,"bikes:repairs");
          System.out.println(res33);  // >>> (bikes:repairs, bike:1)
  
          List<String>  res34 = jedis.brpop(1,"bikes:repairs");
          System.out.println(res34);  // >>> null
  
  
          jedis.del("new_bikes");
  
          long res36 = jedis.lpush("new_bikes", "bike:1", "bike:2", "bike:3");
          System.out.println(res36);  // >>> 3
  
  
          jedis.del("new_bikes");
          
          String res37 = jedis.set("new_bikes", "bike:1");
          System.out.println(res37);  // >>> OK
  
          String res38 = jedis.type("new_bikes");
          System.out.println(res38);  // >>> string
  
          try {
              long res39  = jedis.lpush("new_bikes", "bike:2", "bike:3");
          } catch (Exception e) {
              e.printStackTrace();
              // >>> redis.clients.jedis.exceptions.JedisDataException:
              // >>> WRONGTYPE Operation against a key holding the wrong kind of value
          }
  
  
          jedis.del("bikes:repairs");
  
          jedis.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res36);  // >>> 3
  
          boolean res40 = jedis.exists("bikes:repairs");
          System.out.println(res40);  // >>> true
  
          String res41 = jedis.lpop("bikes:repairs");
          System.out.println(res41);  // >>> bike:3
  
          String res42 = jedis.lpop("bikes:repairs");
          System.out.println(res42);  // >>> bike:2
  
          String res43 = jedis.lpop("bikes:repairs");
          System.out.println(res43);  // >>> bike:1
  
          boolean res44 = jedis.exists("bikes:repairs");
          System.out.println(res44);  // >>> false
  
  
          jedis.del("bikes:repairs");
  
          long res46 = jedis.llen("bikes:repairs");
          System.out.println(res46);  // >>> 0
  
          String res47 = jedis.lpop("bikes:repairs");
          System.out.println(res47);  // >>> null
  
  
          jedis.del("bikes:repairs");
  
          long res48 = jedis.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res48);  // >>> 5
  
          String res49 = jedis.ltrim("bikes:repairs", 0, 2);
          System.out.println(res49);  // >>> OK
  
          List<String> res50 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res50);  // >>> [bike:5, bike:4, bike:3]
  
  
          jedis.close();
      }
  }
  

  ▼ Commands: LPUSH, RPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Methods

    • lpush(
      • key: byte[],
      • strings: byte[]... // data to push
      ) → long // The number of elements inside the list after the push operation
    • lpush(
      • key: String,
      • strings: String... // data to push
      ) → long // The number of elements inside the list after the push operation
    • lpush(
      • key: String,
      • strings: String... // data to push
      ) → long // The number of elements inside the list after the push operation
  • RPOP ( @write , @list , @fast )

    Returns and removes the last elements of a list. Deletes the list if the last element was popped.

    ▶ Methods

    • rpop(
      • key: String
      ) → String // A list of count popped elements, or 'nil' when key does not exist.
    • rpop(
      • key: String,
      • count: int // return up to count elements
      ) → List<String> // A list of count popped elements, or 'nil' when key does not exist.
    • rpop(
      • key: String
      ) → String // A list of count popped elements, or 'nil' when key does not exist.
    • rpop(
      • key: String,
      • count: int // return up to count elements
      ) → List<String> // A list of count popped elements, or 'nil' when key does not exist.

  Java-Sync Quick-Start

  package io.redis.examples.async;
  
  import io.lettuce.core.*;
  import io.lettuce.core.api.async.RedisAsyncCommands;
  import io.lettuce.core.api.StatefulRedisConnection;
  
  import java.util.concurrent.CompletableFuture;
  
  public class ListExample {
  
      public void run() {
          RedisClient redisClient = RedisClient.create("redis://localhost:6379");
  
          try (StatefulRedisConnection<String, String> connection = redisClient.connect()) {
              RedisAsyncCommands<String, String> asyncCommands = connection.async();
  
              CompletableFuture<Void> queue = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res1 -> {
                  System.out.println(res1); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res2 -> {
                  System.out.println(res2); // >>> 2
  
                  return asyncCommands.rpop("bikes:repairs");
              }).thenCompose(res3 -> {
                  System.out.println(res3); // >>> bike:1
  
                  return asyncCommands.rpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> bike:2
                      .toCompletableFuture();
              queue.join();
  
              CompletableFuture<Void> stack = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res4 -> {
                  System.out.println(res4); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res5 -> {
                  System.out.println(res5); // >>> 2
  
                  return asyncCommands.lpop("bikes:repairs");
              }).thenCompose(res6 -> {
                  System.out.println(res6); // >>> bike:2
  
                  return asyncCommands.lpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> bike:1
                      .toCompletableFuture();
              stack.join();
  
              CompletableFuture<Void> llen = asyncCommands.llen("bikes:repairs")
                      .thenAccept(System.out::println) // >>> 0
                      .toCompletableFuture();
              llen.join();
  
              CompletableFuture<Void> lmovelrange = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res7 -> {
                  System.out.println(res7); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res8 -> {
                  System.out.println(res8); // >>> 2
  
                  return asyncCommands.lmove("bikes:repairs", "bikes:finished", LMoveArgs.Builder.leftLeft());
              }).thenCompose(res9 -> {
                  System.out.println(res9); // >>> bike:2
  
                  return asyncCommands.lrange("bikes:repairs", 0, -1);
              }).thenCompose(res10 -> {
                  System.out.println(res10); // >>> [bike:1]
  
                  return asyncCommands.lrange("bikes:finished", 0, -1);
              })
                      .thenAccept(System.out::println) // >>> [bike:2]
                      .toCompletableFuture();
              lmovelrange.join();
  
  
              CompletableFuture<Void> lpushrpush = asyncCommands.rpush("bikes:repairs", "bike:1").thenCompose(res11 -> {
                  System.out.println(res11); // >>> 1
  
                  return asyncCommands.rpush("bikes:repairs", "bike:2");
              }).thenCompose(res12 -> {
                  System.out.println(res12); // >>> 2
  
                  return asyncCommands.lpush("bikes:repairs", "bike:important_bike");
              }).thenCompose(res13 -> {
                  System.out.println(res13); // >>> 3
  
                  return asyncCommands.lrange("bikes:repairs", 0, -1);
              })
                      .thenAccept(System.out::println)
                      // >>> [bike:important_bike, bike:1, bike:2]
                      .toCompletableFuture();
              lpushrpush.join();
  
  
              CompletableFuture<Void> variadic = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res14 -> {
                          System.out.println(res14); // >>> 3
  
                          return asyncCommands.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike");
                      }).thenCompose(res15 -> {
                          System.out.println(res15); // >>> 5
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3]
                      .toCompletableFuture();
              variadic.join();
  
  
              CompletableFuture<Void> lpoprpop = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res16 -> {
                          System.out.println(res16); // >>> 3
  
                          return asyncCommands.rpop("bikes:repairs");
                      }).thenCompose(res17 -> {
                          System.out.println(res17); // >>> bike:3
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res18 -> {
                          System.out.println(res18); // >>> bike:1
  
                          return asyncCommands.rpop("bikes:repairs");
                      }).thenCompose(res19 -> {
                          System.out.println(res19); // >>> bike:2
  
                          return asyncCommands.rpop("bikes:repairs");
                      })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              lpoprpop.join();
  
              CompletableFuture<Void> ltrim = asyncCommands
                      .lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res20 -> {
                          System.out.println(res20); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", 0, 2);
                      }).thenCompose(res21 -> {
                          System.out.println(res21); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:5, bike:4, bike:3]
                      .toCompletableFuture();
              ltrim.join();
  
  
              CompletableFuture<Void> ltrimendoflist = asyncCommands
                      .rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res22 -> {
                          System.out.println(res22); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", -3, -1);
                      }).thenCompose(res23 -> {
                          System.out.println(res23); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:3, bike:4, bike:5]
                      .toCompletableFuture();
              ltrimendoflist.join();
  
  
              CompletableFuture<Void> brpop = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2").thenCompose(res24 -> {
                  System.out.println(res24); // >>> 2
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              }).thenCompose(res25 -> {
                  System.out.println(res25);
                  // >>> KeyValue[bikes:repairs, bike:2]
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              }).thenCompose(res26 -> {
                  System.out.println(res26);
                  // >>> KeyValue[bikes:repairs, bike:1]
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              brpop.join();
  
              CompletableFuture<Void> rule1 = asyncCommands.del("new_bikes").thenCompose(res27 -> {
                  System.out.println(res27); // >>> 0
  
                  return asyncCommands.lpush("new_bikes", "bike:1", "bike:2", "bike:3");
              })
                      .thenAccept(System.out::println) // >>> 3
                      .toCompletableFuture();
              rule1.join();
  
              CompletableFuture<Void> rule11 = asyncCommands.set("new_bikes_string", "bike:1").thenCompose(res28 -> {
                  System.out.println(res28); // >>> OK
  
                  return asyncCommands.type("new_bikes_string");
              }).thenCompose(res29 -> {
                  System.out.println(res29); // >>> string
  
                  return asyncCommands.lpush("new_bikes_string", "bike:2", "bike:3");
              }).handle((res, ex) -> {
                  if (ex == null) {
                      return res;
                  } else {
                      System.out.println(ex);
                      // >>> java.util.concurrent.CompletionException:
                      // >>> io.lettuce.core.RedisCommandExecutionException:
                      // >>> WRONGTYPE Operation against a key holding the wrong
                      // >>> kind of value
  
                      return -1L;
                  }
              })
                      .thenAccept(System.out::println) // >>> -1
                      .toCompletableFuture();
              rule11.join();
  
  
              CompletableFuture<Void> rule2 = asyncCommands.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res30 -> {
                          System.out.println(res30); // >>> 3
  
                          return asyncCommands.exists("bikes:repairs");
                      }).thenCompose(res31 -> {
                          System.out.println(res31); // >>> 1
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res32 -> {
                          System.out.println(res32); // >>> bike:3
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res33 -> {
                          System.out.println(res33); // >>> bike:2
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res34 -> {
                          System.out.println(res34); // >>> bike:1
  
                          return asyncCommands.exists("bikes:repairs");
                      })
                      .thenAccept(System.out::println) // >>> 0
                      .toCompletableFuture();
              rule2.join();
  
              CompletableFuture<Void> rule3 = asyncCommands.del("bikes:repairs").thenCompose(res35 -> {
                  System.out.println(res35); // >>> 0
  
                  return asyncCommands.llen("bikes:repairs");
              }).thenCompose(res36 -> {
                  System.out.println(res36); // >>> 0
  
                  return asyncCommands.lpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              rule3.join();
  
              CompletableFuture<Void> ltrim1 = asyncCommands
                      .lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res37 -> {
                          System.out.println(res37); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", 0, 2);
                      }).thenCompose(res38 -> {
                          System.out.println(res38); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println) // >>> [bike:5, bike:4, bike:3]
                      .toCompletableFuture();
              ltrim1.join();
          } finally {
              redisClient.shutdown();
          }
      }
  
  }
  

  ▼ Commands: LPUSH, RPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • lpush(
      • key: K, // the key.
      • values: V... // the value.
      ) → RedisFuture<Long> // Long integer-reply the length of the list after the push operations.
  • RPOP ( @write , @list , @fast )

    Returns and removes the last elements of a list. Deletes the list if the last element was popped.

    ▶ Methods

    • rpop(
      • key: K // the key.
      ) → RedisFuture<V> // List&lt;V&gt; array-reply list of the last count elements, or null when key does not exist. @since 6.1
    • rpop(
      • key: K, // the key.
      • count: long // the number of elements to return.
      ) → RedisFuture<List<V>> // List&lt;V&gt; array-reply list of the last count elements, or null when key does not exist. @since 6.1

  Java-Async Quick-Start

  package example_commands_test
  
  import (
  	"context"
  	"fmt"
  
  	"github.com/redis/go-redis/v9"
  )
  
  
  func ExampleClient_queue() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res1, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res1) // >>> 1
  
  	res2, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res2) // >>> 2
  
  	res3, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res3) // >>> bike:1
  
  	res4, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res4) // >>> bike:2
  
  }
  
  func ExampleClient_stack() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res5, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res5) // >>> 1
  
  	res6, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res6) // >>> 2
  
  	res7, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res7) // >>> bike:2
  
  	res8, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res8) // >>> bike:1
  
  }
  
  func ExampleClient_llen() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res9, err := rdb.LLen(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res9) // >>> 0
  
  }
  
  func ExampleClient_lmove_lrange() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res10, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res10) // >>> 1
  
  	res11, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res11) // >>> 2
  
  	res12, err := rdb.LMove(ctx, "bikes:repairs", "bikes:finished", "LEFT", "LEFT").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res12) // >>> bike:2
  
  	res13, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res13) // >>> [bike:1]
  
  	res14, err := rdb.LRange(ctx, "bikes:finished", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res14) // >>> [bike:2]
  
  }
  
  func ExampleClient_lpush_rpush() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res15, err := rdb.RPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res15) // >>> 1
  
  	res16, err := rdb.RPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res16) // >>> 2
  
  	res17, err := rdb.LPush(ctx, "bikes:repairs", "bike:important_bike").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res17) // >>> 3
  
  	res18, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res18) // >>> [bike:important_bike bike:1 bike:2]
  
  }
  
  func ExampleClient_variadic() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res19, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res19) // >>> 3
  
  	res20, err := rdb.LPush(ctx, "bikes:repairs", "bike:important_bike", "bike:very_important_bike").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res20) // >>> 5
  
  	res21, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res21) // >>> [bike:very_important_bike bike:important_bike bike:1 bike:2 bike:3]
  
  }
  
  func ExampleClient_lpop_rpop() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res22, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res22) // >>> 3
  
  	res23, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res23) // >>> bike:3
  
  	res24, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res24) // >>> bike:1
  
  	res25, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res25) // >>> bike:2
  
  	res26, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res26) // >>> <empty string>
  
  
  }
  
  func ExampleClient_ltrim() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res27, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res27) // >>> 5
  
  	res28, err := rdb.LTrim(ctx, "bikes:repairs", 0, 2).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res28) // >>> OK
  
  	res29, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res29) // >>> [bike:1 bike:2 bike:3]
  
  }
  
  func ExampleClient_ltrim_end_of_list() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res30, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res30) // >>> 5
  
  	res31, err := rdb.LTrim(ctx, "bikes:repairs", -3, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res31) // >>> OK
  
  	res32, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res32) // >>> [bike:3 bike:4 bike:5]
  
  }
  
  func ExampleClient_brpop() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res33, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res33) // >>> 2
  
  	res34, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res34) // >>> [bikes:repairs bike:2]
  
  	res35, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res35) // >>> [bikes:repairs bike:1]
  
  	res36, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res36) // >>> []
  
  }
  
  func ExampleClient_rule1() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res37, err := rdb.Del(ctx, "new_bikes").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res37) // >>> 0
  
  	res38, err := rdb.LPush(ctx, "new_bikes", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res38) // >>> 3
  
  }
  
  func ExampleClient_rule11() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "new_bikes")
  
  	res39, err := rdb.Set(ctx, "new_bikes", "bike:1", 0).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res39) // >>> OK
  
  	res40, err := rdb.Type(ctx, "new_bikes").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res40) // >>> string
  
  	res41, err := rdb.LPush(ctx, "new_bikes", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		fmt.Println(err)
  		// >>> WRONGTYPE Operation against a key holding the wrong kind of value
  	}
  
  	fmt.Println(res41)
  
  }
  
  func ExampleClient_rule2() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  	res42, err := rdb.LPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res42) // >>> 3
  
  	res43, err := rdb.Exists(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res43) // >>> 1
  
  	res44, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res44) // >>> bike:3
  
  	res45, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res45) // >>> bike:2
  
  	res46, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res46) // >>> bike:1
  
  	res47, err := rdb.Exists(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res47) // >>> 0
  
  }
  
  func ExampleClient_rule3() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res48, err := rdb.Del(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res48) // >>> 0
  
  	res49, err := rdb.LLen(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res49) // >>> 0
  
  	res50, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res50) // >>> <empty string>
  
  }
  
  func ExampleClient_ltrim1() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res51, err := rdb.LPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res51) // >>> 5
  
  	res52, err := rdb.LTrim(ctx, "bikes:repairs", 0, 2).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res52) // >>> OK
  
  	res53, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res53) // >>> [bike:5 bike:4 bike:3]
  
  }
  

  ▼ Commands: LPUSH, RPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • LPush(
      • ctx: context.Context,
      • key: string,
      • values: ...interface{}
      ) → *IntCmd
  • RPOP ( @write , @list , @fast )

    Returns and removes the last elements of a list. Deletes the list if the last element was popped.

    ▶ Method

    • RPop(
      • ctx: context.Context,
      • key: string
      ) → *StringCmd

  Go Quick-Start

  using NRedisStack;
  using StackExchange.Redis;
  
  public class ListExample
  {
      public void Run()
      {
          var muxer = ConnectionMultiplexer.Connect("localhost:6379");
          var db = muxer.GetDatabase();
  
  
          long res1 = db.ListLeftPush("bikes:repairs", "bike:1");
          Console.WriteLine(res1);    // >>> 1
  
          long res2 = db.ListLeftPush("bikes:repairs", "bike:2");
          Console.WriteLine(res2);    // >>> 2
  
          RedisValue res3 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res3);    // >>> "bike:1"
  
          RedisValue res4 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res4); // >>> "bike:2"
  
  
          long res5 = db.ListLeftPush("bikes:repairs", "bike:1");
          Console.WriteLine(res5);    // >>> 1
  
          long res6 = db.ListLeftPush("bikes:repairs", "bike:2");
          Console.WriteLine(res6);    // >>> 2
  
          RedisValue res7 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res7);    // >>> "bike:2"
  
          RedisValue res8 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res8);    // >>> "bike:1"
  
  
  
          long res9 = db.ListLength("bikes:repairs");
          Console.WriteLine(res9);    // >>> 0
  
  
  
          long res10 = db.ListLeftPush("{bikes}:repairs", "bike:1");
          Console.WriteLine(res10);   // >>> 1
  
          long res11 = db.ListLeftPush("{bikes}:repairs", "bike:2");
          Console.WriteLine(res11);   // >>> 2
  
          RedisValue res12 = db.ListMove("{bikes}:repairs", "{bikes}:finished", ListSide.Left, ListSide.Left);
          Console.Write(res12);   // >>> "bike:2"
  
          RedisValue[] res13 = db.ListRange("{bikes}:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res13));    // >>> "bike:1"
  
          RedisValue[] res14 = db.ListRange("{bikes}:finished", 0, -1);
          Console.WriteLine(string.Join(", ", res14));    // >>> "bike:2"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res15 = db.ListRightPush("bikes:repairs", "bike:1");
          Console.WriteLine(res15);   // >>> 1
  
          long res16 = db.ListRightPush("bikes:repairs", "bike:2");
          Console.WriteLine(res16);   // >>> 2
  
          long res17 = db.ListLeftPush("bikes:repairs", "bike:important_bike");
          Console.WriteLine(res17);   // >>> 3
  
          RedisValue[] res18 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res18));    // >>> "bike:important_bike, bike:1, bike:2"
  
  
          db.KeyDelete("bikes:repairs");
          
          long res19 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res19);   // >>> 3
  
          long res20 = db.ListLeftPush("bikes:repairs", ["bike:important_bike", "bike:very_important_bike"]);
          Console.WriteLine(res20);   // >>> 5
  
          RedisValue[] res21 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res21));
          // >>> "bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res22 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res22);   // >>> 3
  
          RedisValue res23 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res23);   // >>> "bike:3"
  
          RedisValue res24 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res24);   // >>> "bike:1"
  
          RedisValue res25 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res25);   // >>> "bike:2"
  
          RedisValue res26 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res26);   // >>> <Empty string>
  
  
          long res27 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res27);   // >>> 5
  
          db.ListTrim("bikes:repairs", 0, 2);
          RedisValue[] res28 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res28));    // "bike:5, bike:4, bike:3"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res29 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res29);   // >>> 5
  
          db.ListTrim("bikes:repairs", -3, -1);
          RedisValue[] res30 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res30));    // >>> "bike:3, bike:4, bike:5"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res31 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2"]);
          Console.WriteLine(res31);   // >>> 2
  
          Tuple<RedisKey, RedisValue>? res32 = db.BRPop(["bikes:repairs"], 1);
  
          if (res32 != null)
              Console.WriteLine($"{res32.Item1} -> {res32.Item2}"); // >>> "bikes:repairs -> bike:2"
  
          Tuple<RedisKey, RedisValue>? res33 = db.BRPop(["bikes:repairs"], 1);
  
          if (res33 != null)
              Console.WriteLine($"{res33.Item1} -> {res33.Item2}"); // >>> "bikes:repairs -> bike:1"
  
          Tuple<RedisKey, RedisValue>? res34 = db.BRPop(["bikes:repairs"], 1);
          Console.WriteLine(res34);   // >>> "Null"
  
  
          db.KeyDelete("new_bikes");
  
          long res36 = db.ListRightPush("new_bikes", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res36);   // >>> 3
  
  
          db.KeyDelete("new_bikes");
          
          bool res37 = db.StringSet("new_bikes", "bike:1");
          Console.WriteLine(res37);   // >>> True
  
          RedisType res38 = db.KeyType("new_bikes");
          Console.WriteLine(res38);   // >>> RedisType.String
  
          try
          {
              long res39 = db.ListRightPush("new_bikes", ["bike:2", "bike:3"]);
          }
          catch (Exception e)
          {
              Console.WriteLine(e);
          }
  
  
          db.KeyDelete("bikes:repairs");
  
          long res40 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res40);   // >>> 3
  
          bool res41 = db.KeyExists("bikes:repairs");
          Console.WriteLine(res41);   // >>> True
  
          RedisValue res42 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res42);   // >>> "bike:3"
  
          RedisValue res43 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res43);   // >>> "bike:2"
  
          RedisValue res44 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res44);   //  >>> "bike:1"
  
          bool res45 = db.KeyExists("bikes:repairs");
          Console.WriteLine(res45);   // >>> False
  
  
          db.KeyDelete("bikes:repairs");
  
          long res47 = db.ListLength("bikes:repairs");
          Console.WriteLine(res47);   // >>> 0
  
          RedisValue res48 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res48);   // >>> Null
  
  
          db.KeyDelete("bikes:repairs");
  
          long res49 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res49);   // >>> 5
  
          db.ListTrim("bikes:repairs", 0, 2);
          RedisValue[] res50 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res50));    // >>> "bike:5, bike:4, bike:3"
  
  
      }
  }
  

  ▼ Commands: LPUSH, RPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Methods

    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • value: RedisValue,
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the head of the list.
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the head of the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • value: RedisValue,
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the head of the list.
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
  • RPOP ( @write , @list , @fast )

    Returns and removes the last elements of a list. Deletes the list if the last element was popped.

    ▶ Methods

    • ListRightPop(
      • key: RedisKey,
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue // A span of contiguous elements from the list, or Null if no non-empty lists are found.
    • ListRightPop(
      • key: RedisKey,
      • count: long, // The maximum number of elements to pop from the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue[] // A span of contiguous elements from the list, or Null if no non-empty lists are found.
    • ListRightPop(
      • keys: RedisKey[], // The keys to look through for elements to pop.
      • count: long, // The maximum number of elements to pop from the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → ListPopResult // A span of contiguous elements from the list, or Null if no non-empty lists are found.
    • ListRightPop(
      • key: RedisKey,
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue // A span of contiguous elements from the list, or Null if no non-empty lists are found.
    • ListRightPop(
      • key: RedisKey,
      • count: long, // The maximum number of elements to pop from the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue[] // A span of contiguous elements from the list, or Null if no non-empty lists are found.

  C#-Sync Quick-Start

  <?php
  
  require 'vendor/autoload.php';
  
  use Predis\Client as PredisClient;
  
  class DtListTest
  {
      public function testDtList() {
          $r = new PredisClient([
              'scheme'   => 'tcp',
              'host'     => '127.0.0.1',
              'port'     => 6379,
              'password' => '',
              'database' => 0,
          ]);
  
          $res1 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res1 . PHP_EOL;
          // >>> 1
  
          $res2 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res2 . PHP_EOL;
          // >>> 2
  
          $res3 = $r->rpop('bikes:repairs');
          echo $res3 . PHP_EOL;
          // >>> bike:1
  
          $res4 = $r->rpop('bikes:repairs');
          echo $res4 . PHP_EOL;
          // >>> bike:2
  
          $res5 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res5 . PHP_EOL;
          // >>> 1
  
          $res6 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res6 . PHP_EOL;
          // >>> 2
  
          $res7 = $r->lpop('bikes:repairs');
          echo $res7 . PHP_EOL;
          // >>> bike:2
  
          $res8 = $r->lpop('bikes:repairs');
          echo $res8 . PHP_EOL;
          // >>> bike:1
  
          $res9 = $r->llen('bikes:repairs');
          echo $res9 . PHP_EOL;
          // >>> 0
  
          $res10 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res10 . PHP_EOL;
          // >>> 1
  
          $res11 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res11 . PHP_EOL;
          // >>> 2
  
          $res12 = $r->lmove('bikes:repairs', 'bikes:finished', 'LEFT', 'LEFT');
          echo $res12 . PHP_EOL;
          // >>> 'bike:2'
  
          $res13 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res13) . PHP_EOL;
          // >>> ['bike:1']
  
          $res14 = $r->lrange('bikes:finished', 0, -1);
          echo json_encode($res14) . PHP_EOL;
          // >>> ['bike:2']
  
          $r->del('bikes:repairs');
          
          $res15 = $r->rpush('bikes:repairs', 'bike:1');
          echo $res15 . PHP_EOL;
          // >>> 1
  
          $res16 = $r->rpush('bikes:repairs', 'bike:2');
          echo $res16 . PHP_EOL;
          // >>> 2
  
          $res17 = $r->lpush('bikes:repairs', 'bike:important_bike');
          echo $res17 . PHP_EOL;
          // >>> 3
  
          $res18 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res18) . PHP_EOL;
          // >>> ['bike:important_bike', 'bike:1', 'bike:2']
  
          $r->del('bikes:repairs');
  
          $res19 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res19 . PHP_EOL;
          // >>> 3
  
          $res20 = $r->lpush('bikes:repairs', 'bike:important_bike', 'bike:very_important_bike');
          echo $res20 . PHP_EOL;
          // >>> 5
  
          $res21 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res21) . PHP_EOL;
          // >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
  
          $r->del('bikes:repairs');
          
          $res22 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res22 . PHP_EOL;
          // >>> 3
  
          $res23 = $r->rpop('bikes:repairs');
          echo $res23 . PHP_EOL;
          // >>> 'bike:3'
  
          $res24 = $r->lpop('bikes:repairs');
          echo $res24 . PHP_EOL;
          // >>> 'bike:1'
  
          $res25 = $r->rpop('bikes:repairs');
          echo $res25 . PHP_EOL;
          // >>> 'bike:2'
  
          $res26 = $r->rpop('bikes:repairs');
          echo $res26 . PHP_EOL;
          // >>> None
  
          $res27 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res27 . PHP_EOL;
          // >>> 5
  
          $res28 = $r->ltrim('bikes:repairs', 0, 2);
          echo $res28 . PHP_EOL;
          // >>> True
  
          $res29 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res29) . PHP_EOL;
          // >>> ['bike:1', 'bike:2', 'bike:3']
  
          $r->del('bikes:repairs');
  
          $res27 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res27 . PHP_EOL;
          // >>> 5
  
          $res28 = $r->ltrim('bikes:repairs', -3, -1);
          echo $res28 . PHP_EOL;
          // >>> True
  
          $res29 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res29) . PHP_EOL;
          // >>> ['bike:3', 'bike:4', 'bike:5']
  
          $r->del('bikes:repairs');
  
          $res31 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2');
          echo $res31 . PHP_EOL;
          // >>> 2
  
          $res32 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res32) . PHP_EOL;
          // >>> ['bikes:repairs', 'bike:2']
  
          $res33 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res33) . PHP_EOL;
          // >>> ['bikes:repairs', 'bike:1']
  
          $res34 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res34) . PHP_EOL;
          // >>> None
  
          $res35 = $r->del('new_bikes');
          echo $res35 . PHP_EOL;
          // >>> 0
  
          $res36 = $r->lpush('new_bikes', 'bike:1', 'bike:2', 'bike:3');
          echo $res36 . PHP_EOL;
          // >>> 3
  
          $r->del('new_bikes');
  
          $res37 = $r->set('new_bikes', 'bike:1');
          echo $res37 . PHP_EOL;
          // >>> True
  
          $res38 = $r->type('new_bikes');
          echo $res38 . PHP_EOL;
          // >>> 'string'
  
          try {
              $res39 = $r->lpush('new_bikes', 'bike:2', 'bike:3');
              // >>> redis.exceptions.ResponseError:
              // >>> WRONGTYPE Operation against a key holding the wrong kind of value
          } catch (\Predis\Response\ServerException $e) {
              echo $e->getMessage() . PHP_EOL;
          }
  
          $r->del('bikes:repairs');
          $res36 = $r->lpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res36 . PHP_EOL;
          // >>> 3
  
          $res40 = $r->exists('bikes:repairs');
          echo $res40 . PHP_EOL;
          // >>> 1
  
          $res41 = $r->lpop('bikes:repairs');
          echo $res41 . PHP_EOL;
          // >>> 'bike:3'
  
          $res42 = $r->lpop('bikes:repairs');
          echo $res42 . PHP_EOL;
          // >>> 'bike:2'
  
          $res43 = $r->lpop('bikes:repairs');
          echo $res43 . PHP_EOL;
          // >>> 'bike:1'
  
          $res44 = $r->exists('bikes:repairs');
          echo $res44 . PHP_EOL;
          // >>> False
  
          $res45 = $r->del('bikes:repairs');
          echo $res45 . PHP_EOL;
          // >>> 0
  
          $res46 = $r->llen('bikes:repairs');
          echo $res46 . PHP_EOL;
          // >>> 0
  
          $res47 = $r->lpop('bikes:repairs');
          echo $res47 . PHP_EOL;
          // >>> None
  
          $res48 = $r->lpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res48 . PHP_EOL;
          // >>> 5
  
          $res49 = $r->ltrim('bikes:repairs', 0, 2);
          echo $res49 . PHP_EOL;
          // >>> True
  
          $res50 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res50) . PHP_EOL;
          // >>> ['bike:5', 'bike:4', 'bike:3']
      }
  }
  
  

  ▼ Commands: LPUSH, RPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • lpush(
      • $key: string,
      • $values: array
      ) → int
  • RPOP ( @write , @list , @fast )

    Returns and removes the last elements of a list. Deletes the list if the last element was popped.

    ▶ Method

    • rpop(
      • $key: string
      ) → string|null

  PHP Quick-Start

• Treat a list like a stack (first in, last out):

  Language: >_ Redis CLI Python JavaScript (node-redis) Java-Sync Java-Async Go C#-Sync PHP

  Copied!

  Copied!

  Stack pattern: Use LPUSH to add items and LPOP to remove them in LIFO order when you need to process items in reverse order

  > LPUSH bikes:repairs bike:1
  (integer) 1
  > LPUSH bikes:repairs bike:2
  (integer) 2
  > LPOP bikes:repairs
  "bike:2"
  > LPOP bikes:repairs
  "bike:1"

  ▼ Commands: LPUSH, LPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.
  • LPOP ( @write , @list , @fast )

    Returns the first elements in a list after removing it. Deletes the list if the last element was popped.

  Redis CLI guide

  Also, check out our other client tools Redis Insight and Redis for VS Code.

  """
  Code samples for List doc pages:
      https://redis.io/docs/latest/develop/data-types/lists/
  """
  
  import redis
  
  r = redis.Redis(decode_responses=True)
  
  res1 = r.lpush("bikes:repairs", "bike:1")
  print(res1)  # >>> 1
  
  res2 = r.lpush("bikes:repairs", "bike:2")
  print(res2)  # >>> 2
  
  res3 = r.rpop("bikes:repairs")
  print(res3)  # >>> bike:1
  
  res4 = r.rpop("bikes:repairs")
  print(res4)  # >>> bike:2
  
  
  res5 = r.lpush("bikes:repairs", "bike:1")
  print(res5)  # >>> 1
  
  res6 = r.lpush("bikes:repairs", "bike:2")
  print(res6)  # >>> 2
  
  res7 = r.lpop("bikes:repairs")
  print(res7)  # >>> bike:2
  
  res8 = r.lpop("bikes:repairs")
  print(res8)  # >>> bike:1
  
  
  res9 = r.llen("bikes:repairs")
  print(res9)  # >>> 0
  
  
  res10 = r.lpush("bikes:repairs", "bike:1")
  print(res10)  # >>> 1
  
  res11 = r.lpush("bikes:repairs", "bike:2")
  print(res11)  # >>> 2
  
  res12 = r.lmove("bikes:repairs", "bikes:finished", "LEFT", "LEFT")
  print(res12)  # >>> 'bike:2'
  
  res13 = r.lrange("bikes:repairs", 0, -1)
  print(res13)  # >>> ['bike:1']
  
  res14 = r.lrange("bikes:finished", 0, -1)
  print(res14)  # >>> ['bike:2']
  
  
  r.delete("bikes:repairs")
  
  res15 = r.rpush("bikes:repairs", "bike:1")
  print(res15)  # >>> 1
  
  res16 = r.rpush("bikes:repairs", "bike:2")
  print(res16)  # >>> 2
  
  res17 = r.lpush("bikes:repairs", "bike:important_bike")
  print(res17)  # >>> 3
  
  res18 = r.lrange("bikes:repairs", 0, -1)
  print(res18)  # >>> ['bike:important_bike', 'bike:1', 'bike:2']
  
  
  r.delete("bikes:repairs")
  
  res19 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res19)  # >>> 3
  
  res20 = r.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike")
  print(res20)  # >>> 5
  
  res21 = r.lrange("bikes:repairs", 0, -1)
  print(
      res21
  )  # >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
  
  
  r.delete("bikes:repairs")
  
  res22 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res22)  # >>> 3
  
  res23 = r.rpop("bikes:repairs")
  print(res23)  # >>> 'bike:3'
  
  res24 = r.lpop("bikes:repairs")
  print(res24)  # >>> 'bike:1'
  
  res25 = r.rpop("bikes:repairs")
  print(res25)  # >>> 'bike:2'
  
  res26 = r.rpop("bikes:repairs")
  print(res26)  # >>> None
  
  
  res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res27)  # >>> 5
  
  res28 = r.ltrim("bikes:repairs", 0, 2)
  print(res28)  # >>> True
  
  res29 = r.lrange("bikes:repairs", 0, -1)
  print(res29)  # >>> ['bike:1', 'bike:2', 'bike:3']
  
  
  r.delete("bikes:repairs")
  
  res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res27)  # >>> 5
  
  res28 = r.ltrim("bikes:repairs", -3, -1)
  print(res28)  # >>> True
  
  res29 = r.lrange("bikes:repairs", 0, -1)
  print(res29)  # >>> ['bike:3', 'bike:4', 'bike:5']
  
  
  r.delete("bikes:repairs")
  
  res31 = r.rpush("bikes:repairs", "bike:1", "bike:2")
  print(res31)  # >>> 2
  
  res32 = r.brpop("bikes:repairs", timeout=1)
  print(res32)  # >>> ('bikes:repairs', 'bike:2')
  
  res33 = r.brpop("bikes:repairs", timeout=1)
  print(res33)  # >>> ('bikes:repairs', 'bike:1')
  
  res34 = r.brpop("bikes:repairs", timeout=1)
  print(res34)  # >>> None
  
  
  res35 = r.delete("new_bikes")
  print(res35)  # >>> 0
  
  res36 = r.lpush("new_bikes", "bike:1", "bike:2", "bike:3")
  print(res36)  # >>> 3
  
  
  r.delete("new_bikes")
  
  res37 = r.set("new_bikes", "bike:1")
  print(res37)  # >>> True
  
  res38 = r.type("new_bikes")
  print(res38)  # >>> 'string'
  
  try:
      res39 = r.lpush("new_bikes", "bike:2", "bike:3")
      # >>> redis.exceptions.ResponseError:
      # >>> WRONGTYPE Operation against a key holding the wrong kind of value
  except redis.exceptions.ResponseError as e:
      print(e)
  
  
  r.delete("bikes:repairs")
  
  r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res36)  # >>> 3
  
  res40 = r.exists("bikes:repairs")
  print(res40)  # >>> 1
  
  res41 = r.lpop("bikes:repairs")
  print(res41)  # >>> 'bike:3'
  
  res42 = r.lpop("bikes:repairs")
  print(res42)  # >>> 'bike:2'
  
  res43 = r.lpop("bikes:repairs")
  print(res43)  # >>> 'bike:1'
  
  res44 = r.exists("bikes:repairs")
  print(res44)  # >>> False
  
  
  r.delete("bikes:repairs")
  
  res45 = r.delete("bikes:repairs")
  print(res45)  # >>> 0
  
  res46 = r.llen("bikes:repairs")
  print(res46)  # >>> 0
  
  res47 = r.lpop("bikes:repairs")
  print(res47)  # >>> None
  
  
  r.delete("bikes:repairs")
  
  res48 = r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res48)  # >>> 5
  
  res49 = r.ltrim("bikes:repairs", 0, 2)
  print(res49)  # >>> True
  
  res50 = r.lrange("bikes:repairs", 0, -1)
  print(res50)  # >>> ['bike:5', 'bike:4', 'bike:3']
  
  

  ▼ Commands: LPUSH, LPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • lpush(
      • name: KeyT,
      • *values: FieldT
      ) → Union[Awaitable[int], int]
  • LPOP ( @write , @list , @fast )

    Returns the first elements in a list after removing it. Deletes the list if the last element was popped.

    ▶ Method

    • lpop(
      • name: KeyT,
      • count: Optional[int] = None
      ) → Union[Awaitable[Union[str, List, None]], Union[str, List, None]]

  Python Quick-Start

  import { createClient } from 'redis';
  
  const client = createClient();
  await client.connect();
  
  const res1 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res1);  // 1
  
  const res2 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res2);  // 2
  
  const res3 = await client.rPop('bikes:repairs');
  console.log(res3);  // bike:1
  
  const res4 = await client.rPop('bikes:repairs');
  console.log(res4);  // bike:2
  
  
  const res5 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res5);  // 1
  
  const res6 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res6); // 2
  
  const res7 = await client.lPop('bikes:repairs');
  console.log(res7);  // bike:2
  
  const res8 = await client.lPop('bikes:repairs');
  console.log(res8);  // bike:1
  
  
  const res9 = await client.lLen('bikes:repairs');
  console.log(res9); // 0
  
  
  const res10 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res10);  // 1
  
  const res11 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res11);  // 2
  
  const res12 = await client.lMove('bikes:repairs', 'bikes:finished', 'LEFT', 'LEFT');
  console.log(res12);  // 'bike:2'
  
  const res13 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res13);  // ['bike:1']
  
  const res14 = await client.lRange('bikes:finished', 0, -1);
  console.log(res14);  // ['bike:2']
  
  
  await client.del('bikes:repairs');
  
  const res15 = await client.rPush('bikes:repairs', 'bike:1');
  console.log(res15);  // 1
  
  const res16 = await client.rPush('bikes:repairs', 'bike:2');
  console.log(res16);  // 2
  
  const res17 = await client.lPush('bikes:repairs', 'bike:important_bike');
  console.log(res17);  // 3
  
  const res18 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res18);  // ['bike:important_bike', 'bike:1', 'bike:2']
  
  
  await client.del('bikes:repairs');
  
  const res19 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res19);  // 3
  
  const res20 = await client.lPush(
    'bikes:repairs', ['bike:important_bike', 'bike:very_important_bike']
  );
  console.log(res20);  // 5
  
  const res21 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res21);  // ['bike:very_important_bike', 'bike:important_bike', 'bike:1', 'bike:2', 'bike:3']
  
  
  await client.del('bikes:repairs');
  
  const res22 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res22);  // 3
  
  const res23 = await client.rPop('bikes:repairs');
  console.log(res23);  // 'bike:3'
  
  const res24 = await client.lPop('bikes:repairs');
  console.log(res24);  // 'bike:1'
  
  const res25 = await client.rPop('bikes:repairs');
  console.log(res25);  // 'bike:2'
  
  const res26 = await client.rPop('bikes:repairs');
  console.log(res26);  // null
  
  
  const res27 = await client.lPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res27);  // 5
  
  const res28 = await client.lTrim('bikes:repairs', 0, 2);
  console.log(res28);  // OK
  
  const res29 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res29);  // ['bike:5', 'bike:4', 'bike:3']
  
  
  await client.del('bikes:repairs');
  
  const res27eol = await client.rPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res27eol);  // 5
  
  const res28eol = await client.lTrim('bikes:repairs', -3, -1);
  console.log(res28eol);  // 'OK'
  
  const res29eol = await client.lRange('bikes:repairs', 0, -1);
  console.log(res29eol);  // ['bike:3', 'bike:4', 'bike:5']
  
  
  await client.del('bikes:repairs');
  
  const res31 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2']);
  console.log(res31);  // 2
  
  const res32 = await client.brPop('bikes:repairs', 1);
  console.log(res32);  // { key: 'bikes:repairs', element: 'bike:2' }
  
  const res33 = await client.brPop('bikes:repairs', 1);
  console.log(res33);  // { key: 'bikes:repairs', element: 'bike:1' }
  
  const res34 = await client.brPop('bikes:repairs', 1);
  console.log(res34);  // null
  
  
  const res35 = await client.del('new_bikes');
  console.log(res35); // 0
  
  const res36 = await client.lPush('new_bikes', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res36); // 3
  
  
  await client.del('new_bikes');
  
  const res37 = await client.set('new_bikes', 'bike:1');
  console.log(res37);  // 'OK'
  
  const res38 = await client.type('new_bikes');
  console.log(res38);  // 'string'
  
  try {
    const res39 = await client.lPush('new_bikes', 'bike:2', 'bike:3');
    // redis.exceptions.ResponseError:
    // [SimpleError: WRONGTYPE Operation against a key holding the wrong kind of value]
  }
  catch(e){
    console.log(e);
  }
  
  
  await client.del('bikes:repairs');
  
  await client.lPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res36);  // 3
  
  const res40 = await client.exists('bikes:repairs')
  console.log(res40);  // 1
  
  const res41 = await client.lPop('bikes:repairs');
  console.log(res41);  // 'bike:3'
  
  const res42 = await client.lPop('bikes:repairs');
  console.log(res42);  // 'bike:2'
  
  const res43 = await client.lPop('bikes:repairs');
  console.log(res43);  // 'bike:1'
  
  const res44 = await client.exists('bikes:repairs');
  console.log(res44);  // 0
  
  
  await client.del('bikes:repairs');
  
  const res45 = await client.del('bikes:repairs');
  console.log(res45);  // 0
  
  const res46 = await client.lLen('bikes:repairs');
  console.log(res46);  // 0
  
  const res47 = await client.lPop('bikes:repairs');
  console.log(res47);  // null
  
  
  await client.del('bikes:repairs');
  
  const res48 = await client.lPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res48);  // 5
  
  const res49 = await client.lTrim('bikes:repairs', 0, 2);
  console.log(res49);  // 'OK'
  
  const res50 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res50);  // ['bike:5', 'bike:4', 'bike:3']
  
  
  await client.close();
  

  ▼ Commands: LPUSH, LPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • LPUSH(
      • key: RedisArgument,
      • elements: RedisVariadicArgument
      ) → Any
  • LPOP ( @write , @list , @fast )

    Returns the first elements in a list after removing it. Deletes the list if the last element was popped.

    ▶ Method

    • LPOP(
      • key: RedisArgument
      ) → Any

  Node.js Quick-Start

  import redis.clients.jedis.UnifiedJedis;
  import redis.clients.jedis.args.ListDirection;
  import java.util.List;
  
  
  public class ListExample {
  
      public void run() {
          UnifiedJedis jedis = new UnifiedJedis("redis://localhost:6379");
  
  
          long res1 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res1);  // >>> 1
  
          long res2 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res2);  // >>> 2
  
          String res3 = jedis.rpop("bikes:repairs");
          System.out.println(res3);  // >>> bike:1
  
          String res4 = jedis.rpop("bikes:repairs");
          System.out.println(res4); // >>> bike:2
  
  
          long res5 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res5);  // >>> 1
  
          long res6 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res6);  // >>> 2
  
          String res7 = jedis.lpop("bikes:repairs");
          System.out.println(res7);  // >>> bike:2
  
          String res8 = jedis.lpop("bikes:repairs");
          System.out.println(res8);  // >>> bike:1
  
  
          long res9 = jedis.llen("bikes:repairs");
          System.out.println(res9);  // >>> 0
  
  
          long res10 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res10);  // >>> 1
  
          long res11 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res11);  // >>> 2
  
          String res12 = jedis.lmove("bikes:repairs", "bikes:finished", ListDirection.LEFT, ListDirection.LEFT);
          System.out.println(res12);  // >>> bike:2
  
          List<String> res13 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res13);  // >>> [bike:1]
  
          List<String> res14 = jedis.lrange("bikes:finished", 0, -1);
          System.out.println(res14);  // >>> [bike:2]
  
  
          jedis.del("bikes:repairs");
  
          long res15 = jedis.rpush("bikes:repairs", "bike:1");
          System.out.println(res15);  // >>> 1
  
          long res16 = jedis.rpush("bikes:repairs", "bike:2");
          System.out.println(res16);  // >>> 2
  
          long res17 = jedis.lpush("bikes:repairs", "bike:important_bike");
          System.out.println(res17);  // >>> 3
  
          List<String> res18 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res18);  // >>> [bike:important_bike, bike:1, bike:2]
  
  
          jedis.del("bikes:repairs");
          
          long res19 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res19);  // >>> 3
  
          long res20 = jedis.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike");
          System.out.println(res20);  // >>> 5
  
          List<String> res21 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res21);  // >>> [bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3]
  
  
          jedis.del("bikes:repairs");
  
          long res22 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res22);  // >>> 3
  
          String res23 = jedis.rpop("bikes:repairs");
          System.out.println(res23);  // >>> bike:3
  
          String res24 = jedis.lpop("bikes:repairs");
          System.out.println(res24);  // >>> bike:1
  
          String res25 = jedis.rpop("bikes:repairs");
          System.out.println(res25);  // >>> bike:2
  
          String res26 = jedis.rpop("bikes:repairs");
          System.out.println(res26);  // >>> null
  
  
          long res27 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res27);  // >>> 5
  
          String res28 = jedis.ltrim("bikes:repairs", 0, 2);
          System.out.println(res28);  // >>> OK
  
          List<String> res29 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res29);  // >>> [bike:1, bike:2, bike:3]
  
  
          jedis.del("bikes:repairs");
          
          res27 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res27);  // >>> 5
  
          res28 = jedis.ltrim("bikes:repairs", -3, -1);
          System.out.println(res2);  // >>> OK
  
          res29 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res29);  // >>> [bike:3, bike:4, bike:5]
  
  
          jedis.del("bikes:repairs");
  
          long res31 = jedis.rpush("bikes:repairs", "bike:1", "bike:2");
          System.out.println(res31);  // >>> 2
  
          List<String> res32 = jedis.brpop(1, "bikes:repairs");
          System.out.println(res32);  // >>> (bikes:repairs, bike:2)
  
          List<String>  res33 = jedis.brpop(1,"bikes:repairs");
          System.out.println(res33);  // >>> (bikes:repairs, bike:1)
  
          List<String>  res34 = jedis.brpop(1,"bikes:repairs");
          System.out.println(res34);  // >>> null
  
  
          jedis.del("new_bikes");
  
          long res36 = jedis.lpush("new_bikes", "bike:1", "bike:2", "bike:3");
          System.out.println(res36);  // >>> 3
  
  
          jedis.del("new_bikes");
          
          String res37 = jedis.set("new_bikes", "bike:1");
          System.out.println(res37);  // >>> OK
  
          String res38 = jedis.type("new_bikes");
          System.out.println(res38);  // >>> string
  
          try {
              long res39  = jedis.lpush("new_bikes", "bike:2", "bike:3");
          } catch (Exception e) {
              e.printStackTrace();
              // >>> redis.clients.jedis.exceptions.JedisDataException:
              // >>> WRONGTYPE Operation against a key holding the wrong kind of value
          }
  
  
          jedis.del("bikes:repairs");
  
          jedis.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res36);  // >>> 3
  
          boolean res40 = jedis.exists("bikes:repairs");
          System.out.println(res40);  // >>> true
  
          String res41 = jedis.lpop("bikes:repairs");
          System.out.println(res41);  // >>> bike:3
  
          String res42 = jedis.lpop("bikes:repairs");
          System.out.println(res42);  // >>> bike:2
  
          String res43 = jedis.lpop("bikes:repairs");
          System.out.println(res43);  // >>> bike:1
  
          boolean res44 = jedis.exists("bikes:repairs");
          System.out.println(res44);  // >>> false
  
  
          jedis.del("bikes:repairs");
  
          long res46 = jedis.llen("bikes:repairs");
          System.out.println(res46);  // >>> 0
  
          String res47 = jedis.lpop("bikes:repairs");
          System.out.println(res47);  // >>> null
  
  
          jedis.del("bikes:repairs");
  
          long res48 = jedis.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res48);  // >>> 5
  
          String res49 = jedis.ltrim("bikes:repairs", 0, 2);
          System.out.println(res49);  // >>> OK
  
          List<String> res50 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res50);  // >>> [bike:5, bike:4, bike:3]
  
  
          jedis.close();
      }
  }
  

  ▼ Commands: LPUSH, LPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Methods

    • lpush(
      • key: byte[],
      • strings: byte[]... // data to push
      ) → long // The number of elements inside the list after the push operation
    • lpush(
      • key: String,
      • strings: String... // data to push
      ) → long // The number of elements inside the list after the push operation
    • lpush(
      • key: String,
      • strings: String... // data to push
      ) → long // The number of elements inside the list after the push operation
  • LPOP ( @write , @list , @fast )

    Returns the first elements in a list after removing it. Deletes the list if the last element was popped.

    ▶ Methods

    • lpop(
      • key: String
      ) → String // A list of popped elements, or 'nil' when key does not exist
    • lpop(
      • key: String,
      • count: int
      ) → List<String> // A list of popped elements, or 'nil' when key does not exist
    • lpop(
      • key: String
      ) → String // A list of popped elements, or 'nil' when key does not exist
    • lpop(
      • key: String,
      • count: int
      ) → List<String> // A list of popped elements, or 'nil' when key does not exist

  Java-Sync Quick-Start

  package io.redis.examples.async;
  
  import io.lettuce.core.*;
  import io.lettuce.core.api.async.RedisAsyncCommands;
  import io.lettuce.core.api.StatefulRedisConnection;
  
  import java.util.concurrent.CompletableFuture;
  
  public class ListExample {
  
      public void run() {
          RedisClient redisClient = RedisClient.create("redis://localhost:6379");
  
          try (StatefulRedisConnection<String, String> connection = redisClient.connect()) {
              RedisAsyncCommands<String, String> asyncCommands = connection.async();
  
              CompletableFuture<Void> queue = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res1 -> {
                  System.out.println(res1); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res2 -> {
                  System.out.println(res2); // >>> 2
  
                  return asyncCommands.rpop("bikes:repairs");
              }).thenCompose(res3 -> {
                  System.out.println(res3); // >>> bike:1
  
                  return asyncCommands.rpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> bike:2
                      .toCompletableFuture();
              queue.join();
  
              CompletableFuture<Void> stack = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res4 -> {
                  System.out.println(res4); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res5 -> {
                  System.out.println(res5); // >>> 2
  
                  return asyncCommands.lpop("bikes:repairs");
              }).thenCompose(res6 -> {
                  System.out.println(res6); // >>> bike:2
  
                  return asyncCommands.lpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> bike:1
                      .toCompletableFuture();
              stack.join();
  
              CompletableFuture<Void> llen = asyncCommands.llen("bikes:repairs")
                      .thenAccept(System.out::println) // >>> 0
                      .toCompletableFuture();
              llen.join();
  
              CompletableFuture<Void> lmovelrange = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res7 -> {
                  System.out.println(res7); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res8 -> {
                  System.out.println(res8); // >>> 2
  
                  return asyncCommands.lmove("bikes:repairs", "bikes:finished", LMoveArgs.Builder.leftLeft());
              }).thenCompose(res9 -> {
                  System.out.println(res9); // >>> bike:2
  
                  return asyncCommands.lrange("bikes:repairs", 0, -1);
              }).thenCompose(res10 -> {
                  System.out.println(res10); // >>> [bike:1]
  
                  return asyncCommands.lrange("bikes:finished", 0, -1);
              })
                      .thenAccept(System.out::println) // >>> [bike:2]
                      .toCompletableFuture();
              lmovelrange.join();
  
  
              CompletableFuture<Void> lpushrpush = asyncCommands.rpush("bikes:repairs", "bike:1").thenCompose(res11 -> {
                  System.out.println(res11); // >>> 1
  
                  return asyncCommands.rpush("bikes:repairs", "bike:2");
              }).thenCompose(res12 -> {
                  System.out.println(res12); // >>> 2
  
                  return asyncCommands.lpush("bikes:repairs", "bike:important_bike");
              }).thenCompose(res13 -> {
                  System.out.println(res13); // >>> 3
  
                  return asyncCommands.lrange("bikes:repairs", 0, -1);
              })
                      .thenAccept(System.out::println)
                      // >>> [bike:important_bike, bike:1, bike:2]
                      .toCompletableFuture();
              lpushrpush.join();
  
  
              CompletableFuture<Void> variadic = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res14 -> {
                          System.out.println(res14); // >>> 3
  
                          return asyncCommands.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike");
                      }).thenCompose(res15 -> {
                          System.out.println(res15); // >>> 5
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3]
                      .toCompletableFuture();
              variadic.join();
  
  
              CompletableFuture<Void> lpoprpop = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res16 -> {
                          System.out.println(res16); // >>> 3
  
                          return asyncCommands.rpop("bikes:repairs");
                      }).thenCompose(res17 -> {
                          System.out.println(res17); // >>> bike:3
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res18 -> {
                          System.out.println(res18); // >>> bike:1
  
                          return asyncCommands.rpop("bikes:repairs");
                      }).thenCompose(res19 -> {
                          System.out.println(res19); // >>> bike:2
  
                          return asyncCommands.rpop("bikes:repairs");
                      })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              lpoprpop.join();
  
              CompletableFuture<Void> ltrim = asyncCommands
                      .lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res20 -> {
                          System.out.println(res20); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", 0, 2);
                      }).thenCompose(res21 -> {
                          System.out.println(res21); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:5, bike:4, bike:3]
                      .toCompletableFuture();
              ltrim.join();
  
  
              CompletableFuture<Void> ltrimendoflist = asyncCommands
                      .rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res22 -> {
                          System.out.println(res22); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", -3, -1);
                      }).thenCompose(res23 -> {
                          System.out.println(res23); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:3, bike:4, bike:5]
                      .toCompletableFuture();
              ltrimendoflist.join();
  
  
              CompletableFuture<Void> brpop = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2").thenCompose(res24 -> {
                  System.out.println(res24); // >>> 2
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              }).thenCompose(res25 -> {
                  System.out.println(res25);
                  // >>> KeyValue[bikes:repairs, bike:2]
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              }).thenCompose(res26 -> {
                  System.out.println(res26);
                  // >>> KeyValue[bikes:repairs, bike:1]
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              brpop.join();
  
              CompletableFuture<Void> rule1 = asyncCommands.del("new_bikes").thenCompose(res27 -> {
                  System.out.println(res27); // >>> 0
  
                  return asyncCommands.lpush("new_bikes", "bike:1", "bike:2", "bike:3");
              })
                      .thenAccept(System.out::println) // >>> 3
                      .toCompletableFuture();
              rule1.join();
  
              CompletableFuture<Void> rule11 = asyncCommands.set("new_bikes_string", "bike:1").thenCompose(res28 -> {
                  System.out.println(res28); // >>> OK
  
                  return asyncCommands.type("new_bikes_string");
              }).thenCompose(res29 -> {
                  System.out.println(res29); // >>> string
  
                  return asyncCommands.lpush("new_bikes_string", "bike:2", "bike:3");
              }).handle((res, ex) -> {
                  if (ex == null) {
                      return res;
                  } else {
                      System.out.println(ex);
                      // >>> java.util.concurrent.CompletionException:
                      // >>> io.lettuce.core.RedisCommandExecutionException:
                      // >>> WRONGTYPE Operation against a key holding the wrong
                      // >>> kind of value
  
                      return -1L;
                  }
              })
                      .thenAccept(System.out::println) // >>> -1
                      .toCompletableFuture();
              rule11.join();
  
  
              CompletableFuture<Void> rule2 = asyncCommands.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res30 -> {
                          System.out.println(res30); // >>> 3
  
                          return asyncCommands.exists("bikes:repairs");
                      }).thenCompose(res31 -> {
                          System.out.println(res31); // >>> 1
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res32 -> {
                          System.out.println(res32); // >>> bike:3
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res33 -> {
                          System.out.println(res33); // >>> bike:2
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res34 -> {
                          System.out.println(res34); // >>> bike:1
  
                          return asyncCommands.exists("bikes:repairs");
                      })
                      .thenAccept(System.out::println) // >>> 0
                      .toCompletableFuture();
              rule2.join();
  
              CompletableFuture<Void> rule3 = asyncCommands.del("bikes:repairs").thenCompose(res35 -> {
                  System.out.println(res35); // >>> 0
  
                  return asyncCommands.llen("bikes:repairs");
              }).thenCompose(res36 -> {
                  System.out.println(res36); // >>> 0
  
                  return asyncCommands.lpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              rule3.join();
  
              CompletableFuture<Void> ltrim1 = asyncCommands
                      .lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res37 -> {
                          System.out.println(res37); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", 0, 2);
                      }).thenCompose(res38 -> {
                          System.out.println(res38); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println) // >>> [bike:5, bike:4, bike:3]
                      .toCompletableFuture();
              ltrim1.join();
          } finally {
              redisClient.shutdown();
          }
      }
  
  }
  

  ▼ Commands: LPUSH, LPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • lpush(
      • key: K, // the key.
      • values: V... // the value.
      ) → RedisFuture<Long> // Long integer-reply the length of the list after the push operations.
  • LPOP ( @write , @list , @fast )

    Returns the first elements in a list after removing it. Deletes the list if the last element was popped.

    ▶ Methods

    • lpop(
      • key: K // the key.
      ) → RedisFuture<V> // @return List&lt;V&gt; array-reply list of the first count elements, or null when key does not exist. @since 6.1
    • lpop(
      • key: K, // the key.
      • count: long // the number of elements to return.
      ) → RedisFuture<List<V>> // @return List&lt;V&gt; array-reply list of the first count elements, or null when key does not exist. @since 6.1

  Java-Async Quick-Start

  package example_commands_test
  
  import (
  	"context"
  	"fmt"
  
  	"github.com/redis/go-redis/v9"
  )
  
  
  func ExampleClient_queue() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res1, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res1) // >>> 1
  
  	res2, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res2) // >>> 2
  
  	res3, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res3) // >>> bike:1
  
  	res4, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res4) // >>> bike:2
  
  }
  
  func ExampleClient_stack() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res5, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res5) // >>> 1
  
  	res6, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res6) // >>> 2
  
  	res7, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res7) // >>> bike:2
  
  	res8, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res8) // >>> bike:1
  
  }
  
  func ExampleClient_llen() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res9, err := rdb.LLen(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res9) // >>> 0
  
  }
  
  func ExampleClient_lmove_lrange() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res10, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res10) // >>> 1
  
  	res11, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res11) // >>> 2
  
  	res12, err := rdb.LMove(ctx, "bikes:repairs", "bikes:finished", "LEFT", "LEFT").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res12) // >>> bike:2
  
  	res13, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res13) // >>> [bike:1]
  
  	res14, err := rdb.LRange(ctx, "bikes:finished", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res14) // >>> [bike:2]
  
  }
  
  func ExampleClient_lpush_rpush() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res15, err := rdb.RPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res15) // >>> 1
  
  	res16, err := rdb.RPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res16) // >>> 2
  
  	res17, err := rdb.LPush(ctx, "bikes:repairs", "bike:important_bike").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res17) // >>> 3
  
  	res18, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res18) // >>> [bike:important_bike bike:1 bike:2]
  
  }
  
  func ExampleClient_variadic() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res19, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res19) // >>> 3
  
  	res20, err := rdb.LPush(ctx, "bikes:repairs", "bike:important_bike", "bike:very_important_bike").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res20) // >>> 5
  
  	res21, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res21) // >>> [bike:very_important_bike bike:important_bike bike:1 bike:2 bike:3]
  
  }
  
  func ExampleClient_lpop_rpop() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res22, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res22) // >>> 3
  
  	res23, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res23) // >>> bike:3
  
  	res24, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res24) // >>> bike:1
  
  	res25, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res25) // >>> bike:2
  
  	res26, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res26) // >>> <empty string>
  
  
  }
  
  func ExampleClient_ltrim() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res27, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res27) // >>> 5
  
  	res28, err := rdb.LTrim(ctx, "bikes:repairs", 0, 2).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res28) // >>> OK
  
  	res29, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res29) // >>> [bike:1 bike:2 bike:3]
  
  }
  
  func ExampleClient_ltrim_end_of_list() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res30, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res30) // >>> 5
  
  	res31, err := rdb.LTrim(ctx, "bikes:repairs", -3, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res31) // >>> OK
  
  	res32, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res32) // >>> [bike:3 bike:4 bike:5]
  
  }
  
  func ExampleClient_brpop() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res33, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res33) // >>> 2
  
  	res34, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res34) // >>> [bikes:repairs bike:2]
  
  	res35, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res35) // >>> [bikes:repairs bike:1]
  
  	res36, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res36) // >>> []
  
  }
  
  func ExampleClient_rule1() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res37, err := rdb.Del(ctx, "new_bikes").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res37) // >>> 0
  
  	res38, err := rdb.LPush(ctx, "new_bikes", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res38) // >>> 3
  
  }
  
  func ExampleClient_rule11() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "new_bikes")
  
  	res39, err := rdb.Set(ctx, "new_bikes", "bike:1", 0).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res39) // >>> OK
  
  	res40, err := rdb.Type(ctx, "new_bikes").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res40) // >>> string
  
  	res41, err := rdb.LPush(ctx, "new_bikes", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		fmt.Println(err)
  		// >>> WRONGTYPE Operation against a key holding the wrong kind of value
  	}
  
  	fmt.Println(res41)
  
  }
  
  func ExampleClient_rule2() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  	res42, err := rdb.LPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res42) // >>> 3
  
  	res43, err := rdb.Exists(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res43) // >>> 1
  
  	res44, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res44) // >>> bike:3
  
  	res45, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res45) // >>> bike:2
  
  	res46, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res46) // >>> bike:1
  
  	res47, err := rdb.Exists(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res47) // >>> 0
  
  }
  
  func ExampleClient_rule3() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res48, err := rdb.Del(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res48) // >>> 0
  
  	res49, err := rdb.LLen(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res49) // >>> 0
  
  	res50, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res50) // >>> <empty string>
  
  }
  
  func ExampleClient_ltrim1() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res51, err := rdb.LPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res51) // >>> 5
  
  	res52, err := rdb.LTrim(ctx, "bikes:repairs", 0, 2).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res52) // >>> OK
  
  	res53, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res53) // >>> [bike:5 bike:4 bike:3]
  
  }
  

  ▼ Commands: LPUSH, LPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • LPush(
      • ctx: context.Context,
      • key: string,
      • values: ...interface{}
      ) → *IntCmd
  • LPOP ( @write , @list , @fast )

    Returns the first elements in a list after removing it. Deletes the list if the last element was popped.

    ▶ Method

    • LPop(
      • ctx: context.Context,
      • key: string
      ) → *StringCmd

  Go Quick-Start

  using NRedisStack;
  using StackExchange.Redis;
  
  public class ListExample
  {
      public void Run()
      {
          var muxer = ConnectionMultiplexer.Connect("localhost:6379");
          var db = muxer.GetDatabase();
  
  
          long res1 = db.ListLeftPush("bikes:repairs", "bike:1");
          Console.WriteLine(res1);    // >>> 1
  
          long res2 = db.ListLeftPush("bikes:repairs", "bike:2");
          Console.WriteLine(res2);    // >>> 2
  
          RedisValue res3 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res3);    // >>> "bike:1"
  
          RedisValue res4 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res4); // >>> "bike:2"
  
  
          long res5 = db.ListLeftPush("bikes:repairs", "bike:1");
          Console.WriteLine(res5);    // >>> 1
  
          long res6 = db.ListLeftPush("bikes:repairs", "bike:2");
          Console.WriteLine(res6);    // >>> 2
  
          RedisValue res7 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res7);    // >>> "bike:2"
  
          RedisValue res8 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res8);    // >>> "bike:1"
  
  
  
          long res9 = db.ListLength("bikes:repairs");
          Console.WriteLine(res9);    // >>> 0
  
  
  
          long res10 = db.ListLeftPush("{bikes}:repairs", "bike:1");
          Console.WriteLine(res10);   // >>> 1
  
          long res11 = db.ListLeftPush("{bikes}:repairs", "bike:2");
          Console.WriteLine(res11);   // >>> 2
  
          RedisValue res12 = db.ListMove("{bikes}:repairs", "{bikes}:finished", ListSide.Left, ListSide.Left);
          Console.Write(res12);   // >>> "bike:2"
  
          RedisValue[] res13 = db.ListRange("{bikes}:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res13));    // >>> "bike:1"
  
          RedisValue[] res14 = db.ListRange("{bikes}:finished", 0, -1);
          Console.WriteLine(string.Join(", ", res14));    // >>> "bike:2"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res15 = db.ListRightPush("bikes:repairs", "bike:1");
          Console.WriteLine(res15);   // >>> 1
  
          long res16 = db.ListRightPush("bikes:repairs", "bike:2");
          Console.WriteLine(res16);   // >>> 2
  
          long res17 = db.ListLeftPush("bikes:repairs", "bike:important_bike");
          Console.WriteLine(res17);   // >>> 3
  
          RedisValue[] res18 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res18));    // >>> "bike:important_bike, bike:1, bike:2"
  
  
          db.KeyDelete("bikes:repairs");
          
          long res19 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res19);   // >>> 3
  
          long res20 = db.ListLeftPush("bikes:repairs", ["bike:important_bike", "bike:very_important_bike"]);
          Console.WriteLine(res20);   // >>> 5
  
          RedisValue[] res21 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res21));
          // >>> "bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res22 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res22);   // >>> 3
  
          RedisValue res23 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res23);   // >>> "bike:3"
  
          RedisValue res24 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res24);   // >>> "bike:1"
  
          RedisValue res25 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res25);   // >>> "bike:2"
  
          RedisValue res26 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res26);   // >>> <Empty string>
  
  
          long res27 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res27);   // >>> 5
  
          db.ListTrim("bikes:repairs", 0, 2);
          RedisValue[] res28 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res28));    // "bike:5, bike:4, bike:3"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res29 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res29);   // >>> 5
  
          db.ListTrim("bikes:repairs", -3, -1);
          RedisValue[] res30 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res30));    // >>> "bike:3, bike:4, bike:5"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res31 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2"]);
          Console.WriteLine(res31);   // >>> 2
  
          Tuple<RedisKey, RedisValue>? res32 = db.BRPop(["bikes:repairs"], 1);
  
          if (res32 != null)
              Console.WriteLine($"{res32.Item1} -> {res32.Item2}"); // >>> "bikes:repairs -> bike:2"
  
          Tuple<RedisKey, RedisValue>? res33 = db.BRPop(["bikes:repairs"], 1);
  
          if (res33 != null)
              Console.WriteLine($"{res33.Item1} -> {res33.Item2}"); // >>> "bikes:repairs -> bike:1"
  
          Tuple<RedisKey, RedisValue>? res34 = db.BRPop(["bikes:repairs"], 1);
          Console.WriteLine(res34);   // >>> "Null"
  
  
          db.KeyDelete("new_bikes");
  
          long res36 = db.ListRightPush("new_bikes", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res36);   // >>> 3
  
  
          db.KeyDelete("new_bikes");
          
          bool res37 = db.StringSet("new_bikes", "bike:1");
          Console.WriteLine(res37);   // >>> True
  
          RedisType res38 = db.KeyType("new_bikes");
          Console.WriteLine(res38);   // >>> RedisType.String
  
          try
          {
              long res39 = db.ListRightPush("new_bikes", ["bike:2", "bike:3"]);
          }
          catch (Exception e)
          {
              Console.WriteLine(e);
          }
  
  
          db.KeyDelete("bikes:repairs");
  
          long res40 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res40);   // >>> 3
  
          bool res41 = db.KeyExists("bikes:repairs");
          Console.WriteLine(res41);   // >>> True
  
          RedisValue res42 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res42);   // >>> "bike:3"
  
          RedisValue res43 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res43);   // >>> "bike:2"
  
          RedisValue res44 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res44);   //  >>> "bike:1"
  
          bool res45 = db.KeyExists("bikes:repairs");
          Console.WriteLine(res45);   // >>> False
  
  
          db.KeyDelete("bikes:repairs");
  
          long res47 = db.ListLength("bikes:repairs");
          Console.WriteLine(res47);   // >>> 0
  
          RedisValue res48 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res48);   // >>> Null
  
  
          db.KeyDelete("bikes:repairs");
  
          long res49 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res49);   // >>> 5
  
          db.ListTrim("bikes:repairs", 0, 2);
          RedisValue[] res50 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res50));    // >>> "bike:5, bike:4, bike:3"
  
  
      }
  }
  

  ▼ Commands: LPUSH, LPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Methods

    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • value: RedisValue,
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the head of the list.
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the head of the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • value: RedisValue,
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the head of the list.
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
  • LPOP ( @write , @list , @fast )

    Returns the first elements in a list after removing it. Deletes the list if the last element was popped.

    ▶ Methods

    • ListLeftPop(
      • key: RedisKey,
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue // A span of contiguous elements from the list, or Null if no non-empty lists are found.
    • ListLeftPop(
      • key: RedisKey,
      • count: long, // The maximum number of elements to pop from the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue[] // A span of contiguous elements from the list, or Null if no non-empty lists are found.
    • ListLeftPop(
      • keys: RedisKey[], // The keys to look through for elements to pop.
      • count: long, // The maximum number of elements to pop from the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → ListPopResult // A span of contiguous elements from the list, or Null if no non-empty lists are found.
    • ListLeftPop(
      • key: RedisKey,
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue // A span of contiguous elements from the list, or Null if no non-empty lists are found.
    • ListLeftPop(
      • key: RedisKey,
      • count: long, // The maximum number of elements to pop from the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue[] // A span of contiguous elements from the list, or Null if no non-empty lists are found.

  C#-Sync Quick-Start

  <?php
  
  require 'vendor/autoload.php';
  
  use Predis\Client as PredisClient;
  
  class DtListTest
  {
      public function testDtList() {
          $r = new PredisClient([
              'scheme'   => 'tcp',
              'host'     => '127.0.0.1',
              'port'     => 6379,
              'password' => '',
              'database' => 0,
          ]);
  
          $res1 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res1 . PHP_EOL;
          // >>> 1
  
          $res2 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res2 . PHP_EOL;
          // >>> 2
  
          $res3 = $r->rpop('bikes:repairs');
          echo $res3 . PHP_EOL;
          // >>> bike:1
  
          $res4 = $r->rpop('bikes:repairs');
          echo $res4 . PHP_EOL;
          // >>> bike:2
  
          $res5 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res5 . PHP_EOL;
          // >>> 1
  
          $res6 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res6 . PHP_EOL;
          // >>> 2
  
          $res7 = $r->lpop('bikes:repairs');
          echo $res7 . PHP_EOL;
          // >>> bike:2
  
          $res8 = $r->lpop('bikes:repairs');
          echo $res8 . PHP_EOL;
          // >>> bike:1
  
          $res9 = $r->llen('bikes:repairs');
          echo $res9 . PHP_EOL;
          // >>> 0
  
          $res10 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res10 . PHP_EOL;
          // >>> 1
  
          $res11 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res11 . PHP_EOL;
          // >>> 2
  
          $res12 = $r->lmove('bikes:repairs', 'bikes:finished', 'LEFT', 'LEFT');
          echo $res12 . PHP_EOL;
          // >>> 'bike:2'
  
          $res13 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res13) . PHP_EOL;
          // >>> ['bike:1']
  
          $res14 = $r->lrange('bikes:finished', 0, -1);
          echo json_encode($res14) . PHP_EOL;
          // >>> ['bike:2']
  
          $r->del('bikes:repairs');
          
          $res15 = $r->rpush('bikes:repairs', 'bike:1');
          echo $res15 . PHP_EOL;
          // >>> 1
  
          $res16 = $r->rpush('bikes:repairs', 'bike:2');
          echo $res16 . PHP_EOL;
          // >>> 2
  
          $res17 = $r->lpush('bikes:repairs', 'bike:important_bike');
          echo $res17 . PHP_EOL;
          // >>> 3
  
          $res18 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res18) . PHP_EOL;
          // >>> ['bike:important_bike', 'bike:1', 'bike:2']
  
          $r->del('bikes:repairs');
  
          $res19 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res19 . PHP_EOL;
          // >>> 3
  
          $res20 = $r->lpush('bikes:repairs', 'bike:important_bike', 'bike:very_important_bike');
          echo $res20 . PHP_EOL;
          // >>> 5
  
          $res21 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res21) . PHP_EOL;
          // >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
  
          $r->del('bikes:repairs');
          
          $res22 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res22 . PHP_EOL;
          // >>> 3
  
          $res23 = $r->rpop('bikes:repairs');
          echo $res23 . PHP_EOL;
          // >>> 'bike:3'
  
          $res24 = $r->lpop('bikes:repairs');
          echo $res24 . PHP_EOL;
          // >>> 'bike:1'
  
          $res25 = $r->rpop('bikes:repairs');
          echo $res25 . PHP_EOL;
          // >>> 'bike:2'
  
          $res26 = $r->rpop('bikes:repairs');
          echo $res26 . PHP_EOL;
          // >>> None
  
          $res27 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res27 . PHP_EOL;
          // >>> 5
  
          $res28 = $r->ltrim('bikes:repairs', 0, 2);
          echo $res28 . PHP_EOL;
          // >>> True
  
          $res29 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res29) . PHP_EOL;
          // >>> ['bike:1', 'bike:2', 'bike:3']
  
          $r->del('bikes:repairs');
  
          $res27 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res27 . PHP_EOL;
          // >>> 5
  
          $res28 = $r->ltrim('bikes:repairs', -3, -1);
          echo $res28 . PHP_EOL;
          // >>> True
  
          $res29 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res29) . PHP_EOL;
          // >>> ['bike:3', 'bike:4', 'bike:5']
  
          $r->del('bikes:repairs');
  
          $res31 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2');
          echo $res31 . PHP_EOL;
          // >>> 2
  
          $res32 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res32) . PHP_EOL;
          // >>> ['bikes:repairs', 'bike:2']
  
          $res33 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res33) . PHP_EOL;
          // >>> ['bikes:repairs', 'bike:1']
  
          $res34 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res34) . PHP_EOL;
          // >>> None
  
          $res35 = $r->del('new_bikes');
          echo $res35 . PHP_EOL;
          // >>> 0
  
          $res36 = $r->lpush('new_bikes', 'bike:1', 'bike:2', 'bike:3');
          echo $res36 . PHP_EOL;
          // >>> 3
  
          $r->del('new_bikes');
  
          $res37 = $r->set('new_bikes', 'bike:1');
          echo $res37 . PHP_EOL;
          // >>> True
  
          $res38 = $r->type('new_bikes');
          echo $res38 . PHP_EOL;
          // >>> 'string'
  
          try {
              $res39 = $r->lpush('new_bikes', 'bike:2', 'bike:3');
              // >>> redis.exceptions.ResponseError:
              // >>> WRONGTYPE Operation against a key holding the wrong kind of value
          } catch (\Predis\Response\ServerException $e) {
              echo $e->getMessage() . PHP_EOL;
          }
  
          $r->del('bikes:repairs');
          $res36 = $r->lpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res36 . PHP_EOL;
          // >>> 3
  
          $res40 = $r->exists('bikes:repairs');
          echo $res40 . PHP_EOL;
          // >>> 1
  
          $res41 = $r->lpop('bikes:repairs');
          echo $res41 . PHP_EOL;
          // >>> 'bike:3'
  
          $res42 = $r->lpop('bikes:repairs');
          echo $res42 . PHP_EOL;
          // >>> 'bike:2'
  
          $res43 = $r->lpop('bikes:repairs');
          echo $res43 . PHP_EOL;
          // >>> 'bike:1'
  
          $res44 = $r->exists('bikes:repairs');
          echo $res44 . PHP_EOL;
          // >>> False
  
          $res45 = $r->del('bikes:repairs');
          echo $res45 . PHP_EOL;
          // >>> 0
  
          $res46 = $r->llen('bikes:repairs');
          echo $res46 . PHP_EOL;
          // >>> 0
  
          $res47 = $r->lpop('bikes:repairs');
          echo $res47 . PHP_EOL;
          // >>> None
  
          $res48 = $r->lpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res48 . PHP_EOL;
          // >>> 5
  
          $res49 = $r->ltrim('bikes:repairs', 0, 2);
          echo $res49 . PHP_EOL;
          // >>> True
  
          $res50 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res50) . PHP_EOL;
          // >>> ['bike:5', 'bike:4', 'bike:3']
      }
  }
  
  

  ▼ Commands: LPUSH, LPOP

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • lpush(
      • $key: string,
      • $values: array
      ) → int
  • LPOP ( @write , @list , @fast )

    Returns the first elements in a list after removing it. Deletes the list if the last element was popped.

    ▶ Method

    • lpop(
      • $key: string
      ) → string|null

  PHP Quick-Start

• Check the length of a list:

  Language: >_ Redis CLI Python JavaScript (node-redis) Java-Sync Java-Async Go C#-Sync PHP

  Copied!

  Copied!

  Foundational: Get the number of elements in a list using LLEN to check list size

  > LLEN bikes:repairs
  (integer) 0

  ▼ Commands: LLEN

  • LLEN ( @read , @list , @fast )

    Returns the length of a list.

  Redis CLI guide

  Also, check out our other client tools Redis Insight and Redis for VS Code.

  """
  Code samples for List doc pages:
      https://redis.io/docs/latest/develop/data-types/lists/
  """
  
  import redis
  
  r = redis.Redis(decode_responses=True)
  
  res1 = r.lpush("bikes:repairs", "bike:1")
  print(res1)  # >>> 1
  
  res2 = r.lpush("bikes:repairs", "bike:2")
  print(res2)  # >>> 2
  
  res3 = r.rpop("bikes:repairs")
  print(res3)  # >>> bike:1
  
  res4 = r.rpop("bikes:repairs")
  print(res4)  # >>> bike:2
  
  
  res5 = r.lpush("bikes:repairs", "bike:1")
  print(res5)  # >>> 1
  
  res6 = r.lpush("bikes:repairs", "bike:2")
  print(res6)  # >>> 2
  
  res7 = r.lpop("bikes:repairs")
  print(res7)  # >>> bike:2
  
  res8 = r.lpop("bikes:repairs")
  print(res8)  # >>> bike:1
  
  
  res9 = r.llen("bikes:repairs")
  print(res9)  # >>> 0
  
  
  res10 = r.lpush("bikes:repairs", "bike:1")
  print(res10)  # >>> 1
  
  res11 = r.lpush("bikes:repairs", "bike:2")
  print(res11)  # >>> 2
  
  res12 = r.lmove("bikes:repairs", "bikes:finished", "LEFT", "LEFT")
  print(res12)  # >>> 'bike:2'
  
  res13 = r.lrange("bikes:repairs", 0, -1)
  print(res13)  # >>> ['bike:1']
  
  res14 = r.lrange("bikes:finished", 0, -1)
  print(res14)  # >>> ['bike:2']
  
  
  r.delete("bikes:repairs")
  
  res15 = r.rpush("bikes:repairs", "bike:1")
  print(res15)  # >>> 1
  
  res16 = r.rpush("bikes:repairs", "bike:2")
  print(res16)  # >>> 2
  
  res17 = r.lpush("bikes:repairs", "bike:important_bike")
  print(res17)  # >>> 3
  
  res18 = r.lrange("bikes:repairs", 0, -1)
  print(res18)  # >>> ['bike:important_bike', 'bike:1', 'bike:2']
  
  
  r.delete("bikes:repairs")
  
  res19 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res19)  # >>> 3
  
  res20 = r.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike")
  print(res20)  # >>> 5
  
  res21 = r.lrange("bikes:repairs", 0, -1)
  print(
      res21
  )  # >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
  
  
  r.delete("bikes:repairs")
  
  res22 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res22)  # >>> 3
  
  res23 = r.rpop("bikes:repairs")
  print(res23)  # >>> 'bike:3'
  
  res24 = r.lpop("bikes:repairs")
  print(res24)  # >>> 'bike:1'
  
  res25 = r.rpop("bikes:repairs")
  print(res25)  # >>> 'bike:2'
  
  res26 = r.rpop("bikes:repairs")
  print(res26)  # >>> None
  
  
  res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res27)  # >>> 5
  
  res28 = r.ltrim("bikes:repairs", 0, 2)
  print(res28)  # >>> True
  
  res29 = r.lrange("bikes:repairs", 0, -1)
  print(res29)  # >>> ['bike:1', 'bike:2', 'bike:3']
  
  
  r.delete("bikes:repairs")
  
  res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res27)  # >>> 5
  
  res28 = r.ltrim("bikes:repairs", -3, -1)
  print(res28)  # >>> True
  
  res29 = r.lrange("bikes:repairs", 0, -1)
  print(res29)  # >>> ['bike:3', 'bike:4', 'bike:5']
  
  
  r.delete("bikes:repairs")
  
  res31 = r.rpush("bikes:repairs", "bike:1", "bike:2")
  print(res31)  # >>> 2
  
  res32 = r.brpop("bikes:repairs", timeout=1)
  print(res32)  # >>> ('bikes:repairs', 'bike:2')
  
  res33 = r.brpop("bikes:repairs", timeout=1)
  print(res33)  # >>> ('bikes:repairs', 'bike:1')
  
  res34 = r.brpop("bikes:repairs", timeout=1)
  print(res34)  # >>> None
  
  
  res35 = r.delete("new_bikes")
  print(res35)  # >>> 0
  
  res36 = r.lpush("new_bikes", "bike:1", "bike:2", "bike:3")
  print(res36)  # >>> 3
  
  
  r.delete("new_bikes")
  
  res37 = r.set("new_bikes", "bike:1")
  print(res37)  # >>> True
  
  res38 = r.type("new_bikes")
  print(res38)  # >>> 'string'
  
  try:
      res39 = r.lpush("new_bikes", "bike:2", "bike:3")
      # >>> redis.exceptions.ResponseError:
      # >>> WRONGTYPE Operation against a key holding the wrong kind of value
  except redis.exceptions.ResponseError as e:
      print(e)
  
  
  r.delete("bikes:repairs")
  
  r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res36)  # >>> 3
  
  res40 = r.exists("bikes:repairs")
  print(res40)  # >>> 1
  
  res41 = r.lpop("bikes:repairs")
  print(res41)  # >>> 'bike:3'
  
  res42 = r.lpop("bikes:repairs")
  print(res42)  # >>> 'bike:2'
  
  res43 = r.lpop("bikes:repairs")
  print(res43)  # >>> 'bike:1'
  
  res44 = r.exists("bikes:repairs")
  print(res44)  # >>> False
  
  
  r.delete("bikes:repairs")
  
  res45 = r.delete("bikes:repairs")
  print(res45)  # >>> 0
  
  res46 = r.llen("bikes:repairs")
  print(res46)  # >>> 0
  
  res47 = r.lpop("bikes:repairs")
  print(res47)  # >>> None
  
  
  r.delete("bikes:repairs")
  
  res48 = r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res48)  # >>> 5
  
  res49 = r.ltrim("bikes:repairs", 0, 2)
  print(res49)  # >>> True
  
  res50 = r.lrange("bikes:repairs", 0, -1)
  print(res50)  # >>> ['bike:5', 'bike:4', 'bike:3']
  
  

  ▼ Commands: LLEN

  • LLEN ( @read , @list , @fast )

    Returns the length of a list.

    ▶ Method

    • llen(
      • name: KeyT
      ) → Union[Awaitable[int], int]

  Python Quick-Start

  import { createClient } from 'redis';
  
  const client = createClient();
  await client.connect();
  
  const res1 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res1);  // 1
  
  const res2 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res2);  // 2
  
  const res3 = await client.rPop('bikes:repairs');
  console.log(res3);  // bike:1
  
  const res4 = await client.rPop('bikes:repairs');
  console.log(res4);  // bike:2
  
  
  const res5 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res5);  // 1
  
  const res6 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res6); // 2
  
  const res7 = await client.lPop('bikes:repairs');
  console.log(res7);  // bike:2
  
  const res8 = await client.lPop('bikes:repairs');
  console.log(res8);  // bike:1
  
  
  const res9 = await client.lLen('bikes:repairs');
  console.log(res9); // 0
  
  
  const res10 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res10);  // 1
  
  const res11 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res11);  // 2
  
  const res12 = await client.lMove('bikes:repairs', 'bikes:finished', 'LEFT', 'LEFT');
  console.log(res12);  // 'bike:2'
  
  const res13 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res13);  // ['bike:1']
  
  const res14 = await client.lRange('bikes:finished', 0, -1);
  console.log(res14);  // ['bike:2']
  
  
  await client.del('bikes:repairs');
  
  const res15 = await client.rPush('bikes:repairs', 'bike:1');
  console.log(res15);  // 1
  
  const res16 = await client.rPush('bikes:repairs', 'bike:2');
  console.log(res16);  // 2
  
  const res17 = await client.lPush('bikes:repairs', 'bike:important_bike');
  console.log(res17);  // 3
  
  const res18 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res18);  // ['bike:important_bike', 'bike:1', 'bike:2']
  
  
  await client.del('bikes:repairs');
  
  const res19 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res19);  // 3
  
  const res20 = await client.lPush(
    'bikes:repairs', ['bike:important_bike', 'bike:very_important_bike']
  );
  console.log(res20);  // 5
  
  const res21 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res21);  // ['bike:very_important_bike', 'bike:important_bike', 'bike:1', 'bike:2', 'bike:3']
  
  
  await client.del('bikes:repairs');
  
  const res22 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res22);  // 3
  
  const res23 = await client.rPop('bikes:repairs');
  console.log(res23);  // 'bike:3'
  
  const res24 = await client.lPop('bikes:repairs');
  console.log(res24);  // 'bike:1'
  
  const res25 = await client.rPop('bikes:repairs');
  console.log(res25);  // 'bike:2'
  
  const res26 = await client.rPop('bikes:repairs');
  console.log(res26);  // null
  
  
  const res27 = await client.lPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res27);  // 5
  
  const res28 = await client.lTrim('bikes:repairs', 0, 2);
  console.log(res28);  // OK
  
  const res29 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res29);  // ['bike:5', 'bike:4', 'bike:3']
  
  
  await client.del('bikes:repairs');
  
  const res27eol = await client.rPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res27eol);  // 5
  
  const res28eol = await client.lTrim('bikes:repairs', -3, -1);
  console.log(res28eol);  // 'OK'
  
  const res29eol = await client.lRange('bikes:repairs', 0, -1);
  console.log(res29eol);  // ['bike:3', 'bike:4', 'bike:5']
  
  
  await client.del('bikes:repairs');
  
  const res31 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2']);
  console.log(res31);  // 2
  
  const res32 = await client.brPop('bikes:repairs', 1);
  console.log(res32);  // { key: 'bikes:repairs', element: 'bike:2' }
  
  const res33 = await client.brPop('bikes:repairs', 1);
  console.log(res33);  // { key: 'bikes:repairs', element: 'bike:1' }
  
  const res34 = await client.brPop('bikes:repairs', 1);
  console.log(res34);  // null
  
  
  const res35 = await client.del('new_bikes');
  console.log(res35); // 0
  
  const res36 = await client.lPush('new_bikes', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res36); // 3
  
  
  await client.del('new_bikes');
  
  const res37 = await client.set('new_bikes', 'bike:1');
  console.log(res37);  // 'OK'
  
  const res38 = await client.type('new_bikes');
  console.log(res38);  // 'string'
  
  try {
    const res39 = await client.lPush('new_bikes', 'bike:2', 'bike:3');
    // redis.exceptions.ResponseError:
    // [SimpleError: WRONGTYPE Operation against a key holding the wrong kind of value]
  }
  catch(e){
    console.log(e);
  }
  
  
  await client.del('bikes:repairs');
  
  await client.lPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res36);  // 3
  
  const res40 = await client.exists('bikes:repairs')
  console.log(res40);  // 1
  
  const res41 = await client.lPop('bikes:repairs');
  console.log(res41);  // 'bike:3'
  
  const res42 = await client.lPop('bikes:repairs');
  console.log(res42);  // 'bike:2'
  
  const res43 = await client.lPop('bikes:repairs');
  console.log(res43);  // 'bike:1'
  
  const res44 = await client.exists('bikes:repairs');
  console.log(res44);  // 0
  
  
  await client.del('bikes:repairs');
  
  const res45 = await client.del('bikes:repairs');
  console.log(res45);  // 0
  
  const res46 = await client.lLen('bikes:repairs');
  console.log(res46);  // 0
  
  const res47 = await client.lPop('bikes:repairs');
  console.log(res47);  // null
  
  
  await client.del('bikes:repairs');
  
  const res48 = await client.lPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res48);  // 5
  
  const res49 = await client.lTrim('bikes:repairs', 0, 2);
  console.log(res49);  // 'OK'
  
  const res50 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res50);  // ['bike:5', 'bike:4', 'bike:3']
  
  
  await client.close();
  

  ▼ Commands: LLEN

  • LLEN ( @read , @list , @fast )

    Returns the length of a list.

    ▶ Method

    • LLEN(
      • key: RedisArgument
      ) → Any

  Node.js Quick-Start

  import redis.clients.jedis.UnifiedJedis;
  import redis.clients.jedis.args.ListDirection;
  import java.util.List;
  
  
  public class ListExample {
  
      public void run() {
          UnifiedJedis jedis = new UnifiedJedis("redis://localhost:6379");
  
  
          long res1 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res1);  // >>> 1
  
          long res2 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res2);  // >>> 2
  
          String res3 = jedis.rpop("bikes:repairs");
          System.out.println(res3);  // >>> bike:1
  
          String res4 = jedis.rpop("bikes:repairs");
          System.out.println(res4); // >>> bike:2
  
  
          long res5 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res5);  // >>> 1
  
          long res6 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res6);  // >>> 2
  
          String res7 = jedis.lpop("bikes:repairs");
          System.out.println(res7);  // >>> bike:2
  
          String res8 = jedis.lpop("bikes:repairs");
          System.out.println(res8);  // >>> bike:1
  
  
          long res9 = jedis.llen("bikes:repairs");
          System.out.println(res9);  // >>> 0
  
  
          long res10 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res10);  // >>> 1
  
          long res11 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res11);  // >>> 2
  
          String res12 = jedis.lmove("bikes:repairs", "bikes:finished", ListDirection.LEFT, ListDirection.LEFT);
          System.out.println(res12);  // >>> bike:2
  
          List<String> res13 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res13);  // >>> [bike:1]
  
          List<String> res14 = jedis.lrange("bikes:finished", 0, -1);
          System.out.println(res14);  // >>> [bike:2]
  
  
          jedis.del("bikes:repairs");
  
          long res15 = jedis.rpush("bikes:repairs", "bike:1");
          System.out.println(res15);  // >>> 1
  
          long res16 = jedis.rpush("bikes:repairs", "bike:2");
          System.out.println(res16);  // >>> 2
  
          long res17 = jedis.lpush("bikes:repairs", "bike:important_bike");
          System.out.println(res17);  // >>> 3
  
          List<String> res18 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res18);  // >>> [bike:important_bike, bike:1, bike:2]
  
  
          jedis.del("bikes:repairs");
          
          long res19 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res19);  // >>> 3
  
          long res20 = jedis.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike");
          System.out.println(res20);  // >>> 5
  
          List<String> res21 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res21);  // >>> [bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3]
  
  
          jedis.del("bikes:repairs");
  
          long res22 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res22);  // >>> 3
  
          String res23 = jedis.rpop("bikes:repairs");
          System.out.println(res23);  // >>> bike:3
  
          String res24 = jedis.lpop("bikes:repairs");
          System.out.println(res24);  // >>> bike:1
  
          String res25 = jedis.rpop("bikes:repairs");
          System.out.println(res25);  // >>> bike:2
  
          String res26 = jedis.rpop("bikes:repairs");
          System.out.println(res26);  // >>> null
  
  
          long res27 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res27);  // >>> 5
  
          String res28 = jedis.ltrim("bikes:repairs", 0, 2);
          System.out.println(res28);  // >>> OK
  
          List<String> res29 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res29);  // >>> [bike:1, bike:2, bike:3]
  
  
          jedis.del("bikes:repairs");
          
          res27 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res27);  // >>> 5
  
          res28 = jedis.ltrim("bikes:repairs", -3, -1);
          System.out.println(res2);  // >>> OK
  
          res29 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res29);  // >>> [bike:3, bike:4, bike:5]
  
  
          jedis.del("bikes:repairs");
  
          long res31 = jedis.rpush("bikes:repairs", "bike:1", "bike:2");
          System.out.println(res31);  // >>> 2
  
          List<String> res32 = jedis.brpop(1, "bikes:repairs");
          System.out.println(res32);  // >>> (bikes:repairs, bike:2)
  
          List<String>  res33 = jedis.brpop(1,"bikes:repairs");
          System.out.println(res33);  // >>> (bikes:repairs, bike:1)
  
          List<String>  res34 = jedis.brpop(1,"bikes:repairs");
          System.out.println(res34);  // >>> null
  
  
          jedis.del("new_bikes");
  
          long res36 = jedis.lpush("new_bikes", "bike:1", "bike:2", "bike:3");
          System.out.println(res36);  // >>> 3
  
  
          jedis.del("new_bikes");
          
          String res37 = jedis.set("new_bikes", "bike:1");
          System.out.println(res37);  // >>> OK
  
          String res38 = jedis.type("new_bikes");
          System.out.println(res38);  // >>> string
  
          try {
              long res39  = jedis.lpush("new_bikes", "bike:2", "bike:3");
          } catch (Exception e) {
              e.printStackTrace();
              // >>> redis.clients.jedis.exceptions.JedisDataException:
              // >>> WRONGTYPE Operation against a key holding the wrong kind of value
          }
  
  
          jedis.del("bikes:repairs");
  
          jedis.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res36);  // >>> 3
  
          boolean res40 = jedis.exists("bikes:repairs");
          System.out.println(res40);  // >>> true
  
          String res41 = jedis.lpop("bikes:repairs");
          System.out.println(res41);  // >>> bike:3
  
          String res42 = jedis.lpop("bikes:repairs");
          System.out.println(res42);  // >>> bike:2
  
          String res43 = jedis.lpop("bikes:repairs");
          System.out.println(res43);  // >>> bike:1
  
          boolean res44 = jedis.exists("bikes:repairs");
          System.out.println(res44);  // >>> false
  
  
          jedis.del("bikes:repairs");
  
          long res46 = jedis.llen("bikes:repairs");
          System.out.println(res46);  // >>> 0
  
          String res47 = jedis.lpop("bikes:repairs");
          System.out.println(res47);  // >>> null
  
  
          jedis.del("bikes:repairs");
  
          long res48 = jedis.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res48);  // >>> 5
  
          String res49 = jedis.ltrim("bikes:repairs", 0, 2);
          System.out.println(res49);  // >>> OK
  
          List<String> res50 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res50);  // >>> [bike:5, bike:4, bike:3]
  
  
          jedis.close();
      }
  }
  

  ▼ Commands: LLEN

  • LLEN ( @read , @list , @fast )

    Returns the length of a list.

    ▶ Methods

    • llen(
      • key: byte[]
      ) → long // The length of the list
    • llen(
      • key: String
      ) → long // The length of the list
    • llen(
      • key: String
      ) → long // The length of the list

  Java-Sync Quick-Start

  package io.redis.examples.async;
  
  import io.lettuce.core.*;
  import io.lettuce.core.api.async.RedisAsyncCommands;
  import io.lettuce.core.api.StatefulRedisConnection;
  
  import java.util.concurrent.CompletableFuture;
  
  public class ListExample {
  
      public void run() {
          RedisClient redisClient = RedisClient.create("redis://localhost:6379");
  
          try (StatefulRedisConnection<String, String> connection = redisClient.connect()) {
              RedisAsyncCommands<String, String> asyncCommands = connection.async();
  
              CompletableFuture<Void> queue = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res1 -> {
                  System.out.println(res1); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res2 -> {
                  System.out.println(res2); // >>> 2
  
                  return asyncCommands.rpop("bikes:repairs");
              }).thenCompose(res3 -> {
                  System.out.println(res3); // >>> bike:1
  
                  return asyncCommands.rpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> bike:2
                      .toCompletableFuture();
              queue.join();
  
              CompletableFuture<Void> stack = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res4 -> {
                  System.out.println(res4); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res5 -> {
                  System.out.println(res5); // >>> 2
  
                  return asyncCommands.lpop("bikes:repairs");
              }).thenCompose(res6 -> {
                  System.out.println(res6); // >>> bike:2
  
                  return asyncCommands.lpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> bike:1
                      .toCompletableFuture();
              stack.join();
  
              CompletableFuture<Void> llen = asyncCommands.llen("bikes:repairs")
                      .thenAccept(System.out::println) // >>> 0
                      .toCompletableFuture();
              llen.join();
  
              CompletableFuture<Void> lmovelrange = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res7 -> {
                  System.out.println(res7); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res8 -> {
                  System.out.println(res8); // >>> 2
  
                  return asyncCommands.lmove("bikes:repairs", "bikes:finished", LMoveArgs.Builder.leftLeft());
              }).thenCompose(res9 -> {
                  System.out.println(res9); // >>> bike:2
  
                  return asyncCommands.lrange("bikes:repairs", 0, -1);
              }).thenCompose(res10 -> {
                  System.out.println(res10); // >>> [bike:1]
  
                  return asyncCommands.lrange("bikes:finished", 0, -1);
              })
                      .thenAccept(System.out::println) // >>> [bike:2]
                      .toCompletableFuture();
              lmovelrange.join();
  
  
              CompletableFuture<Void> lpushrpush = asyncCommands.rpush("bikes:repairs", "bike:1").thenCompose(res11 -> {
                  System.out.println(res11); // >>> 1
  
                  return asyncCommands.rpush("bikes:repairs", "bike:2");
              }).thenCompose(res12 -> {
                  System.out.println(res12); // >>> 2
  
                  return asyncCommands.lpush("bikes:repairs", "bike:important_bike");
              }).thenCompose(res13 -> {
                  System.out.println(res13); // >>> 3
  
                  return asyncCommands.lrange("bikes:repairs", 0, -1);
              })
                      .thenAccept(System.out::println)
                      // >>> [bike:important_bike, bike:1, bike:2]
                      .toCompletableFuture();
              lpushrpush.join();
  
  
              CompletableFuture<Void> variadic = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res14 -> {
                          System.out.println(res14); // >>> 3
  
                          return asyncCommands.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike");
                      }).thenCompose(res15 -> {
                          System.out.println(res15); // >>> 5
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3]
                      .toCompletableFuture();
              variadic.join();
  
  
              CompletableFuture<Void> lpoprpop = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res16 -> {
                          System.out.println(res16); // >>> 3
  
                          return asyncCommands.rpop("bikes:repairs");
                      }).thenCompose(res17 -> {
                          System.out.println(res17); // >>> bike:3
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res18 -> {
                          System.out.println(res18); // >>> bike:1
  
                          return asyncCommands.rpop("bikes:repairs");
                      }).thenCompose(res19 -> {
                          System.out.println(res19); // >>> bike:2
  
                          return asyncCommands.rpop("bikes:repairs");
                      })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              lpoprpop.join();
  
              CompletableFuture<Void> ltrim = asyncCommands
                      .lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res20 -> {
                          System.out.println(res20); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", 0, 2);
                      }).thenCompose(res21 -> {
                          System.out.println(res21); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:5, bike:4, bike:3]
                      .toCompletableFuture();
              ltrim.join();
  
  
              CompletableFuture<Void> ltrimendoflist = asyncCommands
                      .rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res22 -> {
                          System.out.println(res22); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", -3, -1);
                      }).thenCompose(res23 -> {
                          System.out.println(res23); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:3, bike:4, bike:5]
                      .toCompletableFuture();
              ltrimendoflist.join();
  
  
              CompletableFuture<Void> brpop = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2").thenCompose(res24 -> {
                  System.out.println(res24); // >>> 2
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              }).thenCompose(res25 -> {
                  System.out.println(res25);
                  // >>> KeyValue[bikes:repairs, bike:2]
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              }).thenCompose(res26 -> {
                  System.out.println(res26);
                  // >>> KeyValue[bikes:repairs, bike:1]
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              brpop.join();
  
              CompletableFuture<Void> rule1 = asyncCommands.del("new_bikes").thenCompose(res27 -> {
                  System.out.println(res27); // >>> 0
  
                  return asyncCommands.lpush("new_bikes", "bike:1", "bike:2", "bike:3");
              })
                      .thenAccept(System.out::println) // >>> 3
                      .toCompletableFuture();
              rule1.join();
  
              CompletableFuture<Void> rule11 = asyncCommands.set("new_bikes_string", "bike:1").thenCompose(res28 -> {
                  System.out.println(res28); // >>> OK
  
                  return asyncCommands.type("new_bikes_string");
              }).thenCompose(res29 -> {
                  System.out.println(res29); // >>> string
  
                  return asyncCommands.lpush("new_bikes_string", "bike:2", "bike:3");
              }).handle((res, ex) -> {
                  if (ex == null) {
                      return res;
                  } else {
                      System.out.println(ex);
                      // >>> java.util.concurrent.CompletionException:
                      // >>> io.lettuce.core.RedisCommandExecutionException:
                      // >>> WRONGTYPE Operation against a key holding the wrong
                      // >>> kind of value
  
                      return -1L;
                  }
              })
                      .thenAccept(System.out::println) // >>> -1
                      .toCompletableFuture();
              rule11.join();
  
  
              CompletableFuture<Void> rule2 = asyncCommands.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res30 -> {
                          System.out.println(res30); // >>> 3
  
                          return asyncCommands.exists("bikes:repairs");
                      }).thenCompose(res31 -> {
                          System.out.println(res31); // >>> 1
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res32 -> {
                          System.out.println(res32); // >>> bike:3
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res33 -> {
                          System.out.println(res33); // >>> bike:2
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res34 -> {
                          System.out.println(res34); // >>> bike:1
  
                          return asyncCommands.exists("bikes:repairs");
                      })
                      .thenAccept(System.out::println) // >>> 0
                      .toCompletableFuture();
              rule2.join();
  
              CompletableFuture<Void> rule3 = asyncCommands.del("bikes:repairs").thenCompose(res35 -> {
                  System.out.println(res35); // >>> 0
  
                  return asyncCommands.llen("bikes:repairs");
              }).thenCompose(res36 -> {
                  System.out.println(res36); // >>> 0
  
                  return asyncCommands.lpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              rule3.join();
  
              CompletableFuture<Void> ltrim1 = asyncCommands
                      .lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res37 -> {
                          System.out.println(res37); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", 0, 2);
                      }).thenCompose(res38 -> {
                          System.out.println(res38); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println) // >>> [bike:5, bike:4, bike:3]
                      .toCompletableFuture();
              ltrim1.join();
          } finally {
              redisClient.shutdown();
          }
      }
  
  }
  

  ▼ Commands: LLEN

  • LLEN ( @read , @list , @fast )

    Returns the length of a list.

    ▶ Method

    • llen(
      • key: K // the key.
      ) → RedisFuture<Long> // Long integer-reply the length of the list at key.

  Java-Async Quick-Start

  package example_commands_test
  
  import (
  	"context"
  	"fmt"
  
  	"github.com/redis/go-redis/v9"
  )
  
  
  func ExampleClient_queue() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res1, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res1) // >>> 1
  
  	res2, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res2) // >>> 2
  
  	res3, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res3) // >>> bike:1
  
  	res4, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res4) // >>> bike:2
  
  }
  
  func ExampleClient_stack() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res5, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res5) // >>> 1
  
  	res6, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res6) // >>> 2
  
  	res7, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res7) // >>> bike:2
  
  	res8, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res8) // >>> bike:1
  
  }
  
  func ExampleClient_llen() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res9, err := rdb.LLen(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res9) // >>> 0
  
  }
  
  func ExampleClient_lmove_lrange() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res10, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res10) // >>> 1
  
  	res11, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res11) // >>> 2
  
  	res12, err := rdb.LMove(ctx, "bikes:repairs", "bikes:finished", "LEFT", "LEFT").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res12) // >>> bike:2
  
  	res13, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res13) // >>> [bike:1]
  
  	res14, err := rdb.LRange(ctx, "bikes:finished", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res14) // >>> [bike:2]
  
  }
  
  func ExampleClient_lpush_rpush() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res15, err := rdb.RPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res15) // >>> 1
  
  	res16, err := rdb.RPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res16) // >>> 2
  
  	res17, err := rdb.LPush(ctx, "bikes:repairs", "bike:important_bike").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res17) // >>> 3
  
  	res18, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res18) // >>> [bike:important_bike bike:1 bike:2]
  
  }
  
  func ExampleClient_variadic() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res19, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res19) // >>> 3
  
  	res20, err := rdb.LPush(ctx, "bikes:repairs", "bike:important_bike", "bike:very_important_bike").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res20) // >>> 5
  
  	res21, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res21) // >>> [bike:very_important_bike bike:important_bike bike:1 bike:2 bike:3]
  
  }
  
  func ExampleClient_lpop_rpop() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res22, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res22) // >>> 3
  
  	res23, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res23) // >>> bike:3
  
  	res24, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res24) // >>> bike:1
  
  	res25, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res25) // >>> bike:2
  
  	res26, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res26) // >>> <empty string>
  
  
  }
  
  func ExampleClient_ltrim() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res27, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res27) // >>> 5
  
  	res28, err := rdb.LTrim(ctx, "bikes:repairs", 0, 2).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res28) // >>> OK
  
  	res29, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res29) // >>> [bike:1 bike:2 bike:3]
  
  }
  
  func ExampleClient_ltrim_end_of_list() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res30, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res30) // >>> 5
  
  	res31, err := rdb.LTrim(ctx, "bikes:repairs", -3, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res31) // >>> OK
  
  	res32, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res32) // >>> [bike:3 bike:4 bike:5]
  
  }
  
  func ExampleClient_brpop() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res33, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res33) // >>> 2
  
  	res34, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res34) // >>> [bikes:repairs bike:2]
  
  	res35, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res35) // >>> [bikes:repairs bike:1]
  
  	res36, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res36) // >>> []
  
  }
  
  func ExampleClient_rule1() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res37, err := rdb.Del(ctx, "new_bikes").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res37) // >>> 0
  
  	res38, err := rdb.LPush(ctx, "new_bikes", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res38) // >>> 3
  
  }
  
  func ExampleClient_rule11() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "new_bikes")
  
  	res39, err := rdb.Set(ctx, "new_bikes", "bike:1", 0).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res39) // >>> OK
  
  	res40, err := rdb.Type(ctx, "new_bikes").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res40) // >>> string
  
  	res41, err := rdb.LPush(ctx, "new_bikes", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		fmt.Println(err)
  		// >>> WRONGTYPE Operation against a key holding the wrong kind of value
  	}
  
  	fmt.Println(res41)
  
  }
  
  func ExampleClient_rule2() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  	res42, err := rdb.LPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res42) // >>> 3
  
  	res43, err := rdb.Exists(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res43) // >>> 1
  
  	res44, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res44) // >>> bike:3
  
  	res45, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res45) // >>> bike:2
  
  	res46, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res46) // >>> bike:1
  
  	res47, err := rdb.Exists(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res47) // >>> 0
  
  }
  
  func ExampleClient_rule3() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res48, err := rdb.Del(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res48) // >>> 0
  
  	res49, err := rdb.LLen(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res49) // >>> 0
  
  	res50, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res50) // >>> <empty string>
  
  }
  
  func ExampleClient_ltrim1() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res51, err := rdb.LPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res51) // >>> 5
  
  	res52, err := rdb.LTrim(ctx, "bikes:repairs", 0, 2).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res52) // >>> OK
  
  	res53, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res53) // >>> [bike:5 bike:4 bike:3]
  
  }
  

  ▼ Commands: LLEN

  • LLEN ( @read , @list , @fast )

    Returns the length of a list.

    ▶ Method

    • LLen(
      • ctx: context.Context,
      • key: string
      ) → *IntCmd

  Go Quick-Start

  using NRedisStack;
  using StackExchange.Redis;
  
  public class ListExample
  {
      public void Run()
      {
          var muxer = ConnectionMultiplexer.Connect("localhost:6379");
          var db = muxer.GetDatabase();
  
  
          long res1 = db.ListLeftPush("bikes:repairs", "bike:1");
          Console.WriteLine(res1);    // >>> 1
  
          long res2 = db.ListLeftPush("bikes:repairs", "bike:2");
          Console.WriteLine(res2);    // >>> 2
  
          RedisValue res3 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res3);    // >>> "bike:1"
  
          RedisValue res4 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res4); // >>> "bike:2"
  
  
          long res5 = db.ListLeftPush("bikes:repairs", "bike:1");
          Console.WriteLine(res5);    // >>> 1
  
          long res6 = db.ListLeftPush("bikes:repairs", "bike:2");
          Console.WriteLine(res6);    // >>> 2
  
          RedisValue res7 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res7);    // >>> "bike:2"
  
          RedisValue res8 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res8);    // >>> "bike:1"
  
  
  
          long res9 = db.ListLength("bikes:repairs");
          Console.WriteLine(res9);    // >>> 0
  
  
  
          long res10 = db.ListLeftPush("{bikes}:repairs", "bike:1");
          Console.WriteLine(res10);   // >>> 1
  
          long res11 = db.ListLeftPush("{bikes}:repairs", "bike:2");
          Console.WriteLine(res11);   // >>> 2
  
          RedisValue res12 = db.ListMove("{bikes}:repairs", "{bikes}:finished", ListSide.Left, ListSide.Left);
          Console.Write(res12);   // >>> "bike:2"
  
          RedisValue[] res13 = db.ListRange("{bikes}:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res13));    // >>> "bike:1"
  
          RedisValue[] res14 = db.ListRange("{bikes}:finished", 0, -1);
          Console.WriteLine(string.Join(", ", res14));    // >>> "bike:2"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res15 = db.ListRightPush("bikes:repairs", "bike:1");
          Console.WriteLine(res15);   // >>> 1
  
          long res16 = db.ListRightPush("bikes:repairs", "bike:2");
          Console.WriteLine(res16);   // >>> 2
  
          long res17 = db.ListLeftPush("bikes:repairs", "bike:important_bike");
          Console.WriteLine(res17);   // >>> 3
  
          RedisValue[] res18 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res18));    // >>> "bike:important_bike, bike:1, bike:2"
  
  
          db.KeyDelete("bikes:repairs");
          
          long res19 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res19);   // >>> 3
  
          long res20 = db.ListLeftPush("bikes:repairs", ["bike:important_bike", "bike:very_important_bike"]);
          Console.WriteLine(res20);   // >>> 5
  
          RedisValue[] res21 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res21));
          // >>> "bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res22 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res22);   // >>> 3
  
          RedisValue res23 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res23);   // >>> "bike:3"
  
          RedisValue res24 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res24);   // >>> "bike:1"
  
          RedisValue res25 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res25);   // >>> "bike:2"
  
          RedisValue res26 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res26);   // >>> <Empty string>
  
  
          long res27 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res27);   // >>> 5
  
          db.ListTrim("bikes:repairs", 0, 2);
          RedisValue[] res28 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res28));    // "bike:5, bike:4, bike:3"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res29 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res29);   // >>> 5
  
          db.ListTrim("bikes:repairs", -3, -1);
          RedisValue[] res30 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res30));    // >>> "bike:3, bike:4, bike:5"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res31 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2"]);
          Console.WriteLine(res31);   // >>> 2
  
          Tuple<RedisKey, RedisValue>? res32 = db.BRPop(["bikes:repairs"], 1);
  
          if (res32 != null)
              Console.WriteLine($"{res32.Item1} -> {res32.Item2}"); // >>> "bikes:repairs -> bike:2"
  
          Tuple<RedisKey, RedisValue>? res33 = db.BRPop(["bikes:repairs"], 1);
  
          if (res33 != null)
              Console.WriteLine($"{res33.Item1} -> {res33.Item2}"); // >>> "bikes:repairs -> bike:1"
  
          Tuple<RedisKey, RedisValue>? res34 = db.BRPop(["bikes:repairs"], 1);
          Console.WriteLine(res34);   // >>> "Null"
  
  
          db.KeyDelete("new_bikes");
  
          long res36 = db.ListRightPush("new_bikes", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res36);   // >>> 3
  
  
          db.KeyDelete("new_bikes");
          
          bool res37 = db.StringSet("new_bikes", "bike:1");
          Console.WriteLine(res37);   // >>> True
  
          RedisType res38 = db.KeyType("new_bikes");
          Console.WriteLine(res38);   // >>> RedisType.String
  
          try
          {
              long res39 = db.ListRightPush("new_bikes", ["bike:2", "bike:3"]);
          }
          catch (Exception e)
          {
              Console.WriteLine(e);
          }
  
  
          db.KeyDelete("bikes:repairs");
  
          long res40 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res40);   // >>> 3
  
          bool res41 = db.KeyExists("bikes:repairs");
          Console.WriteLine(res41);   // >>> True
  
          RedisValue res42 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res42);   // >>> "bike:3"
  
          RedisValue res43 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res43);   // >>> "bike:2"
  
          RedisValue res44 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res44);   //  >>> "bike:1"
  
          bool res45 = db.KeyExists("bikes:repairs");
          Console.WriteLine(res45);   // >>> False
  
  
          db.KeyDelete("bikes:repairs");
  
          long res47 = db.ListLength("bikes:repairs");
          Console.WriteLine(res47);   // >>> 0
  
          RedisValue res48 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res48);   // >>> Null
  
  
          db.KeyDelete("bikes:repairs");
  
          long res49 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res49);   // >>> 5
  
          db.ListTrim("bikes:repairs", 0, 2);
          RedisValue[] res50 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res50));    // >>> "bike:5, bike:4, bike:3"
  
  
      }
  }
  

  ▼ Commands: LLEN

  • LLEN ( @read , @list , @fast )

    Returns the length of a list.

    ▶ Methods

    • ListLength(
      • key: RedisKey, // The key of the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list at key.
    • ListLength(
      • key: RedisKey, // The key of the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list at key.

  C#-Sync Quick-Start

  <?php
  
  require 'vendor/autoload.php';
  
  use Predis\Client as PredisClient;
  
  class DtListTest
  {
      public function testDtList() {
          $r = new PredisClient([
              'scheme'   => 'tcp',
              'host'     => '127.0.0.1',
              'port'     => 6379,
              'password' => '',
              'database' => 0,
          ]);
  
          $res1 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res1 . PHP_EOL;
          // >>> 1
  
          $res2 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res2 . PHP_EOL;
          // >>> 2
  
          $res3 = $r->rpop('bikes:repairs');
          echo $res3 . PHP_EOL;
          // >>> bike:1
  
          $res4 = $r->rpop('bikes:repairs');
          echo $res4 . PHP_EOL;
          // >>> bike:2
  
          $res5 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res5 . PHP_EOL;
          // >>> 1
  
          $res6 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res6 . PHP_EOL;
          // >>> 2
  
          $res7 = $r->lpop('bikes:repairs');
          echo $res7 . PHP_EOL;
          // >>> bike:2
  
          $res8 = $r->lpop('bikes:repairs');
          echo $res8 . PHP_EOL;
          // >>> bike:1
  
          $res9 = $r->llen('bikes:repairs');
          echo $res9 . PHP_EOL;
          // >>> 0
  
          $res10 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res10 . PHP_EOL;
          // >>> 1
  
          $res11 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res11 . PHP_EOL;
          // >>> 2
  
          $res12 = $r->lmove('bikes:repairs', 'bikes:finished', 'LEFT', 'LEFT');
          echo $res12 . PHP_EOL;
          // >>> 'bike:2'
  
          $res13 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res13) . PHP_EOL;
          // >>> ['bike:1']
  
          $res14 = $r->lrange('bikes:finished', 0, -1);
          echo json_encode($res14) . PHP_EOL;
          // >>> ['bike:2']
  
          $r->del('bikes:repairs');
          
          $res15 = $r->rpush('bikes:repairs', 'bike:1');
          echo $res15 . PHP_EOL;
          // >>> 1
  
          $res16 = $r->rpush('bikes:repairs', 'bike:2');
          echo $res16 . PHP_EOL;
          // >>> 2
  
          $res17 = $r->lpush('bikes:repairs', 'bike:important_bike');
          echo $res17 . PHP_EOL;
          // >>> 3
  
          $res18 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res18) . PHP_EOL;
          // >>> ['bike:important_bike', 'bike:1', 'bike:2']
  
          $r->del('bikes:repairs');
  
          $res19 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res19 . PHP_EOL;
          // >>> 3
  
          $res20 = $r->lpush('bikes:repairs', 'bike:important_bike', 'bike:very_important_bike');
          echo $res20 . PHP_EOL;
          // >>> 5
  
          $res21 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res21) . PHP_EOL;
          // >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
  
          $r->del('bikes:repairs');
          
          $res22 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res22 . PHP_EOL;
          // >>> 3
  
          $res23 = $r->rpop('bikes:repairs');
          echo $res23 . PHP_EOL;
          // >>> 'bike:3'
  
          $res24 = $r->lpop('bikes:repairs');
          echo $res24 . PHP_EOL;
          // >>> 'bike:1'
  
          $res25 = $r->rpop('bikes:repairs');
          echo $res25 . PHP_EOL;
          // >>> 'bike:2'
  
          $res26 = $r->rpop('bikes:repairs');
          echo $res26 . PHP_EOL;
          // >>> None
  
          $res27 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res27 . PHP_EOL;
          // >>> 5
  
          $res28 = $r->ltrim('bikes:repairs', 0, 2);
          echo $res28 . PHP_EOL;
          // >>> True
  
          $res29 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res29) . PHP_EOL;
          // >>> ['bike:1', 'bike:2', 'bike:3']
  
          $r->del('bikes:repairs');
  
          $res27 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res27 . PHP_EOL;
          // >>> 5
  
          $res28 = $r->ltrim('bikes:repairs', -3, -1);
          echo $res28 . PHP_EOL;
          // >>> True
  
          $res29 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res29) . PHP_EOL;
          // >>> ['bike:3', 'bike:4', 'bike:5']
  
          $r->del('bikes:repairs');
  
          $res31 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2');
          echo $res31 . PHP_EOL;
          // >>> 2
  
          $res32 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res32) . PHP_EOL;
          // >>> ['bikes:repairs', 'bike:2']
  
          $res33 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res33) . PHP_EOL;
          // >>> ['bikes:repairs', 'bike:1']
  
          $res34 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res34) . PHP_EOL;
          // >>> None
  
          $res35 = $r->del('new_bikes');
          echo $res35 . PHP_EOL;
          // >>> 0
  
          $res36 = $r->lpush('new_bikes', 'bike:1', 'bike:2', 'bike:3');
          echo $res36 . PHP_EOL;
          // >>> 3
  
          $r->del('new_bikes');
  
          $res37 = $r->set('new_bikes', 'bike:1');
          echo $res37 . PHP_EOL;
          // >>> True
  
          $res38 = $r->type('new_bikes');
          echo $res38 . PHP_EOL;
          // >>> 'string'
  
          try {
              $res39 = $r->lpush('new_bikes', 'bike:2', 'bike:3');
              // >>> redis.exceptions.ResponseError:
              // >>> WRONGTYPE Operation against a key holding the wrong kind of value
          } catch (\Predis\Response\ServerException $e) {
              echo $e->getMessage() . PHP_EOL;
          }
  
          $r->del('bikes:repairs');
          $res36 = $r->lpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res36 . PHP_EOL;
          // >>> 3
  
          $res40 = $r->exists('bikes:repairs');
          echo $res40 . PHP_EOL;
          // >>> 1
  
          $res41 = $r->lpop('bikes:repairs');
          echo $res41 . PHP_EOL;
          // >>> 'bike:3'
  
          $res42 = $r->lpop('bikes:repairs');
          echo $res42 . PHP_EOL;
          // >>> 'bike:2'
  
          $res43 = $r->lpop('bikes:repairs');
          echo $res43 . PHP_EOL;
          // >>> 'bike:1'
  
          $res44 = $r->exists('bikes:repairs');
          echo $res44 . PHP_EOL;
          // >>> False
  
          $res45 = $r->del('bikes:repairs');
          echo $res45 . PHP_EOL;
          // >>> 0
  
          $res46 = $r->llen('bikes:repairs');
          echo $res46 . PHP_EOL;
          // >>> 0
  
          $res47 = $r->lpop('bikes:repairs');
          echo $res47 . PHP_EOL;
          // >>> None
  
          $res48 = $r->lpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res48 . PHP_EOL;
          // >>> 5
  
          $res49 = $r->ltrim('bikes:repairs', 0, 2);
          echo $res49 . PHP_EOL;
          // >>> True
  
          $res50 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res50) . PHP_EOL;
          // >>> ['bike:5', 'bike:4', 'bike:3']
      }
  }
  
  

  ▼ Commands: LLEN

  • LLEN ( @read , @list , @fast )

    Returns the length of a list.

    ▶ Method

    • llen(
      • $key: string
      ) → int

  PHP Quick-Start

• Atomically pop an element from one list and push to another:

  Language: >_ Redis CLI Python JavaScript (node-redis) Java-Sync Java-Async Go C#-Sync PHP

  Copied!

  Copied!

  Atomic transfer: Use LMOVE to move elements between lists in a single operation when you need to transfer items without race conditions

  > LPUSH bikes:repairs bike:1
  (integer) 1
  > LPUSH bikes:repairs bike:2
  (integer) 2
  > LMOVE bikes:repairs bikes:finished LEFT LEFT
  "bike:2"
  > LRANGE bikes:repairs 0 -1
  1) "bike:1"
  > LRANGE bikes:finished 0 -1
  1) "bike:2"

  ▼ Commands: LPUSH, LMOVE, LRANGE

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.
  • LMOVE ( @write , @list , @slow )

    Returns an element after popping it from one list and pushing it to another. Deletes the list if the last element was moved.
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

  Redis CLI guide

  Also, check out our other client tools Redis Insight and Redis for VS Code.

  """
  Code samples for List doc pages:
      https://redis.io/docs/latest/develop/data-types/lists/
  """
  
  import redis
  
  r = redis.Redis(decode_responses=True)
  
  res1 = r.lpush("bikes:repairs", "bike:1")
  print(res1)  # >>> 1
  
  res2 = r.lpush("bikes:repairs", "bike:2")
  print(res2)  # >>> 2
  
  res3 = r.rpop("bikes:repairs")
  print(res3)  # >>> bike:1
  
  res4 = r.rpop("bikes:repairs")
  print(res4)  # >>> bike:2
  
  
  res5 = r.lpush("bikes:repairs", "bike:1")
  print(res5)  # >>> 1
  
  res6 = r.lpush("bikes:repairs", "bike:2")
  print(res6)  # >>> 2
  
  res7 = r.lpop("bikes:repairs")
  print(res7)  # >>> bike:2
  
  res8 = r.lpop("bikes:repairs")
  print(res8)  # >>> bike:1
  
  
  res9 = r.llen("bikes:repairs")
  print(res9)  # >>> 0
  
  
  res10 = r.lpush("bikes:repairs", "bike:1")
  print(res10)  # >>> 1
  
  res11 = r.lpush("bikes:repairs", "bike:2")
  print(res11)  # >>> 2
  
  res12 = r.lmove("bikes:repairs", "bikes:finished", "LEFT", "LEFT")
  print(res12)  # >>> 'bike:2'
  
  res13 = r.lrange("bikes:repairs", 0, -1)
  print(res13)  # >>> ['bike:1']
  
  res14 = r.lrange("bikes:finished", 0, -1)
  print(res14)  # >>> ['bike:2']
  
  
  r.delete("bikes:repairs")
  
  res15 = r.rpush("bikes:repairs", "bike:1")
  print(res15)  # >>> 1
  
  res16 = r.rpush("bikes:repairs", "bike:2")
  print(res16)  # >>> 2
  
  res17 = r.lpush("bikes:repairs", "bike:important_bike")
  print(res17)  # >>> 3
  
  res18 = r.lrange("bikes:repairs", 0, -1)
  print(res18)  # >>> ['bike:important_bike', 'bike:1', 'bike:2']
  
  
  r.delete("bikes:repairs")
  
  res19 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res19)  # >>> 3
  
  res20 = r.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike")
  print(res20)  # >>> 5
  
  res21 = r.lrange("bikes:repairs", 0, -1)
  print(
      res21
  )  # >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
  
  
  r.delete("bikes:repairs")
  
  res22 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res22)  # >>> 3
  
  res23 = r.rpop("bikes:repairs")
  print(res23)  # >>> 'bike:3'
  
  res24 = r.lpop("bikes:repairs")
  print(res24)  # >>> 'bike:1'
  
  res25 = r.rpop("bikes:repairs")
  print(res25)  # >>> 'bike:2'
  
  res26 = r.rpop("bikes:repairs")
  print(res26)  # >>> None
  
  
  res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res27)  # >>> 5
  
  res28 = r.ltrim("bikes:repairs", 0, 2)
  print(res28)  # >>> True
  
  res29 = r.lrange("bikes:repairs", 0, -1)
  print(res29)  # >>> ['bike:1', 'bike:2', 'bike:3']
  
  
  r.delete("bikes:repairs")
  
  res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res27)  # >>> 5
  
  res28 = r.ltrim("bikes:repairs", -3, -1)
  print(res28)  # >>> True
  
  res29 = r.lrange("bikes:repairs", 0, -1)
  print(res29)  # >>> ['bike:3', 'bike:4', 'bike:5']
  
  
  r.delete("bikes:repairs")
  
  res31 = r.rpush("bikes:repairs", "bike:1", "bike:2")
  print(res31)  # >>> 2
  
  res32 = r.brpop("bikes:repairs", timeout=1)
  print(res32)  # >>> ('bikes:repairs', 'bike:2')
  
  res33 = r.brpop("bikes:repairs", timeout=1)
  print(res33)  # >>> ('bikes:repairs', 'bike:1')
  
  res34 = r.brpop("bikes:repairs", timeout=1)
  print(res34)  # >>> None
  
  
  res35 = r.delete("new_bikes")
  print(res35)  # >>> 0
  
  res36 = r.lpush("new_bikes", "bike:1", "bike:2", "bike:3")
  print(res36)  # >>> 3
  
  
  r.delete("new_bikes")
  
  res37 = r.set("new_bikes", "bike:1")
  print(res37)  # >>> True
  
  res38 = r.type("new_bikes")
  print(res38)  # >>> 'string'
  
  try:
      res39 = r.lpush("new_bikes", "bike:2", "bike:3")
      # >>> redis.exceptions.ResponseError:
      # >>> WRONGTYPE Operation against a key holding the wrong kind of value
  except redis.exceptions.ResponseError as e:
      print(e)
  
  
  r.delete("bikes:repairs")
  
  r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res36)  # >>> 3
  
  res40 = r.exists("bikes:repairs")
  print(res40)  # >>> 1
  
  res41 = r.lpop("bikes:repairs")
  print(res41)  # >>> 'bike:3'
  
  res42 = r.lpop("bikes:repairs")
  print(res42)  # >>> 'bike:2'
  
  res43 = r.lpop("bikes:repairs")
  print(res43)  # >>> 'bike:1'
  
  res44 = r.exists("bikes:repairs")
  print(res44)  # >>> False
  
  
  r.delete("bikes:repairs")
  
  res45 = r.delete("bikes:repairs")
  print(res45)  # >>> 0
  
  res46 = r.llen("bikes:repairs")
  print(res46)  # >>> 0
  
  res47 = r.lpop("bikes:repairs")
  print(res47)  # >>> None
  
  
  r.delete("bikes:repairs")
  
  res48 = r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res48)  # >>> 5
  
  res49 = r.ltrim("bikes:repairs", 0, 2)
  print(res49)  # >>> True
  
  res50 = r.lrange("bikes:repairs", 0, -1)
  print(res50)  # >>> ['bike:5', 'bike:4', 'bike:3']
  
  

  ▼ Commands: LPUSH, LMOVE, LRANGE

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • lpush(
      • name: KeyT,
      • *values: FieldT
      ) → Union[Awaitable[int], int]
  • LMOVE ( @write , @list , @slow )

    Returns an element after popping it from one list and pushing it to another. Deletes the list if the last element was moved.

    ▶ Method

    • lmove(
      • first_list: str,
      • second_list: str,
      • src: str = "LEFT",
      • dest: str = "RIGHT"
      ) → ResponseT
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Method

    • lrange(
      • name: KeyT,
      • start: int,
      • end: int
      ) → Union[Awaitable[list], list]

  Python Quick-Start

  import { createClient } from 'redis';
  
  const client = createClient();
  await client.connect();
  
  const res1 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res1);  // 1
  
  const res2 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res2);  // 2
  
  const res3 = await client.rPop('bikes:repairs');
  console.log(res3);  // bike:1
  
  const res4 = await client.rPop('bikes:repairs');
  console.log(res4);  // bike:2
  
  
  const res5 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res5);  // 1
  
  const res6 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res6); // 2
  
  const res7 = await client.lPop('bikes:repairs');
  console.log(res7);  // bike:2
  
  const res8 = await client.lPop('bikes:repairs');
  console.log(res8);  // bike:1
  
  
  const res9 = await client.lLen('bikes:repairs');
  console.log(res9); // 0
  
  
  const res10 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res10);  // 1
  
  const res11 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res11);  // 2
  
  const res12 = await client.lMove('bikes:repairs', 'bikes:finished', 'LEFT', 'LEFT');
  console.log(res12);  // 'bike:2'
  
  const res13 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res13);  // ['bike:1']
  
  const res14 = await client.lRange('bikes:finished', 0, -1);
  console.log(res14);  // ['bike:2']
  
  
  await client.del('bikes:repairs');
  
  const res15 = await client.rPush('bikes:repairs', 'bike:1');
  console.log(res15);  // 1
  
  const res16 = await client.rPush('bikes:repairs', 'bike:2');
  console.log(res16);  // 2
  
  const res17 = await client.lPush('bikes:repairs', 'bike:important_bike');
  console.log(res17);  // 3
  
  const res18 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res18);  // ['bike:important_bike', 'bike:1', 'bike:2']
  
  
  await client.del('bikes:repairs');
  
  const res19 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res19);  // 3
  
  const res20 = await client.lPush(
    'bikes:repairs', ['bike:important_bike', 'bike:very_important_bike']
  );
  console.log(res20);  // 5
  
  const res21 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res21);  // ['bike:very_important_bike', 'bike:important_bike', 'bike:1', 'bike:2', 'bike:3']
  
  
  await client.del('bikes:repairs');
  
  const res22 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res22);  // 3
  
  const res23 = await client.rPop('bikes:repairs');
  console.log(res23);  // 'bike:3'
  
  const res24 = await client.lPop('bikes:repairs');
  console.log(res24);  // 'bike:1'
  
  const res25 = await client.rPop('bikes:repairs');
  console.log(res25);  // 'bike:2'
  
  const res26 = await client.rPop('bikes:repairs');
  console.log(res26);  // null
  
  
  const res27 = await client.lPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res27);  // 5
  
  const res28 = await client.lTrim('bikes:repairs', 0, 2);
  console.log(res28);  // OK
  
  const res29 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res29);  // ['bike:5', 'bike:4', 'bike:3']
  
  
  await client.del('bikes:repairs');
  
  const res27eol = await client.rPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res27eol);  // 5
  
  const res28eol = await client.lTrim('bikes:repairs', -3, -1);
  console.log(res28eol);  // 'OK'
  
  const res29eol = await client.lRange('bikes:repairs', 0, -1);
  console.log(res29eol);  // ['bike:3', 'bike:4', 'bike:5']
  
  
  await client.del('bikes:repairs');
  
  const res31 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2']);
  console.log(res31);  // 2
  
  const res32 = await client.brPop('bikes:repairs', 1);
  console.log(res32);  // { key: 'bikes:repairs', element: 'bike:2' }
  
  const res33 = await client.brPop('bikes:repairs', 1);
  console.log(res33);  // { key: 'bikes:repairs', element: 'bike:1' }
  
  const res34 = await client.brPop('bikes:repairs', 1);
  console.log(res34);  // null
  
  
  const res35 = await client.del('new_bikes');
  console.log(res35); // 0
  
  const res36 = await client.lPush('new_bikes', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res36); // 3
  
  
  await client.del('new_bikes');
  
  const res37 = await client.set('new_bikes', 'bike:1');
  console.log(res37);  // 'OK'
  
  const res38 = await client.type('new_bikes');
  console.log(res38);  // 'string'
  
  try {
    const res39 = await client.lPush('new_bikes', 'bike:2', 'bike:3');
    // redis.exceptions.ResponseError:
    // [SimpleError: WRONGTYPE Operation against a key holding the wrong kind of value]
  }
  catch(e){
    console.log(e);
  }
  
  
  await client.del('bikes:repairs');
  
  await client.lPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res36);  // 3
  
  const res40 = await client.exists('bikes:repairs')
  console.log(res40);  // 1
  
  const res41 = await client.lPop('bikes:repairs');
  console.log(res41);  // 'bike:3'
  
  const res42 = await client.lPop('bikes:repairs');
  console.log(res42);  // 'bike:2'
  
  const res43 = await client.lPop('bikes:repairs');
  console.log(res43);  // 'bike:1'
  
  const res44 = await client.exists('bikes:repairs');
  console.log(res44);  // 0
  
  
  await client.del('bikes:repairs');
  
  const res45 = await client.del('bikes:repairs');
  console.log(res45);  // 0
  
  const res46 = await client.lLen('bikes:repairs');
  console.log(res46);  // 0
  
  const res47 = await client.lPop('bikes:repairs');
  console.log(res47);  // null
  
  
  await client.del('bikes:repairs');
  
  const res48 = await client.lPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res48);  // 5
  
  const res49 = await client.lTrim('bikes:repairs', 0, 2);
  console.log(res49);  // 'OK'
  
  const res50 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res50);  // ['bike:5', 'bike:4', 'bike:3']
  
  
  await client.close();
  

  ▼ Commands: LPUSH, LMOVE, LRANGE

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • LPUSH(
      • key: RedisArgument,
      • elements: RedisVariadicArgument
      ) → Any
  • LMOVE ( @write , @list , @slow )

    Returns an element after popping it from one list and pushing it to another. Deletes the list if the last element was moved.
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Method

    • LRANGE(
      • key: RedisArgument,
      • start: number,
      • stop: number
      ) → Any

  Node.js Quick-Start

  import redis.clients.jedis.UnifiedJedis;
  import redis.clients.jedis.args.ListDirection;
  import java.util.List;
  
  
  public class ListExample {
  
      public void run() {
          UnifiedJedis jedis = new UnifiedJedis("redis://localhost:6379");
  
  
          long res1 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res1);  // >>> 1
  
          long res2 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res2);  // >>> 2
  
          String res3 = jedis.rpop("bikes:repairs");
          System.out.println(res3);  // >>> bike:1
  
          String res4 = jedis.rpop("bikes:repairs");
          System.out.println(res4); // >>> bike:2
  
  
          long res5 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res5);  // >>> 1
  
          long res6 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res6);  // >>> 2
  
          String res7 = jedis.lpop("bikes:repairs");
          System.out.println(res7);  // >>> bike:2
  
          String res8 = jedis.lpop("bikes:repairs");
          System.out.println(res8);  // >>> bike:1
  
  
          long res9 = jedis.llen("bikes:repairs");
          System.out.println(res9);  // >>> 0
  
  
          long res10 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res10);  // >>> 1
  
          long res11 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res11);  // >>> 2
  
          String res12 = jedis.lmove("bikes:repairs", "bikes:finished", ListDirection.LEFT, ListDirection.LEFT);
          System.out.println(res12);  // >>> bike:2
  
          List<String> res13 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res13);  // >>> [bike:1]
  
          List<String> res14 = jedis.lrange("bikes:finished", 0, -1);
          System.out.println(res14);  // >>> [bike:2]
  
  
          jedis.del("bikes:repairs");
  
          long res15 = jedis.rpush("bikes:repairs", "bike:1");
          System.out.println(res15);  // >>> 1
  
          long res16 = jedis.rpush("bikes:repairs", "bike:2");
          System.out.println(res16);  // >>> 2
  
          long res17 = jedis.lpush("bikes:repairs", "bike:important_bike");
          System.out.println(res17);  // >>> 3
  
          List<String> res18 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res18);  // >>> [bike:important_bike, bike:1, bike:2]
  
  
          jedis.del("bikes:repairs");
          
          long res19 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res19);  // >>> 3
  
          long res20 = jedis.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike");
          System.out.println(res20);  // >>> 5
  
          List<String> res21 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res21);  // >>> [bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3]
  
  
          jedis.del("bikes:repairs");
  
          long res22 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res22);  // >>> 3
  
          String res23 = jedis.rpop("bikes:repairs");
          System.out.println(res23);  // >>> bike:3
  
          String res24 = jedis.lpop("bikes:repairs");
          System.out.println(res24);  // >>> bike:1
  
          String res25 = jedis.rpop("bikes:repairs");
          System.out.println(res25);  // >>> bike:2
  
          String res26 = jedis.rpop("bikes:repairs");
          System.out.println(res26);  // >>> null
  
  
          long res27 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res27);  // >>> 5
  
          String res28 = jedis.ltrim("bikes:repairs", 0, 2);
          System.out.println(res28);  // >>> OK
  
          List<String> res29 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res29);  // >>> [bike:1, bike:2, bike:3]
  
  
          jedis.del("bikes:repairs");
          
          res27 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res27);  // >>> 5
  
          res28 = jedis.ltrim("bikes:repairs", -3, -1);
          System.out.println(res2);  // >>> OK
  
          res29 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res29);  // >>> [bike:3, bike:4, bike:5]
  
  
          jedis.del("bikes:repairs");
  
          long res31 = jedis.rpush("bikes:repairs", "bike:1", "bike:2");
          System.out.println(res31);  // >>> 2
  
          List<String> res32 = jedis.brpop(1, "bikes:repairs");
          System.out.println(res32);  // >>> (bikes:repairs, bike:2)
  
          List<String>  res33 = jedis.brpop(1,"bikes:repairs");
          System.out.println(res33);  // >>> (bikes:repairs, bike:1)
  
          List<String>  res34 = jedis.brpop(1,"bikes:repairs");
          System.out.println(res34);  // >>> null
  
  
          jedis.del("new_bikes");
  
          long res36 = jedis.lpush("new_bikes", "bike:1", "bike:2", "bike:3");
          System.out.println(res36);  // >>> 3
  
  
          jedis.del("new_bikes");
          
          String res37 = jedis.set("new_bikes", "bike:1");
          System.out.println(res37);  // >>> OK
  
          String res38 = jedis.type("new_bikes");
          System.out.println(res38);  // >>> string
  
          try {
              long res39  = jedis.lpush("new_bikes", "bike:2", "bike:3");
          } catch (Exception e) {
              e.printStackTrace();
              // >>> redis.clients.jedis.exceptions.JedisDataException:
              // >>> WRONGTYPE Operation against a key holding the wrong kind of value
          }
  
  
          jedis.del("bikes:repairs");
  
          jedis.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res36);  // >>> 3
  
          boolean res40 = jedis.exists("bikes:repairs");
          System.out.println(res40);  // >>> true
  
          String res41 = jedis.lpop("bikes:repairs");
          System.out.println(res41);  // >>> bike:3
  
          String res42 = jedis.lpop("bikes:repairs");
          System.out.println(res42);  // >>> bike:2
  
          String res43 = jedis.lpop("bikes:repairs");
          System.out.println(res43);  // >>> bike:1
  
          boolean res44 = jedis.exists("bikes:repairs");
          System.out.println(res44);  // >>> false
  
  
          jedis.del("bikes:repairs");
  
          long res46 = jedis.llen("bikes:repairs");
          System.out.println(res46);  // >>> 0
  
          String res47 = jedis.lpop("bikes:repairs");
          System.out.println(res47);  // >>> null
  
  
          jedis.del("bikes:repairs");
  
          long res48 = jedis.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res48);  // >>> 5
  
          String res49 = jedis.ltrim("bikes:repairs", 0, 2);
          System.out.println(res49);  // >>> OK
  
          List<String> res50 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res50);  // >>> [bike:5, bike:4, bike:3]
  
  
          jedis.close();
      }
  }
  

  ▼ Commands: LPUSH, LMOVE, LRANGE

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Methods

    • lpush(
      • key: byte[],
      • strings: byte[]... // data to push
      ) → long // The number of elements inside the list after the push operation
    • lpush(
      • key: String,
      • strings: String... // data to push
      ) → long // The number of elements inside the list after the push operation
    • lpush(
      • key: String,
      • strings: String... // data to push
      ) → long // The number of elements inside the list after the push operation
  • LMOVE ( @write , @list , @slow )

    Returns an element after popping it from one list and pushing it to another. Deletes the list if the last element was moved.

    ▶ Methods

    • lmove(
      • srcKey: String,
      • dstKey: String,
      • to: ListDirection from final ListDirection // can be LEFT or RIGHT
      ) → String // The element being popped and pushed
    • lmove(
      • srcKey: String,
      • dstKey: String,
      • from: ListDirection, // can be LEFT or RIGHT
      • to: ListDirection // can be LEFT or RIGHT
      ) → String // The element being popped and pushed
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Methods

    • lrange(
      • key: String,
      • start: long,
      • stop: long
      ) → List<String> // A list of elements in the specified range
    • lrange(
      • key: String,
      • start: long,
      • stop: long
      ) → List<String> // A list of elements in the specified range

  Java-Sync Quick-Start

  package io.redis.examples.async;
  
  import io.lettuce.core.*;
  import io.lettuce.core.api.async.RedisAsyncCommands;
  import io.lettuce.core.api.StatefulRedisConnection;
  
  import java.util.concurrent.CompletableFuture;
  
  public class ListExample {
  
      public void run() {
          RedisClient redisClient = RedisClient.create("redis://localhost:6379");
  
          try (StatefulRedisConnection<String, String> connection = redisClient.connect()) {
              RedisAsyncCommands<String, String> asyncCommands = connection.async();
  
              CompletableFuture<Void> queue = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res1 -> {
                  System.out.println(res1); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res2 -> {
                  System.out.println(res2); // >>> 2
  
                  return asyncCommands.rpop("bikes:repairs");
              }).thenCompose(res3 -> {
                  System.out.println(res3); // >>> bike:1
  
                  return asyncCommands.rpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> bike:2
                      .toCompletableFuture();
              queue.join();
  
              CompletableFuture<Void> stack = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res4 -> {
                  System.out.println(res4); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res5 -> {
                  System.out.println(res5); // >>> 2
  
                  return asyncCommands.lpop("bikes:repairs");
              }).thenCompose(res6 -> {
                  System.out.println(res6); // >>> bike:2
  
                  return asyncCommands.lpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> bike:1
                      .toCompletableFuture();
              stack.join();
  
              CompletableFuture<Void> llen = asyncCommands.llen("bikes:repairs")
                      .thenAccept(System.out::println) // >>> 0
                      .toCompletableFuture();
              llen.join();
  
              CompletableFuture<Void> lmovelrange = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res7 -> {
                  System.out.println(res7); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res8 -> {
                  System.out.println(res8); // >>> 2
  
                  return asyncCommands.lmove("bikes:repairs", "bikes:finished", LMoveArgs.Builder.leftLeft());
              }).thenCompose(res9 -> {
                  System.out.println(res9); // >>> bike:2
  
                  return asyncCommands.lrange("bikes:repairs", 0, -1);
              }).thenCompose(res10 -> {
                  System.out.println(res10); // >>> [bike:1]
  
                  return asyncCommands.lrange("bikes:finished", 0, -1);
              })
                      .thenAccept(System.out::println) // >>> [bike:2]
                      .toCompletableFuture();
              lmovelrange.join();
  
  
              CompletableFuture<Void> lpushrpush = asyncCommands.rpush("bikes:repairs", "bike:1").thenCompose(res11 -> {
                  System.out.println(res11); // >>> 1
  
                  return asyncCommands.rpush("bikes:repairs", "bike:2");
              }).thenCompose(res12 -> {
                  System.out.println(res12); // >>> 2
  
                  return asyncCommands.lpush("bikes:repairs", "bike:important_bike");
              }).thenCompose(res13 -> {
                  System.out.println(res13); // >>> 3
  
                  return asyncCommands.lrange("bikes:repairs", 0, -1);
              })
                      .thenAccept(System.out::println)
                      // >>> [bike:important_bike, bike:1, bike:2]
                      .toCompletableFuture();
              lpushrpush.join();
  
  
              CompletableFuture<Void> variadic = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res14 -> {
                          System.out.println(res14); // >>> 3
  
                          return asyncCommands.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike");
                      }).thenCompose(res15 -> {
                          System.out.println(res15); // >>> 5
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3]
                      .toCompletableFuture();
              variadic.join();
  
  
              CompletableFuture<Void> lpoprpop = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res16 -> {
                          System.out.println(res16); // >>> 3
  
                          return asyncCommands.rpop("bikes:repairs");
                      }).thenCompose(res17 -> {
                          System.out.println(res17); // >>> bike:3
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res18 -> {
                          System.out.println(res18); // >>> bike:1
  
                          return asyncCommands.rpop("bikes:repairs");
                      }).thenCompose(res19 -> {
                          System.out.println(res19); // >>> bike:2
  
                          return asyncCommands.rpop("bikes:repairs");
                      })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              lpoprpop.join();
  
              CompletableFuture<Void> ltrim = asyncCommands
                      .lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res20 -> {
                          System.out.println(res20); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", 0, 2);
                      }).thenCompose(res21 -> {
                          System.out.println(res21); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:5, bike:4, bike:3]
                      .toCompletableFuture();
              ltrim.join();
  
  
              CompletableFuture<Void> ltrimendoflist = asyncCommands
                      .rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res22 -> {
                          System.out.println(res22); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", -3, -1);
                      }).thenCompose(res23 -> {
                          System.out.println(res23); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:3, bike:4, bike:5]
                      .toCompletableFuture();
              ltrimendoflist.join();
  
  
              CompletableFuture<Void> brpop = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2").thenCompose(res24 -> {
                  System.out.println(res24); // >>> 2
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              }).thenCompose(res25 -> {
                  System.out.println(res25);
                  // >>> KeyValue[bikes:repairs, bike:2]
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              }).thenCompose(res26 -> {
                  System.out.println(res26);
                  // >>> KeyValue[bikes:repairs, bike:1]
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              brpop.join();
  
              CompletableFuture<Void> rule1 = asyncCommands.del("new_bikes").thenCompose(res27 -> {
                  System.out.println(res27); // >>> 0
  
                  return asyncCommands.lpush("new_bikes", "bike:1", "bike:2", "bike:3");
              })
                      .thenAccept(System.out::println) // >>> 3
                      .toCompletableFuture();
              rule1.join();
  
              CompletableFuture<Void> rule11 = asyncCommands.set("new_bikes_string", "bike:1").thenCompose(res28 -> {
                  System.out.println(res28); // >>> OK
  
                  return asyncCommands.type("new_bikes_string");
              }).thenCompose(res29 -> {
                  System.out.println(res29); // >>> string
  
                  return asyncCommands.lpush("new_bikes_string", "bike:2", "bike:3");
              }).handle((res, ex) -> {
                  if (ex == null) {
                      return res;
                  } else {
                      System.out.println(ex);
                      // >>> java.util.concurrent.CompletionException:
                      // >>> io.lettuce.core.RedisCommandExecutionException:
                      // >>> WRONGTYPE Operation against a key holding the wrong
                      // >>> kind of value
  
                      return -1L;
                  }
              })
                      .thenAccept(System.out::println) // >>> -1
                      .toCompletableFuture();
              rule11.join();
  
  
              CompletableFuture<Void> rule2 = asyncCommands.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res30 -> {
                          System.out.println(res30); // >>> 3
  
                          return asyncCommands.exists("bikes:repairs");
                      }).thenCompose(res31 -> {
                          System.out.println(res31); // >>> 1
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res32 -> {
                          System.out.println(res32); // >>> bike:3
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res33 -> {
                          System.out.println(res33); // >>> bike:2
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res34 -> {
                          System.out.println(res34); // >>> bike:1
  
                          return asyncCommands.exists("bikes:repairs");
                      })
                      .thenAccept(System.out::println) // >>> 0
                      .toCompletableFuture();
              rule2.join();
  
              CompletableFuture<Void> rule3 = asyncCommands.del("bikes:repairs").thenCompose(res35 -> {
                  System.out.println(res35); // >>> 0
  
                  return asyncCommands.llen("bikes:repairs");
              }).thenCompose(res36 -> {
                  System.out.println(res36); // >>> 0
  
                  return asyncCommands.lpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              rule3.join();
  
              CompletableFuture<Void> ltrim1 = asyncCommands
                      .lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res37 -> {
                          System.out.println(res37); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", 0, 2);
                      }).thenCompose(res38 -> {
                          System.out.println(res38); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println) // >>> [bike:5, bike:4, bike:3]
                      .toCompletableFuture();
              ltrim1.join();
          } finally {
              redisClient.shutdown();
          }
      }
  
  }
  

  ▼ Commands: LPUSH, LMOVE, LRANGE

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • lpush(
      • key: K, // the key.
      • values: V... // the value.
      ) → RedisFuture<Long> // Long integer-reply the length of the list after the push operations.
  • LMOVE ( @write , @list , @slow )

    Returns an element after popping it from one list and pushing it to another. Deletes the list if the last element was moved.

    ▶ Method

    • lmove(
      • source: K, // the source key.
      • destination: K, // the destination type: key.
      • args: LMoveArgs // command arguments to configure source and destination directions.
      ) → RedisFuture<V> // V bulk-string-reply the element being popped and pushed. @since 6.1
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Methods

    • lrange(
      • key: K, // the key.
      • start: long, // the start type: long.
      • stop: long // the stop type: long.
      ) → RedisFuture<List<V>> // Long count of elements in the specified range.
    • lrange(
      • channel: ValueStreamingChannel<V>, // the channel.
      • key: K, // the key.
      • start: long, // the start type: long.
      • stop: long // the stop type: long.
      ) → RedisFuture<Long> // Long count of elements in the specified range.

  Java-Async Quick-Start

  package example_commands_test
  
  import (
  	"context"
  	"fmt"
  
  	"github.com/redis/go-redis/v9"
  )
  
  
  func ExampleClient_queue() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res1, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res1) // >>> 1
  
  	res2, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res2) // >>> 2
  
  	res3, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res3) // >>> bike:1
  
  	res4, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res4) // >>> bike:2
  
  }
  
  func ExampleClient_stack() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res5, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res5) // >>> 1
  
  	res6, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res6) // >>> 2
  
  	res7, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res7) // >>> bike:2
  
  	res8, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res8) // >>> bike:1
  
  }
  
  func ExampleClient_llen() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res9, err := rdb.LLen(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res9) // >>> 0
  
  }
  
  func ExampleClient_lmove_lrange() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res10, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res10) // >>> 1
  
  	res11, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res11) // >>> 2
  
  	res12, err := rdb.LMove(ctx, "bikes:repairs", "bikes:finished", "LEFT", "LEFT").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res12) // >>> bike:2
  
  	res13, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res13) // >>> [bike:1]
  
  	res14, err := rdb.LRange(ctx, "bikes:finished", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res14) // >>> [bike:2]
  
  }
  
  func ExampleClient_lpush_rpush() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res15, err := rdb.RPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res15) // >>> 1
  
  	res16, err := rdb.RPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res16) // >>> 2
  
  	res17, err := rdb.LPush(ctx, "bikes:repairs", "bike:important_bike").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res17) // >>> 3
  
  	res18, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res18) // >>> [bike:important_bike bike:1 bike:2]
  
  }
  
  func ExampleClient_variadic() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res19, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res19) // >>> 3
  
  	res20, err := rdb.LPush(ctx, "bikes:repairs", "bike:important_bike", "bike:very_important_bike").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res20) // >>> 5
  
  	res21, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res21) // >>> [bike:very_important_bike bike:important_bike bike:1 bike:2 bike:3]
  
  }
  
  func ExampleClient_lpop_rpop() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res22, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res22) // >>> 3
  
  	res23, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res23) // >>> bike:3
  
  	res24, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res24) // >>> bike:1
  
  	res25, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res25) // >>> bike:2
  
  	res26, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res26) // >>> <empty string>
  
  
  }
  
  func ExampleClient_ltrim() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res27, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res27) // >>> 5
  
  	res28, err := rdb.LTrim(ctx, "bikes:repairs", 0, 2).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res28) // >>> OK
  
  	res29, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res29) // >>> [bike:1 bike:2 bike:3]
  
  }
  
  func ExampleClient_ltrim_end_of_list() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res30, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res30) // >>> 5
  
  	res31, err := rdb.LTrim(ctx, "bikes:repairs", -3, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res31) // >>> OK
  
  	res32, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res32) // >>> [bike:3 bike:4 bike:5]
  
  }
  
  func ExampleClient_brpop() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res33, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res33) // >>> 2
  
  	res34, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res34) // >>> [bikes:repairs bike:2]
  
  	res35, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res35) // >>> [bikes:repairs bike:1]
  
  	res36, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res36) // >>> []
  
  }
  
  func ExampleClient_rule1() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res37, err := rdb.Del(ctx, "new_bikes").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res37) // >>> 0
  
  	res38, err := rdb.LPush(ctx, "new_bikes", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res38) // >>> 3
  
  }
  
  func ExampleClient_rule11() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "new_bikes")
  
  	res39, err := rdb.Set(ctx, "new_bikes", "bike:1", 0).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res39) // >>> OK
  
  	res40, err := rdb.Type(ctx, "new_bikes").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res40) // >>> string
  
  	res41, err := rdb.LPush(ctx, "new_bikes", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		fmt.Println(err)
  		// >>> WRONGTYPE Operation against a key holding the wrong kind of value
  	}
  
  	fmt.Println(res41)
  
  }
  
  func ExampleClient_rule2() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  	res42, err := rdb.LPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res42) // >>> 3
  
  	res43, err := rdb.Exists(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res43) // >>> 1
  
  	res44, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res44) // >>> bike:3
  
  	res45, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res45) // >>> bike:2
  
  	res46, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res46) // >>> bike:1
  
  	res47, err := rdb.Exists(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res47) // >>> 0
  
  }
  
  func ExampleClient_rule3() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res48, err := rdb.Del(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res48) // >>> 0
  
  	res49, err := rdb.LLen(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res49) // >>> 0
  
  	res50, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res50) // >>> <empty string>
  
  }
  
  func ExampleClient_ltrim1() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res51, err := rdb.LPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res51) // >>> 5
  
  	res52, err := rdb.LTrim(ctx, "bikes:repairs", 0, 2).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res52) // >>> OK
  
  	res53, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res53) // >>> [bike:5 bike:4 bike:3]
  
  }
  

  ▼ Commands: LPUSH, LMOVE, LRANGE

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • LPush(
      • ctx: context.Context,
      • key: string,
      • values: ...interface{}
      ) → *IntCmd
  • LMOVE ( @write , @list , @slow )

    Returns an element after popping it from one list and pushing it to another. Deletes the list if the last element was moved.

    ▶ Method

    • LMove(
      • ctx: context.Context,
      • source: Any,
      • destination: Any,
      • srcpos: Any,
      • destpos: string
      ) → *StringCmd
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Method

    • LRange(
      • ctx: context.Context,
      • key: string,
      • start: Any,
      • stop: int64
      ) → *StringSliceCmd

  Go Quick-Start

  using NRedisStack;
  using StackExchange.Redis;
  
  public class ListExample
  {
      public void Run()
      {
          var muxer = ConnectionMultiplexer.Connect("localhost:6379");
          var db = muxer.GetDatabase();
  
  
          long res1 = db.ListLeftPush("bikes:repairs", "bike:1");
          Console.WriteLine(res1);    // >>> 1
  
          long res2 = db.ListLeftPush("bikes:repairs", "bike:2");
          Console.WriteLine(res2);    // >>> 2
  
          RedisValue res3 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res3);    // >>> "bike:1"
  
          RedisValue res4 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res4); // >>> "bike:2"
  
  
          long res5 = db.ListLeftPush("bikes:repairs", "bike:1");
          Console.WriteLine(res5);    // >>> 1
  
          long res6 = db.ListLeftPush("bikes:repairs", "bike:2");
          Console.WriteLine(res6);    // >>> 2
  
          RedisValue res7 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res7);    // >>> "bike:2"
  
          RedisValue res8 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res8);    // >>> "bike:1"
  
  
  
          long res9 = db.ListLength("bikes:repairs");
          Console.WriteLine(res9);    // >>> 0
  
  
  
          long res10 = db.ListLeftPush("{bikes}:repairs", "bike:1");
          Console.WriteLine(res10);   // >>> 1
  
          long res11 = db.ListLeftPush("{bikes}:repairs", "bike:2");
          Console.WriteLine(res11);   // >>> 2
  
          RedisValue res12 = db.ListMove("{bikes}:repairs", "{bikes}:finished", ListSide.Left, ListSide.Left);
          Console.Write(res12);   // >>> "bike:2"
  
          RedisValue[] res13 = db.ListRange("{bikes}:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res13));    // >>> "bike:1"
  
          RedisValue[] res14 = db.ListRange("{bikes}:finished", 0, -1);
          Console.WriteLine(string.Join(", ", res14));    // >>> "bike:2"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res15 = db.ListRightPush("bikes:repairs", "bike:1");
          Console.WriteLine(res15);   // >>> 1
  
          long res16 = db.ListRightPush("bikes:repairs", "bike:2");
          Console.WriteLine(res16);   // >>> 2
  
          long res17 = db.ListLeftPush("bikes:repairs", "bike:important_bike");
          Console.WriteLine(res17);   // >>> 3
  
          RedisValue[] res18 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res18));    // >>> "bike:important_bike, bike:1, bike:2"
  
  
          db.KeyDelete("bikes:repairs");
          
          long res19 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res19);   // >>> 3
  
          long res20 = db.ListLeftPush("bikes:repairs", ["bike:important_bike", "bike:very_important_bike"]);
          Console.WriteLine(res20);   // >>> 5
  
          RedisValue[] res21 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res21));
          // >>> "bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res22 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res22);   // >>> 3
  
          RedisValue res23 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res23);   // >>> "bike:3"
  
          RedisValue res24 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res24);   // >>> "bike:1"
  
          RedisValue res25 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res25);   // >>> "bike:2"
  
          RedisValue res26 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res26);   // >>> <Empty string>
  
  
          long res27 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res27);   // >>> 5
  
          db.ListTrim("bikes:repairs", 0, 2);
          RedisValue[] res28 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res28));    // "bike:5, bike:4, bike:3"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res29 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res29);   // >>> 5
  
          db.ListTrim("bikes:repairs", -3, -1);
          RedisValue[] res30 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res30));    // >>> "bike:3, bike:4, bike:5"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res31 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2"]);
          Console.WriteLine(res31);   // >>> 2
  
          Tuple<RedisKey, RedisValue>? res32 = db.BRPop(["bikes:repairs"], 1);
  
          if (res32 != null)
              Console.WriteLine($"{res32.Item1} -> {res32.Item2}"); // >>> "bikes:repairs -> bike:2"
  
          Tuple<RedisKey, RedisValue>? res33 = db.BRPop(["bikes:repairs"], 1);
  
          if (res33 != null)
              Console.WriteLine($"{res33.Item1} -> {res33.Item2}"); // >>> "bikes:repairs -> bike:1"
  
          Tuple<RedisKey, RedisValue>? res34 = db.BRPop(["bikes:repairs"], 1);
          Console.WriteLine(res34);   // >>> "Null"
  
  
          db.KeyDelete("new_bikes");
  
          long res36 = db.ListRightPush("new_bikes", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res36);   // >>> 3
  
  
          db.KeyDelete("new_bikes");
          
          bool res37 = db.StringSet("new_bikes", "bike:1");
          Console.WriteLine(res37);   // >>> True
  
          RedisType res38 = db.KeyType("new_bikes");
          Console.WriteLine(res38);   // >>> RedisType.String
  
          try
          {
              long res39 = db.ListRightPush("new_bikes", ["bike:2", "bike:3"]);
          }
          catch (Exception e)
          {
              Console.WriteLine(e);
          }
  
  
          db.KeyDelete("bikes:repairs");
  
          long res40 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res40);   // >>> 3
  
          bool res41 = db.KeyExists("bikes:repairs");
          Console.WriteLine(res41);   // >>> True
  
          RedisValue res42 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res42);   // >>> "bike:3"
  
          RedisValue res43 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res43);   // >>> "bike:2"
  
          RedisValue res44 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res44);   //  >>> "bike:1"
  
          bool res45 = db.KeyExists("bikes:repairs");
          Console.WriteLine(res45);   // >>> False
  
  
          db.KeyDelete("bikes:repairs");
  
          long res47 = db.ListLength("bikes:repairs");
          Console.WriteLine(res47);   // >>> 0
  
          RedisValue res48 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res48);   // >>> Null
  
  
          db.KeyDelete("bikes:repairs");
  
          long res49 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res49);   // >>> 5
  
          db.ListTrim("bikes:repairs", 0, 2);
          RedisValue[] res50 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res50));    // >>> "bike:5, bike:4, bike:3"
  
  
      }
  }
  

  ▼ Commands: LPUSH, LMOVE, LRANGE

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Methods

    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • value: RedisValue,
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the head of the list.
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the head of the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • value: RedisValue,
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
    • ListLeftPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the head of the list.
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operations.
  • LMOVE ( @write , @list , @slow )

    Returns an element after popping it from one list and pushing it to another. Deletes the list if the last element was moved.

    ▶ Methods

    • ListMove(
      • sourceKey: RedisKey, // The key of the list to remove from.
      • destinationKey: RedisKey, // The key of the list to move to.
      • sourceSide: ListSide, // What side of the sourceKey list to remove from.
      • destinationSide: ListSide, // What side of the destinationKey list to move to.
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue // The element being popped and pushed or Null if there is no element to move.
    • ListMove(
      • sourceKey: RedisKey, // The key of the list to remove from.
      • destinationKey: RedisKey, // The key of the list to move to.
      • sourceSide: ListSide, // What side of the sourceKey list to remove from.
      • destinationSide: ListSide, // What side of the destinationKey list to move to.
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue // The element being popped and pushed or Null if there is no element to move.
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Methods

    • ListRange(
      • key: RedisKey, // The key of the list.
      • start: long, // The start index of the list.
      • stop: long, // The stop index of the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue[] // List of elements in the specified range.
    • ListRange(
      • key: RedisKey, // The key of the list.
      • start: long, // The start index of the list.
      • stop: long, // The stop index of the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue[] // List of elements in the specified range.

  C#-Sync Quick-Start

  <?php
  
  require 'vendor/autoload.php';
  
  use Predis\Client as PredisClient;
  
  class DtListTest
  {
      public function testDtList() {
          $r = new PredisClient([
              'scheme'   => 'tcp',
              'host'     => '127.0.0.1',
              'port'     => 6379,
              'password' => '',
              'database' => 0,
          ]);
  
          $res1 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res1 . PHP_EOL;
          // >>> 1
  
          $res2 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res2 . PHP_EOL;
          // >>> 2
  
          $res3 = $r->rpop('bikes:repairs');
          echo $res3 . PHP_EOL;
          // >>> bike:1
  
          $res4 = $r->rpop('bikes:repairs');
          echo $res4 . PHP_EOL;
          // >>> bike:2
  
          $res5 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res5 . PHP_EOL;
          // >>> 1
  
          $res6 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res6 . PHP_EOL;
          // >>> 2
  
          $res7 = $r->lpop('bikes:repairs');
          echo $res7 . PHP_EOL;
          // >>> bike:2
  
          $res8 = $r->lpop('bikes:repairs');
          echo $res8 . PHP_EOL;
          // >>> bike:1
  
          $res9 = $r->llen('bikes:repairs');
          echo $res9 . PHP_EOL;
          // >>> 0
  
          $res10 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res10 . PHP_EOL;
          // >>> 1
  
          $res11 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res11 . PHP_EOL;
          // >>> 2
  
          $res12 = $r->lmove('bikes:repairs', 'bikes:finished', 'LEFT', 'LEFT');
          echo $res12 . PHP_EOL;
          // >>> 'bike:2'
  
          $res13 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res13) . PHP_EOL;
          // >>> ['bike:1']
  
          $res14 = $r->lrange('bikes:finished', 0, -1);
          echo json_encode($res14) . PHP_EOL;
          // >>> ['bike:2']
  
          $r->del('bikes:repairs');
          
          $res15 = $r->rpush('bikes:repairs', 'bike:1');
          echo $res15 . PHP_EOL;
          // >>> 1
  
          $res16 = $r->rpush('bikes:repairs', 'bike:2');
          echo $res16 . PHP_EOL;
          // >>> 2
  
          $res17 = $r->lpush('bikes:repairs', 'bike:important_bike');
          echo $res17 . PHP_EOL;
          // >>> 3
  
          $res18 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res18) . PHP_EOL;
          // >>> ['bike:important_bike', 'bike:1', 'bike:2']
  
          $r->del('bikes:repairs');
  
          $res19 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res19 . PHP_EOL;
          // >>> 3
  
          $res20 = $r->lpush('bikes:repairs', 'bike:important_bike', 'bike:very_important_bike');
          echo $res20 . PHP_EOL;
          // >>> 5
  
          $res21 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res21) . PHP_EOL;
          // >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
  
          $r->del('bikes:repairs');
          
          $res22 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res22 . PHP_EOL;
          // >>> 3
  
          $res23 = $r->rpop('bikes:repairs');
          echo $res23 . PHP_EOL;
          // >>> 'bike:3'
  
          $res24 = $r->lpop('bikes:repairs');
          echo $res24 . PHP_EOL;
          // >>> 'bike:1'
  
          $res25 = $r->rpop('bikes:repairs');
          echo $res25 . PHP_EOL;
          // >>> 'bike:2'
  
          $res26 = $r->rpop('bikes:repairs');
          echo $res26 . PHP_EOL;
          // >>> None
  
          $res27 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res27 . PHP_EOL;
          // >>> 5
  
          $res28 = $r->ltrim('bikes:repairs', 0, 2);
          echo $res28 . PHP_EOL;
          // >>> True
  
          $res29 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res29) . PHP_EOL;
          // >>> ['bike:1', 'bike:2', 'bike:3']
  
          $r->del('bikes:repairs');
  
          $res27 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res27 . PHP_EOL;
          // >>> 5
  
          $res28 = $r->ltrim('bikes:repairs', -3, -1);
          echo $res28 . PHP_EOL;
          // >>> True
  
          $res29 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res29) . PHP_EOL;
          // >>> ['bike:3', 'bike:4', 'bike:5']
  
          $r->del('bikes:repairs');
  
          $res31 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2');
          echo $res31 . PHP_EOL;
          // >>> 2
  
          $res32 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res32) . PHP_EOL;
          // >>> ['bikes:repairs', 'bike:2']
  
          $res33 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res33) . PHP_EOL;
          // >>> ['bikes:repairs', 'bike:1']
  
          $res34 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res34) . PHP_EOL;
          // >>> None
  
          $res35 = $r->del('new_bikes');
          echo $res35 . PHP_EOL;
          // >>> 0
  
          $res36 = $r->lpush('new_bikes', 'bike:1', 'bike:2', 'bike:3');
          echo $res36 . PHP_EOL;
          // >>> 3
  
          $r->del('new_bikes');
  
          $res37 = $r->set('new_bikes', 'bike:1');
          echo $res37 . PHP_EOL;
          // >>> True
  
          $res38 = $r->type('new_bikes');
          echo $res38 . PHP_EOL;
          // >>> 'string'
  
          try {
              $res39 = $r->lpush('new_bikes', 'bike:2', 'bike:3');
              // >>> redis.exceptions.ResponseError:
              // >>> WRONGTYPE Operation against a key holding the wrong kind of value
          } catch (\Predis\Response\ServerException $e) {
              echo $e->getMessage() . PHP_EOL;
          }
  
          $r->del('bikes:repairs');
          $res36 = $r->lpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res36 . PHP_EOL;
          // >>> 3
  
          $res40 = $r->exists('bikes:repairs');
          echo $res40 . PHP_EOL;
          // >>> 1
  
          $res41 = $r->lpop('bikes:repairs');
          echo $res41 . PHP_EOL;
          // >>> 'bike:3'
  
          $res42 = $r->lpop('bikes:repairs');
          echo $res42 . PHP_EOL;
          // >>> 'bike:2'
  
          $res43 = $r->lpop('bikes:repairs');
          echo $res43 . PHP_EOL;
          // >>> 'bike:1'
  
          $res44 = $r->exists('bikes:repairs');
          echo $res44 . PHP_EOL;
          // >>> False
  
          $res45 = $r->del('bikes:repairs');
          echo $res45 . PHP_EOL;
          // >>> 0
  
          $res46 = $r->llen('bikes:repairs');
          echo $res46 . PHP_EOL;
          // >>> 0
  
          $res47 = $r->lpop('bikes:repairs');
          echo $res47 . PHP_EOL;
          // >>> None
  
          $res48 = $r->lpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res48 . PHP_EOL;
          // >>> 5
  
          $res49 = $r->ltrim('bikes:repairs', 0, 2);
          echo $res49 . PHP_EOL;
          // >>> True
  
          $res50 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res50) . PHP_EOL;
          // >>> ['bike:5', 'bike:4', 'bike:3']
      }
  }
  
  

  ▼ Commands: LPUSH, LMOVE, LRANGE

  • LPUSH ( @write , @list , @fast )

    Prepends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • lpush(
      • $key: string,
      • $values: array
      ) → int
  • LMOVE ( @write , @list , @slow )

    Returns an element after popping it from one list and pushing it to another. Deletes the list if the last element was moved.

    ▶ Method

    • lmove(
      • $source: string,
      • $destination: string,
      • $where: string,
      • $to: string
      ) → string
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Method

    • lrange(
      • $key: string,
      • $start: int,
      • $stop: int
      ) → string[]

  PHP Quick-Start

• To limit the length of a list you can call LTRIM:

  Language: >_ Redis CLI Python JavaScript (node-redis) Java-Sync Java-Async Go C#-Sync PHP

  Copied!

  Copied!

  Capped lists: Use LTRIM to keep only a specific range of elements when you need to maintain a fixed-size list

  > DEL bikes:repairs
  (integer) 1
  > RPUSH bikes:repairs bike:1 bike:2 bike:3 bike:4 bike:5
  (integer) 5
  > LTRIM bikes:repairs 0 2
  OK
  > LRANGE bikes:repairs 0 -1
  1) "bike:1"
  2) "bike:2"
  3) "bike:3"

  ▼ Commands: DEL, RPUSH, LTRIM, LRANGE

  • DEL ( @keyspace , @write , @slow )

    Deletes one or more keys.
  • RPUSH ( @write , @list , @fast )

    Appends one or more elements to a list. Creates the key if it doesn't exist.
  • LTRIM ( @write , @list , @slow )

    Removes elements from both ends a list. Deletes the list if all elements were trimmed.
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

  Redis CLI guide

  Also, check out our other client tools Redis Insight and Redis for VS Code.

  """
  Code samples for List doc pages:
      https://redis.io/docs/latest/develop/data-types/lists/
  """
  
  import redis
  
  r = redis.Redis(decode_responses=True)
  
  res1 = r.lpush("bikes:repairs", "bike:1")
  print(res1)  # >>> 1
  
  res2 = r.lpush("bikes:repairs", "bike:2")
  print(res2)  # >>> 2
  
  res3 = r.rpop("bikes:repairs")
  print(res3)  # >>> bike:1
  
  res4 = r.rpop("bikes:repairs")
  print(res4)  # >>> bike:2
  
  
  res5 = r.lpush("bikes:repairs", "bike:1")
  print(res5)  # >>> 1
  
  res6 = r.lpush("bikes:repairs", "bike:2")
  print(res6)  # >>> 2
  
  res7 = r.lpop("bikes:repairs")
  print(res7)  # >>> bike:2
  
  res8 = r.lpop("bikes:repairs")
  print(res8)  # >>> bike:1
  
  
  res9 = r.llen("bikes:repairs")
  print(res9)  # >>> 0
  
  
  res10 = r.lpush("bikes:repairs", "bike:1")
  print(res10)  # >>> 1
  
  res11 = r.lpush("bikes:repairs", "bike:2")
  print(res11)  # >>> 2
  
  res12 = r.lmove("bikes:repairs", "bikes:finished", "LEFT", "LEFT")
  print(res12)  # >>> 'bike:2'
  
  res13 = r.lrange("bikes:repairs", 0, -1)
  print(res13)  # >>> ['bike:1']
  
  res14 = r.lrange("bikes:finished", 0, -1)
  print(res14)  # >>> ['bike:2']
  
  
  r.delete("bikes:repairs")
  
  res15 = r.rpush("bikes:repairs", "bike:1")
  print(res15)  # >>> 1
  
  res16 = r.rpush("bikes:repairs", "bike:2")
  print(res16)  # >>> 2
  
  res17 = r.lpush("bikes:repairs", "bike:important_bike")
  print(res17)  # >>> 3
  
  res18 = r.lrange("bikes:repairs", 0, -1)
  print(res18)  # >>> ['bike:important_bike', 'bike:1', 'bike:2']
  
  
  r.delete("bikes:repairs")
  
  res19 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res19)  # >>> 3
  
  res20 = r.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike")
  print(res20)  # >>> 5
  
  res21 = r.lrange("bikes:repairs", 0, -1)
  print(
      res21
  )  # >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
  
  
  r.delete("bikes:repairs")
  
  res22 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res22)  # >>> 3
  
  res23 = r.rpop("bikes:repairs")
  print(res23)  # >>> 'bike:3'
  
  res24 = r.lpop("bikes:repairs")
  print(res24)  # >>> 'bike:1'
  
  res25 = r.rpop("bikes:repairs")
  print(res25)  # >>> 'bike:2'
  
  res26 = r.rpop("bikes:repairs")
  print(res26)  # >>> None
  
  
  res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res27)  # >>> 5
  
  res28 = r.ltrim("bikes:repairs", 0, 2)
  print(res28)  # >>> True
  
  res29 = r.lrange("bikes:repairs", 0, -1)
  print(res29)  # >>> ['bike:1', 'bike:2', 'bike:3']
  
  
  r.delete("bikes:repairs")
  
  res27 = r.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res27)  # >>> 5
  
  res28 = r.ltrim("bikes:repairs", -3, -1)
  print(res28)  # >>> True
  
  res29 = r.lrange("bikes:repairs", 0, -1)
  print(res29)  # >>> ['bike:3', 'bike:4', 'bike:5']
  
  
  r.delete("bikes:repairs")
  
  res31 = r.rpush("bikes:repairs", "bike:1", "bike:2")
  print(res31)  # >>> 2
  
  res32 = r.brpop("bikes:repairs", timeout=1)
  print(res32)  # >>> ('bikes:repairs', 'bike:2')
  
  res33 = r.brpop("bikes:repairs", timeout=1)
  print(res33)  # >>> ('bikes:repairs', 'bike:1')
  
  res34 = r.brpop("bikes:repairs", timeout=1)
  print(res34)  # >>> None
  
  
  res35 = r.delete("new_bikes")
  print(res35)  # >>> 0
  
  res36 = r.lpush("new_bikes", "bike:1", "bike:2", "bike:3")
  print(res36)  # >>> 3
  
  
  r.delete("new_bikes")
  
  res37 = r.set("new_bikes", "bike:1")
  print(res37)  # >>> True
  
  res38 = r.type("new_bikes")
  print(res38)  # >>> 'string'
  
  try:
      res39 = r.lpush("new_bikes", "bike:2", "bike:3")
      # >>> redis.exceptions.ResponseError:
      # >>> WRONGTYPE Operation against a key holding the wrong kind of value
  except redis.exceptions.ResponseError as e:
      print(e)
  
  
  r.delete("bikes:repairs")
  
  r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
  print(res36)  # >>> 3
  
  res40 = r.exists("bikes:repairs")
  print(res40)  # >>> 1
  
  res41 = r.lpop("bikes:repairs")
  print(res41)  # >>> 'bike:3'
  
  res42 = r.lpop("bikes:repairs")
  print(res42)  # >>> 'bike:2'
  
  res43 = r.lpop("bikes:repairs")
  print(res43)  # >>> 'bike:1'
  
  res44 = r.exists("bikes:repairs")
  print(res44)  # >>> False
  
  
  r.delete("bikes:repairs")
  
  res45 = r.delete("bikes:repairs")
  print(res45)  # >>> 0
  
  res46 = r.llen("bikes:repairs")
  print(res46)  # >>> 0
  
  res47 = r.lpop("bikes:repairs")
  print(res47)  # >>> None
  
  
  r.delete("bikes:repairs")
  
  res48 = r.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5")
  print(res48)  # >>> 5
  
  res49 = r.ltrim("bikes:repairs", 0, 2)
  print(res49)  # >>> True
  
  res50 = r.lrange("bikes:repairs", 0, -1)
  print(res50)  # >>> ['bike:5', 'bike:4', 'bike:3']
  
  

  ▼ Commands: DEL, RPUSH, LTRIM, LRANGE

  • DEL ( @keyspace , @write , @slow )

    Deletes one or more keys.

    ▶ Method

    • delete(
      • names: KeyT
      ) → int
  • RPUSH ( @write , @list , @fast )

    Appends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • rpush(
      • name: KeyT,
      • *values: FieldT
      ) → Union[Awaitable[int], int]
  • LTRIM ( @write , @list , @slow )

    Removes elements from both ends a list. Deletes the list if all elements were trimmed.

    ▶ Method

    • ltrim(
      • name: KeyT,
      • start: int,
      • end: int
      ) → Union[Awaitable[str], str]
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Method

    • lrange(
      • name: KeyT,
      • start: int,
      • end: int
      ) → Union[Awaitable[list], list]

  Python Quick-Start

  import { createClient } from 'redis';
  
  const client = createClient();
  await client.connect();
  
  const res1 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res1);  // 1
  
  const res2 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res2);  // 2
  
  const res3 = await client.rPop('bikes:repairs');
  console.log(res3);  // bike:1
  
  const res4 = await client.rPop('bikes:repairs');
  console.log(res4);  // bike:2
  
  
  const res5 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res5);  // 1
  
  const res6 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res6); // 2
  
  const res7 = await client.lPop('bikes:repairs');
  console.log(res7);  // bike:2
  
  const res8 = await client.lPop('bikes:repairs');
  console.log(res8);  // bike:1
  
  
  const res9 = await client.lLen('bikes:repairs');
  console.log(res9); // 0
  
  
  const res10 = await client.lPush('bikes:repairs', 'bike:1');
  console.log(res10);  // 1
  
  const res11 = await client.lPush('bikes:repairs', 'bike:2');
  console.log(res11);  // 2
  
  const res12 = await client.lMove('bikes:repairs', 'bikes:finished', 'LEFT', 'LEFT');
  console.log(res12);  // 'bike:2'
  
  const res13 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res13);  // ['bike:1']
  
  const res14 = await client.lRange('bikes:finished', 0, -1);
  console.log(res14);  // ['bike:2']
  
  
  await client.del('bikes:repairs');
  
  const res15 = await client.rPush('bikes:repairs', 'bike:1');
  console.log(res15);  // 1
  
  const res16 = await client.rPush('bikes:repairs', 'bike:2');
  console.log(res16);  // 2
  
  const res17 = await client.lPush('bikes:repairs', 'bike:important_bike');
  console.log(res17);  // 3
  
  const res18 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res18);  // ['bike:important_bike', 'bike:1', 'bike:2']
  
  
  await client.del('bikes:repairs');
  
  const res19 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res19);  // 3
  
  const res20 = await client.lPush(
    'bikes:repairs', ['bike:important_bike', 'bike:very_important_bike']
  );
  console.log(res20);  // 5
  
  const res21 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res21);  // ['bike:very_important_bike', 'bike:important_bike', 'bike:1', 'bike:2', 'bike:3']
  
  
  await client.del('bikes:repairs');
  
  const res22 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res22);  // 3
  
  const res23 = await client.rPop('bikes:repairs');
  console.log(res23);  // 'bike:3'
  
  const res24 = await client.lPop('bikes:repairs');
  console.log(res24);  // 'bike:1'
  
  const res25 = await client.rPop('bikes:repairs');
  console.log(res25);  // 'bike:2'
  
  const res26 = await client.rPop('bikes:repairs');
  console.log(res26);  // null
  
  
  const res27 = await client.lPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res27);  // 5
  
  const res28 = await client.lTrim('bikes:repairs', 0, 2);
  console.log(res28);  // OK
  
  const res29 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res29);  // ['bike:5', 'bike:4', 'bike:3']
  
  
  await client.del('bikes:repairs');
  
  const res27eol = await client.rPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res27eol);  // 5
  
  const res28eol = await client.lTrim('bikes:repairs', -3, -1);
  console.log(res28eol);  // 'OK'
  
  const res29eol = await client.lRange('bikes:repairs', 0, -1);
  console.log(res29eol);  // ['bike:3', 'bike:4', 'bike:5']
  
  
  await client.del('bikes:repairs');
  
  const res31 = await client.rPush('bikes:repairs', ['bike:1', 'bike:2']);
  console.log(res31);  // 2
  
  const res32 = await client.brPop('bikes:repairs', 1);
  console.log(res32);  // { key: 'bikes:repairs', element: 'bike:2' }
  
  const res33 = await client.brPop('bikes:repairs', 1);
  console.log(res33);  // { key: 'bikes:repairs', element: 'bike:1' }
  
  const res34 = await client.brPop('bikes:repairs', 1);
  console.log(res34);  // null
  
  
  const res35 = await client.del('new_bikes');
  console.log(res35); // 0
  
  const res36 = await client.lPush('new_bikes', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res36); // 3
  
  
  await client.del('new_bikes');
  
  const res37 = await client.set('new_bikes', 'bike:1');
  console.log(res37);  // 'OK'
  
  const res38 = await client.type('new_bikes');
  console.log(res38);  // 'string'
  
  try {
    const res39 = await client.lPush('new_bikes', 'bike:2', 'bike:3');
    // redis.exceptions.ResponseError:
    // [SimpleError: WRONGTYPE Operation against a key holding the wrong kind of value]
  }
  catch(e){
    console.log(e);
  }
  
  
  await client.del('bikes:repairs');
  
  await client.lPush('bikes:repairs', ['bike:1', 'bike:2', 'bike:3']);
  console.log(res36);  // 3
  
  const res40 = await client.exists('bikes:repairs')
  console.log(res40);  // 1
  
  const res41 = await client.lPop('bikes:repairs');
  console.log(res41);  // 'bike:3'
  
  const res42 = await client.lPop('bikes:repairs');
  console.log(res42);  // 'bike:2'
  
  const res43 = await client.lPop('bikes:repairs');
  console.log(res43);  // 'bike:1'
  
  const res44 = await client.exists('bikes:repairs');
  console.log(res44);  // 0
  
  
  await client.del('bikes:repairs');
  
  const res45 = await client.del('bikes:repairs');
  console.log(res45);  // 0
  
  const res46 = await client.lLen('bikes:repairs');
  console.log(res46);  // 0
  
  const res47 = await client.lPop('bikes:repairs');
  console.log(res47);  // null
  
  
  await client.del('bikes:repairs');
  
  const res48 = await client.lPush(
    'bikes:repairs', ['bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5']
  );
  console.log(res48);  // 5
  
  const res49 = await client.lTrim('bikes:repairs', 0, 2);
  console.log(res49);  // 'OK'
  
  const res50 = await client.lRange('bikes:repairs', 0, -1);
  console.log(res50);  // ['bike:5', 'bike:4', 'bike:3']
  
  
  await client.close();
  

  ▼ Commands: DEL, RPUSH, LTRIM, LRANGE

  • DEL ( @keyspace , @write , @slow )

    Deletes one or more keys.

    ▶ Method

    • DEL(
      • keys: RedisVariadicArgument
      ) → Any
  • RPUSH ( @write , @list , @fast )

    Appends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • RPUSH(
      • key: RedisArgument,
      • element: RedisVariadicArgument
      ) → Any
  • LTRIM ( @write , @list , @slow )

    Removes elements from both ends a list. Deletes the list if all elements were trimmed.
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Method

    • LRANGE(
      • key: RedisArgument,
      • start: number,
      • stop: number
      ) → Any

  Node.js Quick-Start

  import redis.clients.jedis.UnifiedJedis;
  import redis.clients.jedis.args.ListDirection;
  import java.util.List;
  
  
  public class ListExample {
  
      public void run() {
          UnifiedJedis jedis = new UnifiedJedis("redis://localhost:6379");
  
  
          long res1 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res1);  // >>> 1
  
          long res2 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res2);  // >>> 2
  
          String res3 = jedis.rpop("bikes:repairs");
          System.out.println(res3);  // >>> bike:1
  
          String res4 = jedis.rpop("bikes:repairs");
          System.out.println(res4); // >>> bike:2
  
  
          long res5 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res5);  // >>> 1
  
          long res6 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res6);  // >>> 2
  
          String res7 = jedis.lpop("bikes:repairs");
          System.out.println(res7);  // >>> bike:2
  
          String res8 = jedis.lpop("bikes:repairs");
          System.out.println(res8);  // >>> bike:1
  
  
          long res9 = jedis.llen("bikes:repairs");
          System.out.println(res9);  // >>> 0
  
  
          long res10 = jedis.lpush("bikes:repairs", "bike:1");
          System.out.println(res10);  // >>> 1
  
          long res11 = jedis.lpush("bikes:repairs", "bike:2");
          System.out.println(res11);  // >>> 2
  
          String res12 = jedis.lmove("bikes:repairs", "bikes:finished", ListDirection.LEFT, ListDirection.LEFT);
          System.out.println(res12);  // >>> bike:2
  
          List<String> res13 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res13);  // >>> [bike:1]
  
          List<String> res14 = jedis.lrange("bikes:finished", 0, -1);
          System.out.println(res14);  // >>> [bike:2]
  
  
          jedis.del("bikes:repairs");
  
          long res15 = jedis.rpush("bikes:repairs", "bike:1");
          System.out.println(res15);  // >>> 1
  
          long res16 = jedis.rpush("bikes:repairs", "bike:2");
          System.out.println(res16);  // >>> 2
  
          long res17 = jedis.lpush("bikes:repairs", "bike:important_bike");
          System.out.println(res17);  // >>> 3
  
          List<String> res18 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res18);  // >>> [bike:important_bike, bike:1, bike:2]
  
  
          jedis.del("bikes:repairs");
          
          long res19 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res19);  // >>> 3
  
          long res20 = jedis.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike");
          System.out.println(res20);  // >>> 5
  
          List<String> res21 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res21);  // >>> [bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3]
  
  
          jedis.del("bikes:repairs");
  
          long res22 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res22);  // >>> 3
  
          String res23 = jedis.rpop("bikes:repairs");
          System.out.println(res23);  // >>> bike:3
  
          String res24 = jedis.lpop("bikes:repairs");
          System.out.println(res24);  // >>> bike:1
  
          String res25 = jedis.rpop("bikes:repairs");
          System.out.println(res25);  // >>> bike:2
  
          String res26 = jedis.rpop("bikes:repairs");
          System.out.println(res26);  // >>> null
  
  
          long res27 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res27);  // >>> 5
  
          String res28 = jedis.ltrim("bikes:repairs", 0, 2);
          System.out.println(res28);  // >>> OK
  
          List<String> res29 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res29);  // >>> [bike:1, bike:2, bike:3]
  
  
          jedis.del("bikes:repairs");
          
          res27 = jedis.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res27);  // >>> 5
  
          res28 = jedis.ltrim("bikes:repairs", -3, -1);
          System.out.println(res2);  // >>> OK
  
          res29 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res29);  // >>> [bike:3, bike:4, bike:5]
  
  
          jedis.del("bikes:repairs");
  
          long res31 = jedis.rpush("bikes:repairs", "bike:1", "bike:2");
          System.out.println(res31);  // >>> 2
  
          List<String> res32 = jedis.brpop(1, "bikes:repairs");
          System.out.println(res32);  // >>> (bikes:repairs, bike:2)
  
          List<String>  res33 = jedis.brpop(1,"bikes:repairs");
          System.out.println(res33);  // >>> (bikes:repairs, bike:1)
  
          List<String>  res34 = jedis.brpop(1,"bikes:repairs");
          System.out.println(res34);  // >>> null
  
  
          jedis.del("new_bikes");
  
          long res36 = jedis.lpush("new_bikes", "bike:1", "bike:2", "bike:3");
          System.out.println(res36);  // >>> 3
  
  
          jedis.del("new_bikes");
          
          String res37 = jedis.set("new_bikes", "bike:1");
          System.out.println(res37);  // >>> OK
  
          String res38 = jedis.type("new_bikes");
          System.out.println(res38);  // >>> string
  
          try {
              long res39  = jedis.lpush("new_bikes", "bike:2", "bike:3");
          } catch (Exception e) {
              e.printStackTrace();
              // >>> redis.clients.jedis.exceptions.JedisDataException:
              // >>> WRONGTYPE Operation against a key holding the wrong kind of value
          }
  
  
          jedis.del("bikes:repairs");
  
          jedis.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3");
          System.out.println(res36);  // >>> 3
  
          boolean res40 = jedis.exists("bikes:repairs");
          System.out.println(res40);  // >>> true
  
          String res41 = jedis.lpop("bikes:repairs");
          System.out.println(res41);  // >>> bike:3
  
          String res42 = jedis.lpop("bikes:repairs");
          System.out.println(res42);  // >>> bike:2
  
          String res43 = jedis.lpop("bikes:repairs");
          System.out.println(res43);  // >>> bike:1
  
          boolean res44 = jedis.exists("bikes:repairs");
          System.out.println(res44);  // >>> false
  
  
          jedis.del("bikes:repairs");
  
          long res46 = jedis.llen("bikes:repairs");
          System.out.println(res46);  // >>> 0
  
          String res47 = jedis.lpop("bikes:repairs");
          System.out.println(res47);  // >>> null
  
  
          jedis.del("bikes:repairs");
  
          long res48 = jedis.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5");
          System.out.println(res48);  // >>> 5
  
          String res49 = jedis.ltrim("bikes:repairs", 0, 2);
          System.out.println(res49);  // >>> OK
  
          List<String> res50 = jedis.lrange("bikes:repairs", 0, -1);
          System.out.println(res50);  // >>> [bike:5, bike:4, bike:3]
  
  
          jedis.close();
      }
  }
  

  ▼ Commands: DEL, RPUSH, LTRIM, LRANGE

  • DEL ( @keyspace , @write , @slow )

    Deletes one or more keys.

    ▶ Methods

    • del(
      • keys: byte[]...
      ) → long // An integer greater than 0 if one or more keys were removed, 0 if none of the specified keys existed
    • del(
      • key: byte[]
      ) → long // An integer greater than 0 if one or more keys were removed, 0 if none of the specified keys existed
    • del(
      • keys: String...
      ) → long // An integer greater than 0 if one or more keys were removed, 0 if none of the specified keys existed
    • del(
      • key: String
      ) → long // An integer greater than 0 if one or more keys were removed, 0 if none of the specified keys existed
  • RPUSH ( @write , @list , @fast )

    Appends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Methods

    • rpush(
      • key: byte[],
      • strings: byte[]... // data to push
      ) → long // The number of elements inside the list after the push operation
    • rpush(
      • key: String,
      • strings: String... // data to push
      ) → long // The number of elements inside the list after the push operation
    • rpush(
      • key: String,
      • strings: String... // data to push
      ) → long // The number of elements inside the list after the push operation
  • LTRIM ( @write , @list , @slow )

    Removes elements from both ends a list. Deletes the list if all elements were trimmed.

    ▶ Methods

    • ltrim(
      • key: byte[],
      • start: long,
      • stop: long
      ) → String // OK
    • ltrim(
      • key: String,
      • start: long,
      • stop: long
      ) → String // OK
    • ltrim(
      • key: String,
      • start: long,
      • stop: long
      ) → String // OK
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Methods

    • lrange(
      • key: String,
      • start: long,
      • stop: long
      ) → List<String> // A list of elements in the specified range
    • lrange(
      • key: String,
      • start: long,
      • stop: long
      ) → List<String> // A list of elements in the specified range

  Java-Sync Quick-Start

  package io.redis.examples.async;
  
  import io.lettuce.core.*;
  import io.lettuce.core.api.async.RedisAsyncCommands;
  import io.lettuce.core.api.StatefulRedisConnection;
  
  import java.util.concurrent.CompletableFuture;
  
  public class ListExample {
  
      public void run() {
          RedisClient redisClient = RedisClient.create("redis://localhost:6379");
  
          try (StatefulRedisConnection<String, String> connection = redisClient.connect()) {
              RedisAsyncCommands<String, String> asyncCommands = connection.async();
  
              CompletableFuture<Void> queue = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res1 -> {
                  System.out.println(res1); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res2 -> {
                  System.out.println(res2); // >>> 2
  
                  return asyncCommands.rpop("bikes:repairs");
              }).thenCompose(res3 -> {
                  System.out.println(res3); // >>> bike:1
  
                  return asyncCommands.rpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> bike:2
                      .toCompletableFuture();
              queue.join();
  
              CompletableFuture<Void> stack = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res4 -> {
                  System.out.println(res4); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res5 -> {
                  System.out.println(res5); // >>> 2
  
                  return asyncCommands.lpop("bikes:repairs");
              }).thenCompose(res6 -> {
                  System.out.println(res6); // >>> bike:2
  
                  return asyncCommands.lpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> bike:1
                      .toCompletableFuture();
              stack.join();
  
              CompletableFuture<Void> llen = asyncCommands.llen("bikes:repairs")
                      .thenAccept(System.out::println) // >>> 0
                      .toCompletableFuture();
              llen.join();
  
              CompletableFuture<Void> lmovelrange = asyncCommands.lpush("bikes:repairs", "bike:1").thenCompose(res7 -> {
                  System.out.println(res7); // >>> 1
  
                  return asyncCommands.lpush("bikes:repairs", "bike:2");
              }).thenCompose(res8 -> {
                  System.out.println(res8); // >>> 2
  
                  return asyncCommands.lmove("bikes:repairs", "bikes:finished", LMoveArgs.Builder.leftLeft());
              }).thenCompose(res9 -> {
                  System.out.println(res9); // >>> bike:2
  
                  return asyncCommands.lrange("bikes:repairs", 0, -1);
              }).thenCompose(res10 -> {
                  System.out.println(res10); // >>> [bike:1]
  
                  return asyncCommands.lrange("bikes:finished", 0, -1);
              })
                      .thenAccept(System.out::println) // >>> [bike:2]
                      .toCompletableFuture();
              lmovelrange.join();
  
  
              CompletableFuture<Void> lpushrpush = asyncCommands.rpush("bikes:repairs", "bike:1").thenCompose(res11 -> {
                  System.out.println(res11); // >>> 1
  
                  return asyncCommands.rpush("bikes:repairs", "bike:2");
              }).thenCompose(res12 -> {
                  System.out.println(res12); // >>> 2
  
                  return asyncCommands.lpush("bikes:repairs", "bike:important_bike");
              }).thenCompose(res13 -> {
                  System.out.println(res13); // >>> 3
  
                  return asyncCommands.lrange("bikes:repairs", 0, -1);
              })
                      .thenAccept(System.out::println)
                      // >>> [bike:important_bike, bike:1, bike:2]
                      .toCompletableFuture();
              lpushrpush.join();
  
  
              CompletableFuture<Void> variadic = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res14 -> {
                          System.out.println(res14); // >>> 3
  
                          return asyncCommands.lpush("bikes:repairs", "bike:important_bike", "bike:very_important_bike");
                      }).thenCompose(res15 -> {
                          System.out.println(res15); // >>> 5
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3]
                      .toCompletableFuture();
              variadic.join();
  
  
              CompletableFuture<Void> lpoprpop = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res16 -> {
                          System.out.println(res16); // >>> 3
  
                          return asyncCommands.rpop("bikes:repairs");
                      }).thenCompose(res17 -> {
                          System.out.println(res17); // >>> bike:3
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res18 -> {
                          System.out.println(res18); // >>> bike:1
  
                          return asyncCommands.rpop("bikes:repairs");
                      }).thenCompose(res19 -> {
                          System.out.println(res19); // >>> bike:2
  
                          return asyncCommands.rpop("bikes:repairs");
                      })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              lpoprpop.join();
  
              CompletableFuture<Void> ltrim = asyncCommands
                      .lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res20 -> {
                          System.out.println(res20); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", 0, 2);
                      }).thenCompose(res21 -> {
                          System.out.println(res21); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:5, bike:4, bike:3]
                      .toCompletableFuture();
              ltrim.join();
  
  
              CompletableFuture<Void> ltrimendoflist = asyncCommands
                      .rpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res22 -> {
                          System.out.println(res22); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", -3, -1);
                      }).thenCompose(res23 -> {
                          System.out.println(res23); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println)
                      // >>> [bike:3, bike:4, bike:5]
                      .toCompletableFuture();
              ltrimendoflist.join();
  
  
              CompletableFuture<Void> brpop = asyncCommands.rpush("bikes:repairs", "bike:1", "bike:2").thenCompose(res24 -> {
                  System.out.println(res24); // >>> 2
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              }).thenCompose(res25 -> {
                  System.out.println(res25);
                  // >>> KeyValue[bikes:repairs, bike:2]
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              }).thenCompose(res26 -> {
                  System.out.println(res26);
                  // >>> KeyValue[bikes:repairs, bike:1]
  
                  return asyncCommands.brpop(1, "bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              brpop.join();
  
              CompletableFuture<Void> rule1 = asyncCommands.del("new_bikes").thenCompose(res27 -> {
                  System.out.println(res27); // >>> 0
  
                  return asyncCommands.lpush("new_bikes", "bike:1", "bike:2", "bike:3");
              })
                      .thenAccept(System.out::println) // >>> 3
                      .toCompletableFuture();
              rule1.join();
  
              CompletableFuture<Void> rule11 = asyncCommands.set("new_bikes_string", "bike:1").thenCompose(res28 -> {
                  System.out.println(res28); // >>> OK
  
                  return asyncCommands.type("new_bikes_string");
              }).thenCompose(res29 -> {
                  System.out.println(res29); // >>> string
  
                  return asyncCommands.lpush("new_bikes_string", "bike:2", "bike:3");
              }).handle((res, ex) -> {
                  if (ex == null) {
                      return res;
                  } else {
                      System.out.println(ex);
                      // >>> java.util.concurrent.CompletionException:
                      // >>> io.lettuce.core.RedisCommandExecutionException:
                      // >>> WRONGTYPE Operation against a key holding the wrong
                      // >>> kind of value
  
                      return -1L;
                  }
              })
                      .thenAccept(System.out::println) // >>> -1
                      .toCompletableFuture();
              rule11.join();
  
  
              CompletableFuture<Void> rule2 = asyncCommands.lpush("bikes:repairs", "bike:1", "bike:2", "bike:3")
                      .thenCompose(res30 -> {
                          System.out.println(res30); // >>> 3
  
                          return asyncCommands.exists("bikes:repairs");
                      }).thenCompose(res31 -> {
                          System.out.println(res31); // >>> 1
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res32 -> {
                          System.out.println(res32); // >>> bike:3
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res33 -> {
                          System.out.println(res33); // >>> bike:2
  
                          return asyncCommands.lpop("bikes:repairs");
                      }).thenCompose(res34 -> {
                          System.out.println(res34); // >>> bike:1
  
                          return asyncCommands.exists("bikes:repairs");
                      })
                      .thenAccept(System.out::println) // >>> 0
                      .toCompletableFuture();
              rule2.join();
  
              CompletableFuture<Void> rule3 = asyncCommands.del("bikes:repairs").thenCompose(res35 -> {
                  System.out.println(res35); // >>> 0
  
                  return asyncCommands.llen("bikes:repairs");
              }).thenCompose(res36 -> {
                  System.out.println(res36); // >>> 0
  
                  return asyncCommands.lpop("bikes:repairs");
              })
                      .thenAccept(System.out::println) // >>> null
                      .toCompletableFuture();
              rule3.join();
  
              CompletableFuture<Void> ltrim1 = asyncCommands
                      .lpush("bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").thenCompose(res37 -> {
                          System.out.println(res37); // >>> 5
  
                          return asyncCommands.ltrim("bikes:repairs", 0, 2);
                      }).thenCompose(res38 -> {
                          System.out.println(res38); // >>> OK
  
                          return asyncCommands.lrange("bikes:repairs", 0, -1);
                      })
                      .thenAccept(System.out::println) // >>> [bike:5, bike:4, bike:3]
                      .toCompletableFuture();
              ltrim1.join();
          } finally {
              redisClient.shutdown();
          }
      }
  
  }
  

  ▼ Commands: DEL, RPUSH, LTRIM, LRANGE

  • DEL ( @keyspace , @write , @slow )

    Deletes one or more keys.

    ▶ Method

    • del(
      • keys: K... // the keys.
      ) → RedisFuture<Long> // Long integer-reply The number of keys that were removed.
  • RPUSH ( @write , @list , @fast )

    Appends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • rpush(
      • key: K, // the key.
      • values: V... // the value.
      ) → RedisFuture<Long> // Long integer-reply the length of the list after the push operation.
  • LTRIM ( @write , @list , @slow )

    Removes elements from both ends a list. Deletes the list if all elements were trimmed.

    ▶ Method

    • ltrim(
      • key: K, // the key.
      • start: long, // the start type: long.
      • stop: long // the stop type: long.
      ) → RedisFuture<String> // String simple-string-reply.
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Methods

    • lrange(
      • key: K, // the key.
      • start: long, // the start type: long.
      • stop: long // the stop type: long.
      ) → RedisFuture<List<V>> // Long count of elements in the specified range.
    • lrange(
      • channel: ValueStreamingChannel<V>, // the channel.
      • key: K, // the key.
      • start: long, // the start type: long.
      • stop: long // the stop type: long.
      ) → RedisFuture<Long> // Long count of elements in the specified range.

  Java-Async Quick-Start

  package example_commands_test
  
  import (
  	"context"
  	"fmt"
  
  	"github.com/redis/go-redis/v9"
  )
  
  
  func ExampleClient_queue() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res1, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res1) // >>> 1
  
  	res2, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res2) // >>> 2
  
  	res3, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res3) // >>> bike:1
  
  	res4, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res4) // >>> bike:2
  
  }
  
  func ExampleClient_stack() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res5, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res5) // >>> 1
  
  	res6, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res6) // >>> 2
  
  	res7, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res7) // >>> bike:2
  
  	res8, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res8) // >>> bike:1
  
  }
  
  func ExampleClient_llen() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res9, err := rdb.LLen(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res9) // >>> 0
  
  }
  
  func ExampleClient_lmove_lrange() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res10, err := rdb.LPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res10) // >>> 1
  
  	res11, err := rdb.LPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res11) // >>> 2
  
  	res12, err := rdb.LMove(ctx, "bikes:repairs", "bikes:finished", "LEFT", "LEFT").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res12) // >>> bike:2
  
  	res13, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res13) // >>> [bike:1]
  
  	res14, err := rdb.LRange(ctx, "bikes:finished", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res14) // >>> [bike:2]
  
  }
  
  func ExampleClient_lpush_rpush() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res15, err := rdb.RPush(ctx, "bikes:repairs", "bike:1").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res15) // >>> 1
  
  	res16, err := rdb.RPush(ctx, "bikes:repairs", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res16) // >>> 2
  
  	res17, err := rdb.LPush(ctx, "bikes:repairs", "bike:important_bike").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res17) // >>> 3
  
  	res18, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res18) // >>> [bike:important_bike bike:1 bike:2]
  
  }
  
  func ExampleClient_variadic() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res19, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res19) // >>> 3
  
  	res20, err := rdb.LPush(ctx, "bikes:repairs", "bike:important_bike", "bike:very_important_bike").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res20) // >>> 5
  
  	res21, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res21) // >>> [bike:very_important_bike bike:important_bike bike:1 bike:2 bike:3]
  
  }
  
  func ExampleClient_lpop_rpop() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res22, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res22) // >>> 3
  
  	res23, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res23) // >>> bike:3
  
  	res24, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res24) // >>> bike:1
  
  	res25, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res25) // >>> bike:2
  
  	res26, err := rdb.RPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res26) // >>> <empty string>
  
  
  }
  
  func ExampleClient_ltrim() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res27, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res27) // >>> 5
  
  	res28, err := rdb.LTrim(ctx, "bikes:repairs", 0, 2).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res28) // >>> OK
  
  	res29, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res29) // >>> [bike:1 bike:2 bike:3]
  
  }
  
  func ExampleClient_ltrim_end_of_list() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res30, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res30) // >>> 5
  
  	res31, err := rdb.LTrim(ctx, "bikes:repairs", -3, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res31) // >>> OK
  
  	res32, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res32) // >>> [bike:3 bike:4 bike:5]
  
  }
  
  func ExampleClient_brpop() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res33, err := rdb.RPush(ctx, "bikes:repairs", "bike:1", "bike:2").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res33) // >>> 2
  
  	res34, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res34) // >>> [bikes:repairs bike:2]
  
  	res35, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res35) // >>> [bikes:repairs bike:1]
  
  	res36, err := rdb.BRPop(ctx, 1, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res36) // >>> []
  
  }
  
  func ExampleClient_rule1() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  
  	res37, err := rdb.Del(ctx, "new_bikes").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res37) // >>> 0
  
  	res38, err := rdb.LPush(ctx, "new_bikes", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res38) // >>> 3
  
  }
  
  func ExampleClient_rule11() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "new_bikes")
  
  	res39, err := rdb.Set(ctx, "new_bikes", "bike:1", 0).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res39) // >>> OK
  
  	res40, err := rdb.Type(ctx, "new_bikes").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res40) // >>> string
  
  	res41, err := rdb.LPush(ctx, "new_bikes", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		fmt.Println(err)
  		// >>> WRONGTYPE Operation against a key holding the wrong kind of value
  	}
  
  	fmt.Println(res41)
  
  }
  
  func ExampleClient_rule2() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  	res42, err := rdb.LPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res42) // >>> 3
  
  	res43, err := rdb.Exists(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res43) // >>> 1
  
  	res44, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res44) // >>> bike:3
  
  	res45, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res45) // >>> bike:2
  
  	res46, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res46) // >>> bike:1
  
  	res47, err := rdb.Exists(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res47) // >>> 0
  
  }
  
  func ExampleClient_rule3() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res48, err := rdb.Del(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res48) // >>> 0
  
  	res49, err := rdb.LLen(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res49) // >>> 0
  
  	res50, err := rdb.LPop(ctx, "bikes:repairs").Result()
  
  	if err != nil {
  		fmt.Println(err) // >>> redis: nil
  	}
  
  	fmt.Println(res50) // >>> <empty string>
  
  }
  
  func ExampleClient_ltrim1() {
  	ctx := context.Background()
  
  	rdb := redis.NewClient(&redis.Options{
  		Addr:     "localhost:6379",
  		Password: "", // no password docs
  		DB:       0,  // use default DB
  	})
  
  	rdb.Del(ctx, "bikes:repairs")
  
  	res51, err := rdb.LPush(ctx, "bikes:repairs", "bike:1", "bike:2", "bike:3", "bike:4", "bike:5").Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res51) // >>> 5
  
  	res52, err := rdb.LTrim(ctx, "bikes:repairs", 0, 2).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res52) // >>> OK
  
  	res53, err := rdb.LRange(ctx, "bikes:repairs", 0, -1).Result()
  
  	if err != nil {
  		panic(err)
  	}
  
  	fmt.Println(res53) // >>> [bike:5 bike:4 bike:3]
  
  }
  

  ▼ Commands: DEL, RPUSH, LTRIM, LRANGE

  • DEL ( @keyspace , @write , @slow )

    Deletes one or more keys.

    ▶ Method

    • Del(
      • ctx: context.Context,
      • keys: ...string
      ) → *IntCmd
  • RPUSH ( @write , @list , @fast )

    Appends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • RPush(
      • ctx: context.Context,
      • key: string,
      • values: ...interface{}
      ) → *IntCmd
  • LTRIM ( @write , @list , @slow )

    Removes elements from both ends a list. Deletes the list if all elements were trimmed.

    ▶ Method

    • LTrim(
      • ctx: context.Context,
      • key: string,
      • start: Any,
      • stop: int64
      ) → *StatusCmd
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Method

    • LRange(
      • ctx: context.Context,
      • key: string,
      • start: Any,
      • stop: int64
      ) → *StringSliceCmd

  Go Quick-Start

  using NRedisStack;
  using StackExchange.Redis;
  
  public class ListExample
  {
      public void Run()
      {
          var muxer = ConnectionMultiplexer.Connect("localhost:6379");
          var db = muxer.GetDatabase();
  
  
          long res1 = db.ListLeftPush("bikes:repairs", "bike:1");
          Console.WriteLine(res1);    // >>> 1
  
          long res2 = db.ListLeftPush("bikes:repairs", "bike:2");
          Console.WriteLine(res2);    // >>> 2
  
          RedisValue res3 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res3);    // >>> "bike:1"
  
          RedisValue res4 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res4); // >>> "bike:2"
  
  
          long res5 = db.ListLeftPush("bikes:repairs", "bike:1");
          Console.WriteLine(res5);    // >>> 1
  
          long res6 = db.ListLeftPush("bikes:repairs", "bike:2");
          Console.WriteLine(res6);    // >>> 2
  
          RedisValue res7 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res7);    // >>> "bike:2"
  
          RedisValue res8 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res8);    // >>> "bike:1"
  
  
  
          long res9 = db.ListLength("bikes:repairs");
          Console.WriteLine(res9);    // >>> 0
  
  
  
          long res10 = db.ListLeftPush("{bikes}:repairs", "bike:1");
          Console.WriteLine(res10);   // >>> 1
  
          long res11 = db.ListLeftPush("{bikes}:repairs", "bike:2");
          Console.WriteLine(res11);   // >>> 2
  
          RedisValue res12 = db.ListMove("{bikes}:repairs", "{bikes}:finished", ListSide.Left, ListSide.Left);
          Console.Write(res12);   // >>> "bike:2"
  
          RedisValue[] res13 = db.ListRange("{bikes}:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res13));    // >>> "bike:1"
  
          RedisValue[] res14 = db.ListRange("{bikes}:finished", 0, -1);
          Console.WriteLine(string.Join(", ", res14));    // >>> "bike:2"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res15 = db.ListRightPush("bikes:repairs", "bike:1");
          Console.WriteLine(res15);   // >>> 1
  
          long res16 = db.ListRightPush("bikes:repairs", "bike:2");
          Console.WriteLine(res16);   // >>> 2
  
          long res17 = db.ListLeftPush("bikes:repairs", "bike:important_bike");
          Console.WriteLine(res17);   // >>> 3
  
          RedisValue[] res18 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res18));    // >>> "bike:important_bike, bike:1, bike:2"
  
  
          db.KeyDelete("bikes:repairs");
          
          long res19 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res19);   // >>> 3
  
          long res20 = db.ListLeftPush("bikes:repairs", ["bike:important_bike", "bike:very_important_bike"]);
          Console.WriteLine(res20);   // >>> 5
  
          RedisValue[] res21 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res21));
          // >>> "bike:very_important_bike, bike:important_bike, bike:1, bike:2, bike:3"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res22 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res22);   // >>> 3
  
          RedisValue res23 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res23);   // >>> "bike:3"
  
          RedisValue res24 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res24);   // >>> "bike:1"
  
          RedisValue res25 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res25);   // >>> "bike:2"
  
          RedisValue res26 = db.ListRightPop("bikes:repairs");
          Console.WriteLine(res26);   // >>> <Empty string>
  
  
          long res27 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res27);   // >>> 5
  
          db.ListTrim("bikes:repairs", 0, 2);
          RedisValue[] res28 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res28));    // "bike:5, bike:4, bike:3"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res29 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res29);   // >>> 5
  
          db.ListTrim("bikes:repairs", -3, -1);
          RedisValue[] res30 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res30));    // >>> "bike:3, bike:4, bike:5"
  
  
          db.KeyDelete("bikes:repairs");
  
          long res31 = db.ListRightPush("bikes:repairs", ["bike:1", "bike:2"]);
          Console.WriteLine(res31);   // >>> 2
  
          Tuple<RedisKey, RedisValue>? res32 = db.BRPop(["bikes:repairs"], 1);
  
          if (res32 != null)
              Console.WriteLine($"{res32.Item1} -> {res32.Item2}"); // >>> "bikes:repairs -> bike:2"
  
          Tuple<RedisKey, RedisValue>? res33 = db.BRPop(["bikes:repairs"], 1);
  
          if (res33 != null)
              Console.WriteLine($"{res33.Item1} -> {res33.Item2}"); // >>> "bikes:repairs -> bike:1"
  
          Tuple<RedisKey, RedisValue>? res34 = db.BRPop(["bikes:repairs"], 1);
          Console.WriteLine(res34);   // >>> "Null"
  
  
          db.KeyDelete("new_bikes");
  
          long res36 = db.ListRightPush("new_bikes", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res36);   // >>> 3
  
  
          db.KeyDelete("new_bikes");
          
          bool res37 = db.StringSet("new_bikes", "bike:1");
          Console.WriteLine(res37);   // >>> True
  
          RedisType res38 = db.KeyType("new_bikes");
          Console.WriteLine(res38);   // >>> RedisType.String
  
          try
          {
              long res39 = db.ListRightPush("new_bikes", ["bike:2", "bike:3"]);
          }
          catch (Exception e)
          {
              Console.WriteLine(e);
          }
  
  
          db.KeyDelete("bikes:repairs");
  
          long res40 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3"]);
          Console.WriteLine(res40);   // >>> 3
  
          bool res41 = db.KeyExists("bikes:repairs");
          Console.WriteLine(res41);   // >>> True
  
          RedisValue res42 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res42);   // >>> "bike:3"
  
          RedisValue res43 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res43);   // >>> "bike:2"
  
          RedisValue res44 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res44);   //  >>> "bike:1"
  
          bool res45 = db.KeyExists("bikes:repairs");
          Console.WriteLine(res45);   // >>> False
  
  
          db.KeyDelete("bikes:repairs");
  
          long res47 = db.ListLength("bikes:repairs");
          Console.WriteLine(res47);   // >>> 0
  
          RedisValue res48 = db.ListLeftPop("bikes:repairs");
          Console.WriteLine(res48);   // >>> Null
  
  
          db.KeyDelete("bikes:repairs");
  
          long res49 = db.ListLeftPush("bikes:repairs", ["bike:1", "bike:2", "bike:3", "bike:4", "bike:5"]);
          Console.WriteLine(res49);   // >>> 5
  
          db.ListTrim("bikes:repairs", 0, 2);
          RedisValue[] res50 = db.ListRange("bikes:repairs", 0, -1);
          Console.WriteLine(string.Join(", ", res50));    // >>> "bike:5, bike:4, bike:3"
  
  
      }
  }
  

  ▼ Commands: DEL, RPUSH, LTRIM, LRANGE

  • DEL ( @keyspace , @write , @slow )

    Deletes one or more keys.

    ▶ Methods

    • KeyDelete(
      • key: RedisKey,
      • flags: CommandFlags // The flags to use for this operation.
      ) → bool // The number of keys that were removed.
    • KeyDelete(
      • keys: RedisKey[], // The keys to delete.
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The number of keys that were removed.
  • RPUSH ( @write , @list , @fast )

    Appends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Methods

    • ListRightPush(
      • key: RedisKey, // The key of the list.
      • value: RedisValue,
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operation.
    • ListRightPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the tail of the list.
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operation.
    • ListRightPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the tail of the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operation.
    • ListRightPush(
      • key: RedisKey, // The key of the list.
      • value: RedisValue,
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operation.
    • ListRightPush(
      • key: RedisKey, // The key of the list.
      • values: RedisValue[], // The values to add to the tail of the list.
      • when: When,
      • flags: CommandFlags // The flags to use for this operation.
      ) → long // The length of the list after the push operation.
  • LTRIM ( @write , @list , @slow )

    Removes elements from both ends a list. Deletes the list if all elements were trimmed.

    ▶ Methods

    • ListTrim(
      • key: RedisKey, // The key of the list.
      • start: long, // The start index of the list to trim to.
      • stop: long, // The end index of the list to trim to.
      • flags: CommandFlags // The flags to use for this operation.
      ) → void
    • ListTrim(
      • key: RedisKey, // The key of the list.
      • start: long, // The start index of the list to trim to.
      • stop: long, // The end index of the list to trim to.
      • flags: CommandFlags // The flags to use for this operation.
      ) → void
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Methods

    • ListRange(
      • key: RedisKey, // The key of the list.
      • start: long, // The start index of the list.
      • stop: long, // The stop index of the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue[] // List of elements in the specified range.
    • ListRange(
      • key: RedisKey, // The key of the list.
      • start: long, // The start index of the list.
      • stop: long, // The stop index of the list.
      • flags: CommandFlags // The flags to use for this operation.
      ) → RedisValue[] // List of elements in the specified range.

  C#-Sync Quick-Start

  <?php
  
  require 'vendor/autoload.php';
  
  use Predis\Client as PredisClient;
  
  class DtListTest
  {
      public function testDtList() {
          $r = new PredisClient([
              'scheme'   => 'tcp',
              'host'     => '127.0.0.1',
              'port'     => 6379,
              'password' => '',
              'database' => 0,
          ]);
  
          $res1 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res1 . PHP_EOL;
          // >>> 1
  
          $res2 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res2 . PHP_EOL;
          // >>> 2
  
          $res3 = $r->rpop('bikes:repairs');
          echo $res3 . PHP_EOL;
          // >>> bike:1
  
          $res4 = $r->rpop('bikes:repairs');
          echo $res4 . PHP_EOL;
          // >>> bike:2
  
          $res5 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res5 . PHP_EOL;
          // >>> 1
  
          $res6 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res6 . PHP_EOL;
          // >>> 2
  
          $res7 = $r->lpop('bikes:repairs');
          echo $res7 . PHP_EOL;
          // >>> bike:2
  
          $res8 = $r->lpop('bikes:repairs');
          echo $res8 . PHP_EOL;
          // >>> bike:1
  
          $res9 = $r->llen('bikes:repairs');
          echo $res9 . PHP_EOL;
          // >>> 0
  
          $res10 = $r->lpush('bikes:repairs', 'bike:1');
          echo $res10 . PHP_EOL;
          // >>> 1
  
          $res11 = $r->lpush('bikes:repairs', 'bike:2');
          echo $res11 . PHP_EOL;
          // >>> 2
  
          $res12 = $r->lmove('bikes:repairs', 'bikes:finished', 'LEFT', 'LEFT');
          echo $res12 . PHP_EOL;
          // >>> 'bike:2'
  
          $res13 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res13) . PHP_EOL;
          // >>> ['bike:1']
  
          $res14 = $r->lrange('bikes:finished', 0, -1);
          echo json_encode($res14) . PHP_EOL;
          // >>> ['bike:2']
  
          $r->del('bikes:repairs');
          
          $res15 = $r->rpush('bikes:repairs', 'bike:1');
          echo $res15 . PHP_EOL;
          // >>> 1
  
          $res16 = $r->rpush('bikes:repairs', 'bike:2');
          echo $res16 . PHP_EOL;
          // >>> 2
  
          $res17 = $r->lpush('bikes:repairs', 'bike:important_bike');
          echo $res17 . PHP_EOL;
          // >>> 3
  
          $res18 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res18) . PHP_EOL;
          // >>> ['bike:important_bike', 'bike:1', 'bike:2']
  
          $r->del('bikes:repairs');
  
          $res19 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res19 . PHP_EOL;
          // >>> 3
  
          $res20 = $r->lpush('bikes:repairs', 'bike:important_bike', 'bike:very_important_bike');
          echo $res20 . PHP_EOL;
          // >>> 5
  
          $res21 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res21) . PHP_EOL;
          // >>> ['bike:very_important_bike', 'bike:important_bike', 'bike:1', ...
  
          $r->del('bikes:repairs');
          
          $res22 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res22 . PHP_EOL;
          // >>> 3
  
          $res23 = $r->rpop('bikes:repairs');
          echo $res23 . PHP_EOL;
          // >>> 'bike:3'
  
          $res24 = $r->lpop('bikes:repairs');
          echo $res24 . PHP_EOL;
          // >>> 'bike:1'
  
          $res25 = $r->rpop('bikes:repairs');
          echo $res25 . PHP_EOL;
          // >>> 'bike:2'
  
          $res26 = $r->rpop('bikes:repairs');
          echo $res26 . PHP_EOL;
          // >>> None
  
          $res27 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res27 . PHP_EOL;
          // >>> 5
  
          $res28 = $r->ltrim('bikes:repairs', 0, 2);
          echo $res28 . PHP_EOL;
          // >>> True
  
          $res29 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res29) . PHP_EOL;
          // >>> ['bike:1', 'bike:2', 'bike:3']
  
          $r->del('bikes:repairs');
  
          $res27 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res27 . PHP_EOL;
          // >>> 5
  
          $res28 = $r->ltrim('bikes:repairs', -3, -1);
          echo $res28 . PHP_EOL;
          // >>> True
  
          $res29 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res29) . PHP_EOL;
          // >>> ['bike:3', 'bike:4', 'bike:5']
  
          $r->del('bikes:repairs');
  
          $res31 = $r->rpush('bikes:repairs', 'bike:1', 'bike:2');
          echo $res31 . PHP_EOL;
          // >>> 2
  
          $res32 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res32) . PHP_EOL;
          // >>> ['bikes:repairs', 'bike:2']
  
          $res33 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res33) . PHP_EOL;
          // >>> ['bikes:repairs', 'bike:1']
  
          $res34 = $r->brpop('bikes:repairs', 1);
          echo json_encode($res34) . PHP_EOL;
          // >>> None
  
          $res35 = $r->del('new_bikes');
          echo $res35 . PHP_EOL;
          // >>> 0
  
          $res36 = $r->lpush('new_bikes', 'bike:1', 'bike:2', 'bike:3');
          echo $res36 . PHP_EOL;
          // >>> 3
  
          $r->del('new_bikes');
  
          $res37 = $r->set('new_bikes', 'bike:1');
          echo $res37 . PHP_EOL;
          // >>> True
  
          $res38 = $r->type('new_bikes');
          echo $res38 . PHP_EOL;
          // >>> 'string'
  
          try {
              $res39 = $r->lpush('new_bikes', 'bike:2', 'bike:3');
              // >>> redis.exceptions.ResponseError:
              // >>> WRONGTYPE Operation against a key holding the wrong kind of value
          } catch (\Predis\Response\ServerException $e) {
              echo $e->getMessage() . PHP_EOL;
          }
  
          $r->del('bikes:repairs');
          $res36 = $r->lpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3');
          echo $res36 . PHP_EOL;
          // >>> 3
  
          $res40 = $r->exists('bikes:repairs');
          echo $res40 . PHP_EOL;
          // >>> 1
  
          $res41 = $r->lpop('bikes:repairs');
          echo $res41 . PHP_EOL;
          // >>> 'bike:3'
  
          $res42 = $r->lpop('bikes:repairs');
          echo $res42 . PHP_EOL;
          // >>> 'bike:2'
  
          $res43 = $r->lpop('bikes:repairs');
          echo $res43 . PHP_EOL;
          // >>> 'bike:1'
  
          $res44 = $r->exists('bikes:repairs');
          echo $res44 . PHP_EOL;
          // >>> False
  
          $res45 = $r->del('bikes:repairs');
          echo $res45 . PHP_EOL;
          // >>> 0
  
          $res46 = $r->llen('bikes:repairs');
          echo $res46 . PHP_EOL;
          // >>> 0
  
          $res47 = $r->lpop('bikes:repairs');
          echo $res47 . PHP_EOL;
          // >>> None
  
          $res48 = $r->lpush('bikes:repairs', 'bike:1', 'bike:2', 'bike:3', 'bike:4', 'bike:5');
          echo $res48 . PHP_EOL;
          // >>> 5
  
          $res49 = $r->ltrim('bikes:repairs', 0, 2);
          echo $res49 . PHP_EOL;
          // >>> True
  
          $res50 = $r->lrange('bikes:repairs', 0, -1);
          echo json_encode($res50) . PHP_EOL;
          // >>> ['bike:5', 'bike:4', 'bike:3']
      }
  }
  
  

  ▼ Commands: DEL, RPUSH, LTRIM, LRANGE

  • DEL ( @keyspace , @write , @slow )

    Deletes one or more keys.

    ▶ Method

    • del(
      • $keyOrKeys: string[]|string,
      • $keys: string ...
      ) → int
  • RPUSH ( @write , @list , @fast )

    Appends one or more elements to a list. Creates the key if it doesn't exist.

    ▶ Method

    • rpush(
      • $key: string,
      • $values: array
      ) → int
  • LTRIM ( @write , @list , @slow )

    Removes elements from both ends a list. Deletes the list if all elements were trimmed.

    ▶ Method

    • ltrim(
      • $key: string,
      • $start: int,
      • $stop: int
      ) → mixed
  • LRANGE ( @read , @list , @slow )

    Returns a range of elements from a list.

    ▶ Method

    • lrange(
      • $key: string,
      • $start: int,
      • $stop: int
      ) → string[]

  PHP Quick-Start