[go: up one dir, main page]

anstyle-parse 0.2.7

Parse ANSI Style Escapes
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

//! ANSI escape code parsing state machine

#[cfg(test)]
mod codegen;
mod definitions;
mod table;

#[cfg(test)]
pub(crate) use definitions::pack;
pub(crate) use definitions::unpack;
pub use definitions::Action;
pub use definitions::State;

/// Transition to next [`State`]
///
/// Note: This does not directly support UTF-8.
/// - If the data is validated as UTF-8 (e.g. `str`) or single-byte C1 control codes are
///   unsupported, then treat [`Action::BeginUtf8`] and [`Action::Execute`] for UTF-8 continuations
///   as [`Action::Print`].
/// - If the data is not validated, then a UTF-8 state machine will need to be implemented on top,
///   starting with [`Action::BeginUtf8`].
///
/// Note: When [`State::Anywhere`] is returned, revert back to the prior state.
#[inline]
pub const fn state_change(state: State, byte: u8) -> (State, Action) {
    // Handle state changes in the anywhere state before evaluating changes
    // for current state.
    let mut change = state_change_(State::Anywhere, byte);
    if change == 0 {
        change = state_change_(state, byte);
    }

    // Unpack into a state and action
    unpack(change)
}

#[inline]
const fn state_change_(state: State, byte: u8) -> u8 {
    let state_idx = state as usize;
    let byte_idx = byte as usize;

    table::STATE_CHANGES[state_idx][byte_idx]
}