Struct url::ParseOptions

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

Full configuration for the URL parser.

Implementations

impl<'a> ParseOptions<'a>

pub fn base_url(self, new: Option<&'a Url>) -> Self

Change the base URL

pub fn encoding_override(self, new: Option<EncodingRef>) -> Self

Override the character encoding of query strings. This is a legacy concept only relevant for HTML.

EncodingRef is defined in rust-encoding.

This method is only available if the query_encoding feature is enabled.

pub fn log_syntax_violation(self, new: Option<&'a dyn Fn(&'static str)>) -> Self

👎Deprecated

Call the provided function or closure on non-fatal parse errors, passing a static string description. This method is deprecated in favor of syntax_violation_callback and is implemented as an adaptor for the latter, passing the SyntaxViolation description. Only the last value passed to either method will be used by a parser.

pub fn syntax_violation_callback(
    self,
    new: Option<&'a dyn Fn(SyntaxViolation)>
) -> Self

Call the provided function or closure for a non-fatal SyntaxViolation when it occurs during parsing. Note that since the provided function is Fn, the caller might need to utilize interior mutability, such as with a RefCell, to collect the violations.

Example

use std::cell::RefCell;
use url::{Url, SyntaxViolation};
let violations = RefCell::new(Vec::new());
let url = Url::options()
    .syntax_violation_callback(Some(&|v| violations.borrow_mut().push(v)))
    .parse("https:////example.com")?;
assert_eq!(url.as_str(), "https://example.com/");
assert_eq!(violations.into_inner(),
           vec!(SyntaxViolation::ExpectedDoubleSlash));

pub fn parse(self, input: &str) -> Result<Url, ParseError>

Parse an URL string with the configuration so far.

Trait Implementations

impl<'a> Clone for ParseOptions<'a>

fn clone(&self) -> ParseOptions<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ParseOptions<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for ParseOptions<'a>