malachite-base 0.14.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

// 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 core::str::FromStr;
use malachite_base::num::arithmetic::traits::Height;
use malachite_base::num::conversion::traits::ExactFrom;
use malachite_base::num::logic::traits::SignificantBits;
use malachite_base::test_util::generators::unsigned_vector_gen;
use malachite_base::unsigned_vector::UnsignedVector;
use malachite_base::vector::Vector;

#[test]
fn test_height() {
    let test = |s, out| {
        let v = UnsignedVector::<u8>::from_str(s).unwrap();
        let height = v.to_height();
        assert_eq!(height.to_string(), out);
        assert_eq!(v.height_significant_bits(), height.significant_bits());
        assert_eq!(v.into_height(), height);
    };
    test("()", "0");
    test("(1, 3, 2)", "3");
    test("(5, 5)", "5");
}

#[test]
fn height_properties() {
    unsigned_vector_gen().test_properties(|v| {
        let height = v.to_height();
        assert_eq!(v.clone().into_height(), height);
        assert_eq!(v.height_significant_bits(), height.significant_bits());
        // The height is the largest height of any element, and is the height of the element at
        // `height_index`.
        assert_eq!(v.elements.iter().copied().max().unwrap_or_default(), height);
        match v.height_index() {
            None => assert_eq!(height, 0),
            Some(i) => assert_eq!(v.elements[usize::exact_from(i)], height),
        }
    });
}