Function `tab`

fn tab<Input, Error>(input: &mut Input) -> Result<char, Error>
where
    Input: StreamIsPartial + Stream + Compare<char>,
    Error: ParserError<Input>

Matches a tab character '\t'.

Complete version: Will return an error if there's not enough input data.

[Partial version][crate::_topic::partial]: Will return Err(winnow::error::ErrMode::Incomplete(_)) if there's not enough input data.

Effective Signature

Assuming you are parsing a &str [Stream]:

# use winnow::prelude::*;;
pub fn tab(input: &mut &str) -> ModalResult<char>
# {
#     winnow::ascii::tab.parse_next(input)
# }

Example

# use winnow::prelude::*;
# use winnow::ascii::tab;
fn parser<'s>(input: &mut &'s str) -> ModalResult<char> {
    tab.parse_next(input)
}

assert_eq!(parser.parse_peek("\tc"), Ok(("c", '\t')));
assert!(parser.parse_peek("\r\nc").is_err());
assert!(parser.parse_peek("").is_err());

# use winnow::prelude::*;
# use winnow::{error::ErrMode, error::ContextError, error::Needed};
# use winnow::Partial;
# use winnow::ascii::tab;
assert_eq!(tab::<_, ErrMode<ContextError>>.parse_peek(Partial::new("\tc")), Ok((Partial::new("c"), '\t')));
assert!(tab::<_, ErrMode<ContextError>>.parse_peek(Partial::new("\r\nc")).is_err());
assert_eq!(tab::<_, ErrMode<ContextError>>.parse_peek(Partial::new("")), Err(ErrMode::Incomplete(Needed::Unknown)));