Struct Parser

impl<'a> Parser<'a>

fn new(input: &'a [u8]) -> Parser<'a>

fn read_atomically<T, F>(&mut self, inner: F) -> Option<T>
where
    F: FnOnce(&mut Parser<'_>) -> Option<T>,

Run a parser, and restore the pre-parse state if it fails.

fn parse_with<T, F>(&mut self, inner: F, kind: AddrKind) -> Result<T, AddrParseError>
where
    F: FnOnce(&mut Parser<'_>) -> Option<T>,

Run a parser, but fail if the entire input wasn't consumed. Doesn't run atomically.

fn read_char(&mut self) -> Option<char>

Reads the next character from the input

fn read_given_char(&mut self, target: char) -> Option<()>

Reads the next character from the input if it matches the target.

fn read_separator<T, F>(&mut self, sep: char, index: usize, inner: F) -> Option<T>
where
    F: FnOnce(&mut Parser<'_>) -> Option<T>,

Helper for reading separators in an indexed loop. Reads the separator character iff index > 0, then runs the parser. When used in a loop, the separator character will only be read on index > 0 (see read_ipv4_addr for an example)

fn read_radix_max_digits<T: ReadNumberHelper + TryFrom<u32>>(&mut self, radix: u32, max_digits: u32, allow_zero_prefix: bool) -> Option<T>

Reads a number off the front of the input in the given radix, stopping at the first non-digit character or eof. Fails if the number has more digits than max_digits, if there is no number, if the number overflows T, or if there are leading zeros but allow_zero_prefix is false.

max_digits must be in 1..=6.

fn read_decimal<T: ReadNumberHelper>(&mut self) -> Option<T>

Reads a decimal number off the front of the input, stopping at the first non-digit character or eof. Fails if there is no number, or if the number overflows T. Allows an arbitrary amount of leading zeros.

fn read_ipv4_addr(&mut self) -> Option<Ipv4Addr>

Reads an IPv4 address.

fn read_ipv6_addr(&mut self) -> Option<Ipv6Addr>

Reads an IPv6 address.

fn read_ip_addr(&mut self) -> Option<IpAddr>

Reads an IP address, either IPv4 or IPv6.

fn read_port(&mut self) -> Option<u16>

Reads a : followed by a port in base 10.

fn read_scope_id(&mut self) -> Option<u32>

Reads a % followed by a scope ID in base 10.

fn read_socket_addr_v4(&mut self) -> Option<SocketAddrV4>

Reads an IPv4 address with a port.

fn read_socket_addr_v6(&mut self) -> Option<SocketAddrV6>

Reads an IPv6 address with a port.

fn read_socket_addr(&mut self) -> Option<SocketAddr>

Reads an IP address with a port.