termrs_core 0.3.0

The core library of termrs
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

use std::cmp::Ordering;

use super::Offset;

/// Represents a position on a surface.
#[derive(Default, Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct Position {
    pub column: u16,
    pub row: u16,
}

impl PartialOrd for Position {
    fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
        let row_ord = self.row.partial_cmp(&other.row);

        if let Some(row_ord) = row_ord {
            match row_ord {
                Ordering::Equal => self.column.partial_cmp(&other.column),
                _ => Some(row_ord),
            }
        } else {
            None
        }
    }
}

impl Position {
    pub const ZERO: Position = Position { column: 0, row: 0 };

    pub fn new(column: u16, row: u16) -> Self {
        Self { column, row }
    }

    pub fn offset_position(self, position: Position) -> Option<Self> {
        self.offset_u16(position.column, position.row)
    }

    pub fn offset_position_negative(self, position: Position) -> Option<Self> {
        self.offset_u16_negative(position.column, position.row)
    }

    pub fn offset_u16(mut self, x: u16, y: u16) -> Option<Self> {
        self.column = self.column.checked_add(x)?;
        self.row = self.row.checked_add(y)?;

        Some(self)
    }

    pub fn offset_u16_negative(mut self, x: u16, y: u16) -> Option<Self> {
        self.column = self.column.checked_sub(x)?;
        self.row = self.row.checked_sub(y)?;

        Some(self)
    }

    pub fn offset_i16(mut self, x: i16, y: i16) -> Option<Self> {
        let x = x.try_into().ok()?;
        let y = y.try_into().ok()?;

        self.column = self.column.checked_add(x)?;
        self.row = self.row.checked_add(y)?;

        Some(self)
    }

    pub fn offset_i16_negative(mut self, x: i16, y: i16) -> Option<Self> {
        let x = x.try_into().ok()?;
        let y = y.try_into().ok()?;

        self.column = self.column.checked_sub(x)?;
        self.row = self.row.checked_sub(y)?;

        Some(self)
    }
}

impl From<(u16, u16)> for Position {
    fn from(value: (u16, u16)) -> Self {
        Self {
            column: value.0,
            row: value.1,
        }
    }
}

impl From<Offset> for Position {
    fn from(value: Offset) -> Self {
        Self {
            column: value.x,
            row: value.y,
        }
    }
}