Struct os_socketaddr::OsSocketAddr

pub struct OsSocketAddr { /* fields omitted */ }

A type for handling platform-native socket addresses (struct sockaddr)

This type holds a buffer enough big to have a libc::sockaddr_in or libc::sockaddr_in6 struct. Its content can be arbitrary written using .as_mut() or .as_mut_ptr().

It also provides the conversion functions from/into std::net::SocketAddr.

See module level documentation for more details.

Methods

impl OsSocketAddr

pub fn new() -> Self

Create a new empty socket address

pub unsafe fn from_raw_parts(ptr: *const u8, len: usize) -> Self

Create a new socket address from a raw slice

Panics

Panics if len is bigger that the size of libc::sockaddr_in6

pub fn from(addr: SocketAddr) -> Self

Create a new socket address from a std::net::SocketAddr object

pub fn into_addr(self) -> Option<SocketAddr>

Attempt to convert the internal buffer into a std::net::SocketAddr object

The internal buffer is assumed to be a libc::sockaddr.

If the value of .sa_family resolves to AF_INET or AF_INET6 then the buffer is converted into SocketAddr, otherwise the function returns None.

pub fn len(&self) -> socklen_t

Return the length of the address

The result depends on the value of .sa_family in the internal buffer:

• AF_INET -> the size of sockaddr_in
• AF_INET6 -> the size of sockaddr_in6
• other -> 0

pub fn capacity(&self) -> socklen_t

Return the size of the internal buffer

pub fn as_ptr(&self) -> *const sockaddr

Get a pointer to the internal buffer

pub fn as_mut_ptr(&mut self) -> *mut sockaddr

Get a mutable pointer to the internal buffer

Trait Implementations

impl Copy for OsSocketAddr

impl Clone for OsSocketAddr

fn clone(&self) -> OsSocketAddr

Returns a copy of the value.

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

Performs copy-assignment from source.

impl AsRef<[u8]> for OsSocketAddr

fn as_ref(&self) -> &[u8]

Get the internal buffer as a byte slice

Note: the actual length of slice depends on the value of .sa_family (see .len())

impl AsMut<[u8]> for OsSocketAddr

fn as_mut(&mut self) -> &mut [u8]

Get the internal buffer as a mutable slice

impl Into<Option<SocketAddr>> for OsSocketAddr

fn into(self) -> Option<SocketAddr>

Attempt to convert the internal buffer into a std::net::SocketAddr object

The internal buffer is assumed to be a libc::sockaddr.

If the value of .sa_family resolves to AF_INET or AF_INET6 then the buffer is converted into SocketAddr, otherwise the function returns None.

impl From<SocketAddr> for OsSocketAddr

fn from(addr: SocketAddr) -> Self

Performs the conversion.

impl From<Option<SocketAddr>> for OsSocketAddr

fn from(addr: Option<SocketAddr>) -> Self

Performs the conversion.

impl Debug for OsSocketAddr

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

Formats the value using the given formatter.