Skip to main content

zrx_id/id/specificity/segment/atom/
character.rs

1// Copyright (c) 2025-2026 Zensical and contributors
2
3// SPDX-License-Identifier: MIT
4// All contributions are certified under the DCO
5
6// Permission is hereby granted, free of charge, to any person obtaining a copy
7// of this software and associated documentation files (the `Software`), to
8// deal in the Software without restriction, including without limitation the
9// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
10// sell copies of the Software, and to permit persons to whom the Software is
11// furnished to do so, subject to the following conditions:
12
13// The above copyright notice and this permission notice shall be included in
14// all copies or substantial portions of the Software.
15
16// THE SOFTWARE IS PROVIDED `AS IS`, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18// FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
19// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
21// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
22// IN THE SOFTWARE.
23
24// ----------------------------------------------------------------------------
25
26//! Character class.
27
28use std::fmt::{self, Display, Write};
29
30// ----------------------------------------------------------------------------
31// Enums
32// ----------------------------------------------------------------------------
33
34/// Character class.
35///
36/// For our case, we do not need to know the exact structure of the character
37/// class, as we'll score it as a single character anyway, same as `*`. We also
38/// don't care whether it's negated or not, as that doesn't affect scoring as
39/// well. Therefore, we can just store the string slices.
40#[derive(Clone, Debug, PartialEq, Eq)]
41pub struct Character<'a> {
42    /// String slices.
43    values: Vec<&'a str>,
44}
45
46// ----------------------------------------------------------------------------
47// Trait implementations
48// ----------------------------------------------------------------------------
49
50impl<'a> FromIterator<&'a str> for Character<'a> {
51    /// Creates a character class from an iterator.
52    #[inline]
53    fn from_iter<T>(iter: T) -> Self
54    where
55        T: IntoIterator<Item = &'a str>,
56    {
57        Character {
58            values: iter.into_iter().collect(),
59        }
60    }
61}
62
63// ----------------------------------------------------------------------------
64
65impl Display for Character<'_> {
66    /// Formats the character class for display.
67    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
68        f.write_char('[')?;
69        for value in &self.values {
70            f.write_str(value)?;
71        }
72        f.write_char(']')
73    }
74}