Array and List functions

listSet

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

Simple use

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

Set Multiple items

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

Full Example

  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();
  }
}

Output

  3

Simple use

    res, err := client.ListSet("myList", "First")
	if err != nil {
		fmt.Println("Error checking existence:", err)
		return
	}
	fmt.Println(res)

Set Multiple items

    res, err := client.ListSet("myList", "First", "Second", "Third")
	if err != nil {
		fmt.Println("Error checking existence:", err)
		return
	}
	fmt.Println(res)

Full Example

  func main() {
	// Create a client with options
	client := fleare.CreateClient(&fleare.Options{
		Host:     "127.0.0.1",
		Port:     9219,
		PoolSize: 1,
	})

	err := client.Connect()
	if err != nil {
		fmt.Println(err)
		return
	}

	res, err := client.ListSet("myList", "First", "Second", "Third")
	if err != nil {
		fmt.Println("Error checking existence:", err)
		return
	}
	fmt.Println(res)
}

Output

  3

listIset

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

Simple use

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

Get item

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

Output

  "This is my first element"

Simple use

  	res, err := client.ListISet("myList", 2, "This is my first element")
	if err != nil {
		fmt.Println("Error checking existence:", err)
		return
	}
	fmt.Println(res)

Get item

  res1, err := client.ListGet("myList", 2)
	fmt.Println(res1)

Output

  "This is my first element"

listPush

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

Simple use

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

Multiple items

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

Get item

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

Output

  ["First" "Second" "Third"]

Simple use

  	res, err := client.ListPush("myList", "First")
	if err != nil {
		fmt.Println("Error checking existence:", err)
		return
	}
	fmt.Println(res)

Multiple items

  	res, err := client.ListPush("myList", "First", "Second", "Third" )

Get item

  res, err := client.ListGet("myList")
fmt.Println(res)

Output

  ["First" "Second" "Third"]

listPop

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

Simple use

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

Output

  "This is my first element"

Simple use

  	res, err := client.ListPop("myList")
	if err != nil {
		fmt.Println("Error checking existence:", err)
		return
	}
	fmt.Println(res)

Output

  "This is my first element"

listGet

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

Simple use

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

Output

  ["This is my first element"]

Using index

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

Output

  "This is my first element"

Simple use

  	res, err := client.ListGet("myList")
	if err != nil {
		fmt.Println("Error checking existence:", err)
		return
	}
	fmt.Println(res)

Output

  ["This is my first element"]

Using index

  	res, err := client.ListGet("myList", 0)
	fmt.Println(res)

Output

  "This is my first element"

listLen

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

Simple use

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

Output

  3

Simple use

  	res, err := client.ListLen("myList")
	if err != nil {
		fmt.Println("Error checking existence:", err)
		return
	}
	fmt.Println(res)

Output

  3

listFind

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

Push items

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

Simple use

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

Output

  [30]

Simple use 2

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

Output

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

Set items

  client.ListSet("myList", 10, 20, 30, 40, 50, 60, 70, 80, 90, 100)

Simple use

  res, err := client.ListFind("myList", ":30")
	if err != nil {
		fmt.Println("Error checking existence:", err)
		return
	}
	fmt.Println(res)

Output

  [30]

Simple use 2

  res, err := client.ListFind("myList", ">30")
	if err != nil {
		fmt.Println("Error checking existence:", err)
		return
	}
	fmt.Println(res)

Output

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