SocketAddress

rama::net::address

Struct SocketAddress

pub struct SocketAddress {
    pub ip_addr: IpAddr,
    pub port: u16,
}

Available on crate feature net only.

Expand description

An IpAddr with an associated port (u16)

Fields§

§ip_addr: IpAddr§port: u16

Implementations§

impl SocketAddress

pub const fn new(ip_addr: IpAddr, port: u16) -> SocketAddress

creates a new SocketAddress

pub const fn local_ipv4(port: u16) -> SocketAddress

creates a new local ipv4 SocketAddress for the given port

§Example

use rama_net::address::SocketAddress;

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

pub const fn local_ipv6(port: u16) -> SocketAddress

creates a new local ipv6 SocketAddress for the given port.

§Example

use rama_net::address::SocketAddress;

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

pub const fn default_ipv4(port: u16) -> SocketAddress

creates a new default ipv4 SocketAddress for the given port

§Example

use rama_net::address::SocketAddress;

let addr = SocketAddress::default_ipv4(8080);
assert_eq!("0.0.0.0:8080", addr.to_string());

pub const fn default_ipv6(port: u16) -> SocketAddress

creates a new default ipv6 SocketAddress for the given port.

§Example

use rama_net::address::SocketAddress;

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

pub fn from_std(addr: SocketAddr) -> SocketAddress

Create a SocketAddress from the std SocketAddr version.

pub fn into_std(self) -> SocketAddr

Turn the SocketAddress into the std SocketAddr version.

pub const fn broadcast_ipv4(port: u16) -> SocketAddress

creates a new broadcast ipv4 SocketAddress for the given port

§Example

use rama_net::address::SocketAddress;

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

pub fn with_ip(self, ip_addr: IpAddr) -> SocketAddress

Set IpAddr as the ip of SocketAddress

pub fn set_ip(&mut self, ip_addr: IpAddr) -> &mut SocketAddress

Set IpAddr as the ip of SocketAddress

pub fn with_ipv4(self, ip_addr: Ipv4Addr) -> SocketAddress

Set Ipv4Addr as the ip of SocketAddress

pub fn set_ipv4(&mut self, ip_addr: Ipv4Addr) -> &mut SocketAddress

Set Ipv4Addr as the ip of SocketAddress

pub fn with_ipv6(self, ip_addr: Ipv6Addr) -> SocketAddress

Set Ipv6Addr as the ip of SocketAddress

pub fn set_ipv6(&mut self, ip_addr: Ipv6Addr) -> &mut SocketAddress

Set Ipv6Addr as the ip of SocketAddress

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

Set port (u16) of SocketAddress

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

Set port (u16) of SocketAddress

Trait Implementations§

impl Clone for SocketAddress

fn clone(&self) -> SocketAddress

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 SocketAddress

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

Formats the value using the given formatter. Read more

impl<'de> Deserialize<'de> for SocketAddress

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

Deserialize this value from the given Serde deserializer. Read more

impl Display for SocketAddress

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

Formats the value using the given formatter. Read more

impl From<&SocketAddr> for SocketAddress

fn from(addr: &SocketAddr) -> SocketAddress

Converts to this type from the input type.

impl From<&SocketAddress> for Authority

fn from(addr: &SocketAddress) -> Authority

Converts to this type from the input type.

impl From<&SocketAddress> for HostWithOptPort

fn from(addr: &SocketAddress) -> HostWithOptPort

Converts to this type from the input type.

impl From<&SocketAddress> for HostWithPort

fn from(addr: &SocketAddress) -> HostWithPort

Converts to this type from the input type.

impl From<&SocketAddress> for Interface

fn from(addr: &SocketAddress) -> Interface

Converts to this type from the input type.

impl From<&SocketAddress> for SockAddr

fn from(addr: &SocketAddress) -> SockAddr

Converts to this type from the input type.

impl From<([u8; 16], u16)> for SocketAddress

fn from(_: ([u8; 16], u16)) -> SocketAddress

Converts to this type from the input type.

impl From<([u8; 4], u16)> for SocketAddress

fn from(_: ([u8; 4], u16)) -> SocketAddress

Converts to this type from the input type.

impl From<(IpAddr, u16)> for SocketAddress

fn from(_: (IpAddr, u16)) -> SocketAddress

Converts to this type from the input type.

impl From<(Ipv4Addr, u16)> for SocketAddress

fn from(_: (Ipv4Addr, u16)) -> SocketAddress

Converts to this type from the input type.

impl From<(Ipv6Addr, u16)> for SocketAddress

fn from(_: (Ipv6Addr, u16)) -> SocketAddress

Converts to this type from the input type.

impl From<SocketAddr> for SocketAddress

fn from(addr: SocketAddr) -> SocketAddress

Converts to this type from the input type.

impl From<SocketAddrV4> for SocketAddress

fn from(value: SocketAddrV4) -> SocketAddress

Converts to this type from the input type.

impl From<SocketAddrV6> for SocketAddress

fn from(value: SocketAddrV6) -> SocketAddress

Converts to this type from the input type.

impl From<SocketAddress> for Authority

fn from(addr: SocketAddress) -> Authority

Converts to this type from the input type.

impl From<SocketAddress> for ForwardedAuthority

fn from(value: SocketAddress) -> ForwardedAuthority

Converts to this type from the input type.

impl From<SocketAddress> for HostWithOptPort

fn from(addr: SocketAddress) -> HostWithOptPort

Converts to this type from the input type.

impl From<SocketAddress> for HostWithPort

fn from(addr: SocketAddress) -> HostWithPort

Converts to this type from the input type.

impl From<SocketAddress> for Interface

fn from(addr: SocketAddress) -> Interface

Converts to this type from the input type.

impl From<SocketAddress> for SockAddr

fn from(addr: SocketAddress) -> SockAddr

Converts to this type from the input type.

impl From<SocketAddress> for SocketAddr

fn from(addr: SocketAddress) -> SocketAddr

Converts to this type from the input type.

impl FromStr for SocketAddress

type Err = OpaqueError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<SocketAddress, <SocketAddress as FromStr>::Err>

Parses a string s to return a value of this type. Read more

impl Hash for SocketAddress

fn hash<H>(&self, state: &mut H)
where __H: Hasher,

Feeds this value into the given Hasher. Read more

1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more

impl PartialEq<SocketAddr> for SocketAddress

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

Tests for self and other values to be equal, and is used by ==.

1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<SocketAddress> for SocketAddr

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

Tests for self and other values to be equal, and is used by ==.

1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for SocketAddress

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

Tests for self and other values to be equal, and is used by ==.

1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SocketAddress

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>
where S: Serializer,

Serialize this value into the given Serde serializer. Read more

impl TcpStreamConnector for SocketAddress

type Error = OpaqueError

Type of error that can occurr when establishing the connection failed.

async fn connect( &self, addr: SocketAddr, ) -> Result<TcpStream, <SocketAddress as TcpStreamConnector>::Error>

Connect to the target via the given SocketAddress to establish a TcpStream.

impl TryFrom<&[u8]> for SocketAddress

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from( bytes: &[u8], ) -> Result<SocketAddress, <SocketAddress as TryFrom<&[u8]>>::Error>

Performs the conversion.

impl TryFrom<&HeaderValue> for SocketAddress

Available on crate feature http only.

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from( header: &HeaderValue, ) -> Result<SocketAddress, <SocketAddress as TryFrom<&HeaderValue>>::Error>

Performs the conversion.

impl TryFrom<&String> for SocketAddress

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from( value: &String, ) -> Result<SocketAddress, <SocketAddress as TryFrom<&String>>::Error>

Performs the conversion.

impl TryFrom<&str> for SocketAddress

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from( s: &str, ) -> Result<SocketAddress, <SocketAddress as TryFrom<&str>>::Error>

Performs the conversion.

impl TryFrom<HeaderValue> for SocketAddress

Available on crate feature http only.

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from( header: HeaderValue, ) -> Result<SocketAddress, <SocketAddress as TryFrom<HeaderValue>>::Error>

Performs the conversion.

impl TryFrom<String> for SocketAddress

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from( s: String, ) -> Result<SocketAddress, <SocketAddress as TryFrom<String>>::Error>

Performs the conversion.

impl TryFrom<Vec<u8>> for SocketAddress

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from( bytes: Vec<u8>, ) -> Result<SocketAddress, <SocketAddress as TryFrom<Vec<u8>>>::Error>

Performs the conversion.

impl Copy for SocketAddress

impl Eq for SocketAddress

impl StructuralPartialEq for SocketAddress

Auto Trait Implementations§

impl Freeze for SocketAddress

impl RefUnwindSafe for SocketAddress

impl Send for SocketAddress

impl Sync for SocketAddress

impl Unpin for SocketAddress

impl UnwindSafe for SocketAddress

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)

Performs copy-assignment from self to dest. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> FromRef<T> for T
where T: Clone,

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.

impl<T> FutureExt for T

fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ

Attaches the provided Context to this type, returning a WithContext wrapper. Read more

fn with_current_context(self) -> WithContext<Self> ⓘ

Attaches the current Context to this type, returning a WithContext wrapper. Read more

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

impl<T> Pointable for T

const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

impl<T, U> RamaFrom<T> for U
where U: From<T>,

fn rama_from(value: T) -> U

impl<T, U, CrateMarker> RamaInto<U, CrateMarker> for T
where U: RamaFrom<T, CrateMarker>,

fn rama_into(self) -> U

impl<T, U> RamaTryFrom<T> for U
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn rama_try_from(value: T) -> Result<U, <U as RamaTryFrom<T>>::Error>

impl<T, U, CrateMarker> RamaTryInto<U, CrateMarker> for T
where U: RamaTryFrom<T, CrateMarker>,

type Error = <U as RamaTryFrom<T, CrateMarker>>::Error

fn rama_try_into(self) -> Result<U, <U as RamaTryFrom<T, CrateMarker>>::Error>

impl<T> Same for T

type Output = T

Should always be Self

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T> ToSmolStr for T
where T: Display + ?Sized,

fn to_smolstr(&self) -> SmolStr

impl<T> ToString for T
where T: Display + ?Sized,

fn to_string(&self) -> String

Converts the given value to a String. Read more

impl<T> ToStringFallible for T
where T: Display,

fn try_to_string(&self) -> Result<String, TryReserveError>

ToString::to_string, but without panic on OOM.

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,