rama::net::address

Struct HostWithOptPort

pub struct HostWithOptPort {
    pub host: Host,
    pub port: Option<u16>,
}

Available on crate feature net only.

Expand description

A Host with optionally a port.

§Examples

example.com
127.0.0.1
::
example.com:80
127.0.0.1:80
[::]:80

Fields§

§host: Host§port: Option<u16>

Implementations§

§

impl HostWithOptPort

pub const fn new(host: Host) -> HostWithOptPort

Creates a new HostWithOptPort from a Host.

pub const fn new_with_port(host: Host, port: u16) -> HostWithOptPort

Creates a new HostWithOptPort from a Host and port.

pub const fn local_ipv4() -> HostWithOptPort

creates a new local ipv4 HostWithOptPort without a port.

§Example

use rama_net::address::HostWithOptPort;

let addr = HostWithOptPort::local_ipv4();
assert_eq!("127.0.0.1", addr.to_string());

pub const fn local_ipv4_with_port(port: u16) -> HostWithOptPort

creates a new local ipv4 HostWithOptPort with the given port

§Example

use rama_net::address::HostWithOptPort;

let addr = HostWithOptPort::local_ipv4_with_port(8080);
assert_eq!("127.0.0.1:8080", addr.to_string());

pub const fn local_ipv6() -> HostWithOptPort

creates a new local ipv6 HostWithOptPort without a port.

§Example

use rama_net::address::HostWithOptPort;

let addr = HostWithOptPort::local_ipv6();
assert_eq!("::1", addr.to_string());

pub const fn local_ipv6_with_port(port: u16) -> HostWithOptPort

creates a new local ipv6 HostWithOptPort with the given port.

§Example

use rama_net::address::HostWithOptPort;

let addr = HostWithOptPort::local_ipv6_with_port(8080);
assert_eq!("[::1]:8080", addr.to_string());

pub const fn default_ipv4() -> HostWithOptPort

creates a default ipv4 HostWithOptPort without a port

§Example

use rama_net::address::HostWithOptPort;

let addr = HostWithOptPort::default_ipv4_with_port(8080);
assert_eq!("0.0.0.0:8080", addr.to_string());

pub const fn default_ipv4_with_port(port: u16) -> HostWithOptPort

creates a default ipv4 HostWithOptPort with the given port

§Example

use rama_net::address::HostWithOptPort;

let addr = HostWithOptPort::default_ipv4_with_port(8080);
assert_eq!("0.0.0.0:8080", addr.to_string());

pub const fn default_ipv6() -> HostWithOptPort

creates a new default ipv6 HostWithOptPort without a port.

§Example

use rama_net::address::HostWithOptPort;

let addr = HostWithOptPort::default_ipv6();
assert_eq!("::", addr.to_string());

pub const fn default_ipv6_with_port(port: u16) -> HostWithOptPort

creates a new default ipv6 HostWithOptPort with the given port.

§Example

use rama_net::address::HostWithOptPort;

let addr = HostWithOptPort::default_ipv6_with_port(8080);
assert_eq!("[::]:8080", addr.to_string());

pub const fn broadcast_ipv4() -> HostWithOptPort

creates a new broadcast ipv4 HostWithOptPort without a port

§Example

use rama_net::address::HostWithOptPort;

let addr = HostWithOptPort::broadcast_ipv4();
assert_eq!("255.255.255.255", addr.to_string());

pub const fn broadcast_ipv4_with_port(port: u16) -> HostWithOptPort

creates a new broadcast ipv4 HostWithOptPort with the given port

§Example

use rama_net::address::HostWithOptPort;

let addr = HostWithOptPort::broadcast_ipv4_with_port(8080);
assert_eq!("255.255.255.255:8080", addr.to_string());

pub const fn example_domain() -> HostWithOptPort

Creates a new example domain HostWithOptPort without a port.

pub const fn example_domain_http() -> HostWithOptPort

Creates a new example domain HostWithOptPort for the http default port.

pub const fn example_domain_https() -> HostWithOptPort

Creates a new example domain HostWithOptPort for the https default port.

pub const fn example_domain_with_port(port: u16) -> HostWithOptPort

Creates a new example domain HostWithOptPort for the given port.

pub const fn localhost_domain() -> HostWithOptPort

Creates a new localhost domain HostWithOptPort without a port.

pub const fn localhost_domain_http() -> HostWithOptPort

Creates a new localhost domain HostWithOptPort for the http default port.

pub const fn localhost_domain_https() -> HostWithOptPort

Creates a new localhost domain HostWithOptPort for the https default port.

pub const fn localhost_domain_with_port(port: u16) -> HostWithOptPort

Creates a new localhost domain HostWithOptPort for the given port.

pub fn with_host(self, host: Host) -> HostWithOptPort

Set Host of HostWithOptPort

pub fn set_host(&mut self, host: Host) -> &mut HostWithOptPort

Set Host of HostWithOptPort

pub fn maybe_with_port(self, port: Option<u16>) -> HostWithOptPort

(un)set port (u16) of HostWithOptPort

pub fn maybe_set_port(&mut self, port: Option<u16>) -> &mut HostWithOptPort

(un)set port (u16) of HostWithOptPort

pub fn with_port(self, port: u16) -> HostWithOptPort

(un)set port (u16) of HostWithOptPort

pub fn set_port(&mut self, port: u16) -> &mut HostWithOptPort

(un)set port (u16) of HostWithOptPort

pub fn without_port(self) -> HostWithOptPort

(un)set port (u16) of HostWithOptPort

pub fn unset_port(&mut self) -> &mut HostWithOptPort

(un)set port (u16) of HostWithOptPort

Trait Implementations§

§

impl Clone for HostWithOptPort

§

fn clone(&self) -> HostWithOptPort

Returns a duplicate of the value. Read more

1.0.0 · Source§

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

Performs copy-assignment from source. Read more

§

impl Debug for HostWithOptPort

§

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

Formats the value using the given formatter. Read more

§

impl<'de> Deserialize<'de> for HostWithOptPort

§

fn deserialize<D>( deserializer: D, ) -> Result<HostWithOptPort, <D as Deserializer<'de>>::Error>
where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

§

impl Display for HostWithOptPort

§

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

Formats the value using the given formatter. Read more

§