Crate nom5_locate

nom_locate, a special input type to locate tokens

The source code is available on Github

Features

This crate exposes two cargo feature flags, avx-accel and simd-accel. These correspond to the features exposed by bytecount. Compile with SSE support (available on most modern x86_64 processors) using simd-accel, or with AVX support (which likely requires compiling for the native target CPU) with both.

How to use it

The explanations are given in the README of the Github repository. You may also consult the FAQ.

#[macro_use]
extern crate nom;
#[macro_use]
extern crate nom_locate;

use nom_locate::LocatedSpan;
type Span<'a> = LocatedSpan<&'a str>;

struct Token<'a> {
    pub position: Span<'a>,
    pub foo: String,
    pub bar: String,
}

named!(parse_foobar( Span ) -> Token, do_parse!(
    take_until!("foo") >>
    position: position!() >>
    foo: tag!("foo") >>
    bar: tag!("bar") >>
    (Token {
        position: position,
        foo: foo.to_string(),
        bar: bar.to_string()
    })
));

fn main () {
    let input = Span::new("Lorem ipsum \n foobar");
    let output = parse_foobar(input);
    let position = output.unwrap().1.position;
    assert_eq!(position, Span {
        offset: 14,
        line: 2,
        fragment: ""
    });
    assert_eq!(position.get_column(), 2);
}
fn main() {}

Macros

impl_compare	Implement nom::Compare for a specific fragment type.
impl_extend_into	Implement nom::ExtendInto for a specific fragment type.
impl_hex_display
impl_input_iter	Implement nom::InputIter for a specific fragment type
impl_slice_range	Implement nom::Slice for a specific fragment type and range type.
impl_slice_ranges	Implement nom::Slice for a specific fragment type and for these types of range:
position	Capture the position of the current fragment

Structs

LocatedSpan

A LocatedSpan is a set of meta information about the location of a token.