Struct std::net::AddrParseError

pub struct AddrParseError(_);

An error which can be returned when parsing an IP address or a socket address.

This error is used as the error type for the FromStr implementation for IpAddr, Ipv4Addr, Ipv6Addr, SocketAddr, SocketAddrV4, and SocketAddrV6.

Potential causes

AddrParseError may be thrown because the provided string does not parse as the given type, often because it includes information only handled by a different address type.

use std::net::IpAddr;
let _foo: IpAddr = "127.0.0.1:8080".parse().expect("Cannot handle the socket port");

IpAddr doesn't handle the port. Use SocketAddr instead.

use std::net::SocketAddr;

// No problem, the `panic!` message has disappeared.
let _foo: SocketAddr = "127.0.0.1:8080".parse().expect("unreachable panic");

Trait Implementations

impl Error for AddrParseError

fn description(&self) -> &str

This method is soft-deprecated.

fn cause(&self) -> Option<&dyn Error>

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

The lower-level cause of this error, if any.

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace #53487)

Returns a stack backtrace, if available, of where this error ocurred.

impl PartialEq<AddrParseError> for AddrParseError

fn eq(&self, other: &AddrParseError) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &AddrParseError) -> bool

This method tests for !=.

impl Eq for AddrParseError

impl Debug for AddrParseError

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

Formats the value using the given formatter.

impl Display for AddrParseError

fn fmt(&self, fmt: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Clone for AddrParseError

fn clone(&self) -> AddrParseError

Returns a copy of the value.

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

Performs copy-assignment from source.