Flushes a specific cached entry from the cache. Works with cached queries, functions, and HTTP results.
This allows selective cache invalidation instead of clearing entire caches, enabling fine-grained cache control when underlying data changes.
Lucee Function Reference
cachedwithinflush()
Example
cachedwithinflush(any cacheObject,[any arguments]):boolean
Arguments
The arguments for this function are set. You can not use other arguments except the following ones.
| Name | Type | Required | Description |
|---|---|---|---|
| cacheObject | any | Yes | The cached object to flush from cache. Must be a valid cache object such as a query result, function reference, or HTTP result struct that was cached using the `cachedwithin` attribute. |
| arguments | any | No |
The arguments used when the cache entry was created. Required for cached functions to identify the specific cache entry, as each unique set of arguments creates a separate cache entry. Can be provided as an array `[arg1, arg2]` for positional arguments or as a struct `{key: value}` for named arguments. Not required for queries or HTTP results. |