use std::fmt;
use crate::core::{LocatedKeyPage, LocatedKeys, LocatorBasis};
use crate::types::KeyOrdinal;
#[derive(Debug, Default, Clone, Copy, PartialEq, Eq, Hash)]
#[non_exhaustive]
pub enum MatchMode {
#[default]
PreferExact,
IncludeCaseVariants,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
#[non_exhaustive]
pub enum MatchBasis {
RawExact,
HeaderNormalized,
CaseVariants,
}
#[derive(Clone)]
pub struct KeyMatches {
inner: LocatedKeys,
}
pub struct KeyMatchPage {
inner: LocatedKeyPage,
}
impl KeyMatchPage {
pub(crate) fn from_located(inner: LocatedKeyPage) -> Self {
Self { inner }
}
pub const fn basis(&self) -> MatchBasis {
match self.inner.basis() {
LocatorBasis::RawExact => MatchBasis::RawExact,
LocatorBasis::HeaderNormalized => MatchBasis::HeaderNormalized,
LocatorBasis::CaseVariants => MatchBasis::CaseVariants,
}
}
pub const fn total(&self) -> usize {
self.inner.total()
}
pub fn len(&self) -> usize {
self.inner.len()
}
pub fn is_empty(&self) -> bool {
self.inner.is_empty()
}
pub fn get(&self, index: usize) -> Option<KeyOrdinal> {
self.inner.ordinal_at(index)
}
pub fn iter(&self) -> impl ExactSizeIterator<Item = KeyOrdinal> + '_ {
(0..self.len()).map(|index| {
self.inner
.ordinal_at(index)
.expect("iterator indices stay inside the key match page")
})
}
}
impl KeyMatches {
pub(crate) fn from_located(inner: LocatedKeys) -> Self {
debug_assert!(!inner.is_empty());
Self { inner }
}
pub const fn basis(&self) -> MatchBasis {
match self.inner.basis() {
LocatorBasis::RawExact => MatchBasis::RawExact,
LocatorBasis::HeaderNormalized => MatchBasis::HeaderNormalized,
LocatorBasis::CaseVariants => MatchBasis::CaseVariants,
}
}
pub fn len(&self) -> usize {
self.inner.len()
}
pub fn is_empty(&self) -> bool {
self.inner.is_empty()
}
pub fn first(&self) -> KeyOrdinal {
self.inner
.ordinal_at(0)
.expect("KeyMatches always contains at least one ordinal")
}
pub fn get(&self, index: usize) -> Option<KeyOrdinal> {
self.inner.ordinal_at(index)
}
pub fn iter(&self) -> impl ExactSizeIterator<Item = KeyOrdinal> + '_ {
(0..self.len()).map(|index| {
self.inner
.ordinal_at(index)
.expect("iterator indices stay inside the locator range")
})
}
}
impl fmt::Debug for KeyMatches {
fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
formatter
.debug_struct("KeyMatches")
.field("basis", &self.basis())
.field("ordinals", &DebugOrdinals(self))
.finish()
}
}
impl fmt::Debug for KeyMatchPage {
fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
formatter
.debug_struct("KeyMatchPage")
.field("basis", &self.basis())
.field("total", &self.total())
.field("ordinals", &DebugPageOrdinals(self))
.finish()
}
}
struct DebugOrdinals<'a>(&'a KeyMatches);
struct DebugPageOrdinals<'a>(&'a KeyMatchPage);
impl fmt::Debug for DebugOrdinals<'_> {
fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
formatter.debug_list().entries(self.0.iter()).finish()
}
}
impl fmt::Debug for DebugPageOrdinals<'_> {
fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
formatter.debug_list().entries(self.0.iter()).finish()
}
}