Struct Query 

pub struct Query { /* private fields */ }

A declarative filter over the registry.

Implementations

impl Query

pub const fn new() -> Self

An empty query, matching every entry.

pub const fn class(self, class: Class) -> Self

Restrict to one kind of cryptographic object.

pub const fn purpose(self, purpose: Purpose) -> Self

Require the entry to serve this purpose. Repeating the call requires all of them, which is how “authenticated encryption” is expressed as confidentiality and authentication.

pub const fn min_classical_bits(self, bits: u16) -> Self

Require at least this much strength against a classical adversary.

pub const fn min_quantum_bits(self, bits: u16) -> Self

Require at least this much strength against a quantum adversary.

Setting this above zero excludes every discrete-log and factoring scheme, which is exactly the filter a post-quantum migration needs.

pub const fn fips_approved_only(self) -> Self

Restrict to algorithms usable in the FIPS approved mode of operation.

pub const fn available_only(self) -> Self

Restrict to algorithms actually implemented in this build.

pub const fn family(self, family: &'static str) -> Self

Restrict to one family, e.g. "SHA-2".

pub fn matches(&self, e: &Entry) -> bool

Whether a single entry satisfies the query.

pub fn run(self) -> impl Iterator<Item = &'static Entry>

Run the query, yielding matching entries in registry order.

pub fn count(self) -> usize

The number of entries this query matches.

Trait Implementations

impl Clone for Query

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Query

impl Debug for Query

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Query

fn default() -> Self

Returns the “default value” for a type.