Struct Query 

pub struct Query { /* private fields */ }

Filter criteria for font search. Built with chained with_* methods.

Every field is optional and defaults to “no constraint.” An empty Query matches all fonts. As you add criteria, the filter becomes more selective — all criteria must be satisfied (AND logic).

The query doesn’t touch the filesystem; it only evaluates in-memory TypgFontFaceMeta structs. This makes it reusable across live search, cached search, and indexed search without modification.

Implementations

impl Query

pub fn new() -> Self

Create an empty query that matches all fonts.

pub fn with_axes(self, axes: Vec<Tag>) -> Self

Require these variation axes. A font must define all of them. Example: vec![tag4("wght")?, tag4("wdth")?]

pub fn with_features(self, features: Vec<Tag>) -> Self

Require these OpenType features. The font must list all of them. Example: vec![tag4("liga")?, tag4("smcp")?]

pub fn with_scripts(self, scripts: Vec<Tag>) -> Self

Require these script tags. The font must declare support for all. Example: vec![tag4("latn")?, tag4("cyrl")?]

pub fn with_tables(self, tables: Vec<Tag>) -> Self

Require these top-level tables. The font file must contain all. Example: vec![tag4("GSUB")?, tag4("GPOS")?]

pub fn with_name_patterns(self, patterns: Vec<Regex>) -> Self

Require at least one font name to match at least one regex pattern. Patterns are tested against all name strings (family, full, PostScript, etc.).

pub fn with_codepoints(self, cps: Vec<char>) -> Self

Require the font to have glyphs for all of these Unicode codepoints. Example: vec!['A', 'B', 'ñ']

pub fn require_variable(self, yes: bool) -> Self

When true, only variable fonts match. Default: false (both match).

pub fn with_weight_range(self, range: Option<RangeInclusive<u16>>) -> Self

Require OS/2 weight class within this range. Example: Some(300..=700).

pub fn with_width_range(self, range: Option<RangeInclusive<u16>>) -> Self

Require OS/2 width class within this range. Example: Some(3..=7).

pub fn with_family_class(self, class: Option<FamilyClassFilter>) -> Self

Require a specific OS/2 family class (and optionally subclass).

pub fn with_creator_patterns(self, patterns: Vec<Regex>) -> Self

Require at least one creator string to match at least one regex.

pub fn with_license_patterns(self, patterns: Vec<Regex>) -> Self

Require at least one license string to match at least one regex.

pub fn axes(&self) -> &[Tag]

The required axis tags, if any.

pub fn features(&self) -> &[Tag]

The required feature tags, if any.

pub fn scripts(&self) -> &[Tag]

The required script tags, if any.

pub fn tables(&self) -> &[Tag]

The required table tags, if any.

pub fn name_patterns(&self) -> &[Regex]

The name regex patterns, if any.

pub fn codepoints(&self) -> &[char]

The required codepoints, if any.

pub fn requires_variable(&self) -> bool

Whether only variable fonts are accepted.

pub fn weight_range(&self) -> Option<&RangeInclusive<u16>>

The weight class range constraint, if set.

pub fn width_range(&self) -> Option<&RangeInclusive<u16>>

The width class range constraint, if set.

pub fn family_class(&self) -> Option<&FamilyClassFilter>

The family class constraint, if set.

pub fn creator_patterns(&self) -> &[Regex]

The creator/provenance regex patterns, if any.

pub fn license_patterns(&self) -> &[Regex]

The license regex patterns, if any.

pub fn matches(&self, meta: &TypgFontFaceMeta) -> bool

Test a font’s metadata against every criterion in this query.

Returns true only if all active criteria are satisfied. Criteria that aren’t set (empty vecs, None ranges) are skipped.

Evaluation order is roughly cheapest-first: boolean checks, then tag set intersections, then numeric ranges, then codepoint coverage, then regex matching (most expensive). Short-circuits on the first failure.

Trait Implementations

impl Clone for Query

fn clone(&self) -> Query

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Query

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

Formats the value using the given formatter.

impl Default for Query

fn default() -> Query

Returns the “default value” for a type.