add<T> static method

Future<bool> add<T>(
  1. String key,
  2. T value, {
  3. Duration? expiredAfter,
})

Stores a value in the cache with the specified key if the key does not exist.

If the key is already present in the cache, this method does nothing and returns false. If the key is not present, the value is stored, and it returns true.

  • Parameter key The unique identifier for the cached value.
  • Parameter value The value to be stored in the cache.
  • Parameter expiredAfter An optional duration after which the cached value should expire.
  • Returns: true if the value was successfully stored in the cache, otherwise false.
  • Throws: An error if there is an issue during the cache storage process. Usage:
var success = Cache.add<User>("user", myUser, expiredAfter: Duration(days: 1));

Implementation

static Future<bool> add<T>(String key, T value,
    {Duration? expiredAfter}) async {
  final exist = has(key);
  if (!exist) return put<T>(key, value, expiredAfter: expiredAfter);
  return false;
}