Cachex v3.1.3 Cachex.Query View Source

Utility module based around creation of cache queries.

Queries are essentially just some minor convenience wrappers around the internal match specification used by ETS. This module is exposed to make it easier to query a cache (via Cachex.stream/3) without having to take care of filtering for expirations by hand.

Note that there is almost no validation in here, so test thoroughly and store compile-time versions of your queries when possible (as performance is not taken into account inside this module; it can be slow to generate).

Link to this section Summary

Functions

create(condition, output \\ :"$_")

Creates an expiration-aware query

expired(output \\ :"$_")

Creates a query to retrieve all expired records

expired_clause()

Creates a match condition for expired records

raw(condition, output \\ :"$_")

Creates a raw query, ignoring expiration

unexpired(output \\ :"$_")

Creates a query to retrieve all unexpired records

unexpired_clause()

Creates a match condition for unexpired records

Link to this section Functions

create(condition, output \\ :"$_")

create(any(), any()) :: [{tuple(), [tuple()], [any()]}]

Creates an expiration-aware query.

expired(output \\ :"$_")

expired(any()) :: [{tuple(), [tuple()], [any()]}]

Creates a query to retrieve all expired records.

expired_clause()

expired_clause() :: tuple()

Creates a match condition for expired records.

raw(condition, output \\ :"$_")

raw(any(), any()) :: [{tuple(), [tuple()], [any()]}]

Creates a raw query, ignoring expiration.

unexpired(output \\ :"$_")

unexpired(any()) :: [{tuple(), [tuple()], [any()]}]

Creates a query to retrieve all unexpired records.

unexpired_clause()

unexpired_clause() :: tuple()

Creates a match condition for unexpired records.