kamo 0.8.0

A library to assist in the creation of an interpreter or compiler and its associated runtime.
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

use crate::parser::{code, Input, ParseError, ParseResult};

use super::CombinatorError;

/// Asserts that the input is at the end of the input.
///
/// # Errors
///
/// If the input is not at the end of the input, it returns a [`ParseError`]
/// with the code [`ERR_NOT_EOF`](code::ERR_NOT_EOF) and the error
/// [`CombinatorError::Eof`].
///
/// # Examples
///
/// ```rust
/// # use kamo::{Position, parser::{prelude::*, CombinatorError, code, Input}};
/// let mut parser = eof;
///
/// assert_eq!(parser.parse("".into()), Ok(("", Input::from(""))));
/// assert_eq!(parser.parse("a".into()), Err(ParseError::new(
///     Position::new(0, 1, 1),
///     code::ERR_NOT_EOF,
///     CombinatorError::Eof
/// )));
/// ```
pub fn eof(input: Input<'_>) -> ParseResult<'_, &str> {
    if input.is_eof() {
        Ok(("", input))
    } else {
        Err(ParseError::new(
            input,
            code::ERR_NOT_EOF,
            CombinatorError::Eof,
        ))
    }
}