base_scheduler/
address_info_view.rs

1// Released under the MIT License.
2// Copyright, 2026, by Samuel Williams.
3
4use crate::{AddressInfo, SocketAddress, SocketProtocol, SocketType};
5
6/// Portable accessors for a resolved IP endpoint and its socket creation parameters. A view may borrow a native resolver entry; accessing one field need not copy or normalize the others.
7pub trait AddressInfoView {
8    /// Decode the IP endpoint on demand, preserving IPv6 flow information and scope identifiers.
9    fn address(&self) -> SocketAddress;
10
11    fn socket_type(&self) -> SocketType;
12
13    /// `None` represents the resolver's zero/default protocol.
14    fn protocol(&self) -> Option<SocketProtocol>;
15
16    /// Explicitly materialize a small, owned portable record. This conversion requires no heap allocation.
17    fn to_address_info(&self) -> AddressInfo {
18        AddressInfo {
19            address: self.address(),
20            socket_type: self.socket_type(),
21            protocol: self.protocol(),
22        }
23    }
24}
25
26impl<T: AddressInfoView + ?Sized> AddressInfoView for &T {
27    fn address(&self) -> SocketAddress {
28        T::address(self)
29    }
30
31    fn socket_type(&self) -> SocketType {
32        T::socket_type(self)
33    }
34
35    fn protocol(&self) -> Option<SocketProtocol> {
36        T::protocol(self)
37    }
38}
base_scheduler/address_info_view.rs

base_scheduler/
address_info_view.rs
