Array and List functions link

listSet link

The listSet function clears the existing elements associated with a given list key and sets the provided values as the new list elements. It effectively replaces any previously stored data under the key with the new list.

-> Read More

      const res = await client.listSet("myList", "First element");
    console.log(res);
  

      const res = await client.listSet("myList", "First" "Second" "Third");
    console.log(res);
  

  async function main() {
  const client = fleare.createClient("127.0.0.1", 9219);
  ...
  
  try {
    await client.connect();

    const res = await client.listSet("myList", "First" "Second" "Third");
    console.log(res);

  } catch (err) {
    console.error(err);
  } finally {
    await client.close();
  }
}
  

  3
  

listIset link

The listIset function allows users to insert or replace an element at a specified index in a list stored at the provided key. This operation is index-based, and it does not extend the list—an out-of-range index returns an error.

-> Read More

  const res = await client.listIset("myKey", 0, "This is my first element");
console.log(res);
  

  const res = await client.get("myKey", 0);
console.log(res);
  

  "This is my first element"
  

listPush link

The listPush function inserts one or more elements at the beginning of a list associated with a specific key in the Fleare in-memory database. If the key does not exist, a new list is created. If the key exists but holds a non-list data type, an error is returned.

-> Read More

  const res = await client.listPush("myList", "First");
  

  const res = await client.listPush("myList", "Second", "Third");
  

  const res = await client.get("myList");
console.log(res);
  

  ["First" "Second" "Third"]
  

listPop link

The listPop function return (pops) a single element from the beginning (index 0) of a list stored at a specified key. If the list becomes empty after the pop, the key is removed from the store.

-> Read More

  const res = await client.listPop("myKey");
console.log(res);
  

  "This is my first element"
  

listGPop link

The listGPop function return (pops) a single element from the beginning (index 0) of a list stored at a specified key. If the list becomes empty after the pop, the key is removed from the store.

-> Read More

  const res = await client.listGPop("myKey");
console.log(res);
  

  "This is my first element"
  

listGet link

The listGet function retrieves one or more elements from a list stored at a specific key. If an index is provided, it returns the value at that index; otherwise, it returns the entire list.

-> Read More

  const res = await client.listGet("myKey");
console.log(res);
  

  ["This is my first element"]
  

  const res = await client.listGet("myKey", 0);
console.log(res);
  

  "This is my first element"
  

listLen link

The listLen function is used to retrieve the number of elements in a list stored at a given key. It validates the key, checks for the appropriate data type, and returns the size of the list. If the key is not associated with a list, or if the key doesn’t exist, a relevant error or response is returned.

-> Read More

  const res = await client.listLen("myKey");
console.log(res);
  

  3
  

listFind link

The listFind function filters elements from a list stored at a specified key using various comparison operators and path-based expressions. It supports FIND primitives (strings, numbers, booleans) and objects (using nested field paths).

-> Read More

  const res = await client.listPush("myList", 10, 20, 30, 40, 50, 60, 70, 80, 90, 100);
  

  const res = await client.listFind("myList", ":30");
console.log(res);
  

  [30]
  

  const res = await client.listFind("myList", ">30");
console.log(res);
  

  [40, 50, 60, 70, 80, 90, 100]