malachite-base 0.13.0

A collection of utilities, including new arithmetic traits and iterators that generate all values of a type.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

// Copyright © 2026 Mikhail Hogrefe
//
// This file is part of Malachite.
//
// Malachite is free software: you can redistribute it and/or modify it under the terms of the GNU
// Lesser General Public License (LGPL) as published by the Free Software Foundation; either version
// 3 of the License, or (at your option) any later version. See <https://www.gnu.org/licenses/>.

use crate::strings::typst::ToTypst;
use core::fmt::{Formatter, Result};

impl<T: ToTypst> ToTypst for Option<T> {
    /// Writes an [`Option`] as a Typst math-mode fragment.
    ///
    /// [`None`] becomes `bot`, and [`Some`] wraps its value in square brackets. The brackets are
    /// not decoration: without them `Some(None)` and [`None`] would both be `bot`, and distinct
    /// values would have the same fragment.
    ///
    /// Typst grows a matched pair of delimiters to fit what is between them, so the brackets fit a
    /// value that is taller than one line, such as a fraction or a nested [`Option`], without being
    /// asked to.
    ///
    /// # Worst-case complexity
    /// Same as the time and additional memory complexity of `fmt_typst` for `T`.
    ///
    /// # Examples
    /// ```
    /// use malachite_base::strings::typst::ToTypst;
    ///
    /// assert_eq!(None::<u8>.to_typst_string(), "bot");
    /// assert_eq!(Some(5u8).to_typst_string(), "[5]");
    /// assert_eq!(Some("hi").to_typst_string(), r#"["hi"]"#);
    ///
    /// // The brackets keep nested `Option`s apart.
    /// assert_eq!(Some(None::<u8>).to_typst_string(), "[bot]");
    /// assert_eq!(Some(Some(5u8)).to_typst_string(), "[[5]]");
    /// ```
    ///
    /// | value              | fragment  |
    /// |--------------------|-----------|
    /// | `None::<u8>`       | `bot`     |
    /// | `Some(5u8)`        | `[5]`     |
    /// | `Some("hi")`       | `["hi"]`  |
    /// | `Some(None::<u8>)` | `[bot]`   |
    /// | `Some(Some(5u8))`  | `[[5]]`   |
    #[inline]
    fn fmt_typst(&self, f: &mut Formatter) -> Result {
        match self {
            None => f.write_str("bot"),
            Some(x) => {
                f.write_str("[")?;
                x.fmt_typst(f)?;
                f.write_str("]")
            }
        }
    }
}