Struct XffChain 

pub struct XffChain<'a> { /* private fields */ }

A validated X-Forwarded-For chain.

Examples

use parse_net::{forwarded::parse_x_forwarded_for, Limits};

let lines: [&[u8]; 1] = [b"203.0.113.9, 10.0.0.1:8080"];
let chain = parse_x_forwarded_for(&lines, &Limits::DEFAULT)?;
assert_eq!(chain.len(), 2);
assert_eq!(chain.iter().last(), Some(("10.0.0.1".parse()?, Some(8080))));

Implementations

impl<'a> XffChain<'a>

pub fn iter(&self) -> impl Iterator<Item = (IpAddr, Option<u16>)> + use<'a>

The addresses and ports, left to right across every line.

Examples

use parse_net::{forwarded::parse_x_forwarded_for, Limits};

let lines: [&[u8]; 1] = [b"203.0.113.9, [2001:db8::1]:443"];
let mut it = parse_x_forwarded_for(&lines, &Limits::DEFAULT)?.iter();
assert_eq!(it.next(), Some(("203.0.113.9".parse()?, None)));
assert_eq!(it.next(), Some(("2001:db8::1".parse()?, Some(443))));
assert_eq!(it.next(), None);

pub const fn len(&self) -> usize

The number of addresses.

Examples

use parse_net::{forwarded::parse_x_forwarded_for, Limits};

let lines: [&[u8]; 2] = [b"203.0.113.9, 198.51.100.7", b"10.0.0.1"];
assert_eq!(parse_x_forwarded_for(&lines, &Limits::DEFAULT)?.len(), 3);

pub const fn is_empty(&self) -> bool

Whether there are no addresses.

Examples

use parse_net::{forwarded::parse_x_forwarded_for, Limits};

let none: [&[u8]; 0] = [];
assert!(parse_x_forwarded_for(&none, &Limits::DEFAULT)?.is_empty());
assert!(!parse_x_forwarded_for(&[&b"10.0.0.1"[..]], &Limits::DEFAULT)?.is_empty());

Trait Implementations

impl<'a> Clone for XffChain<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Copy for XffChain<'a>

impl<'a> Debug for XffChain<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.