1.0.0[−][src]Enum std::net::SocketAddr  
An internet socket address, either IPv4 or IPv6.
Internet socket addresses consist of an IP address, a 16-bit port number, as well
as possibly some version-dependent additional information. See SocketAddrV4's and
SocketAddrV6's respective documentation for more details.
The size of a SocketAddr instance may vary depending on the target operating
system.
Examples
use std::net::{IpAddr, Ipv4Addr, SocketAddr}; let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080); assert_eq!("127.0.0.1:8080".parse(), Ok(socket)); assert_eq!(socket.port(), 8080); assert_eq!(socket.is_ipv4(), true);Run
Variants
V4(SocketAddrV4)An IPv4 socket address.
V6(SocketAddrV6)An IPv6 socket address.
Methods
impl SocketAddr[src] 
impl SocketAddrpub fn new(ip: IpAddr, port: u16) -> SocketAddr1.7.0[src] 
pub fn new(ip: IpAddr, port: u16) -> SocketAddrCreates a new socket address from an IP address and a port number.
Examples
use std::net::{IpAddr, Ipv4Addr, SocketAddr}; let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080); assert_eq!(socket.ip(), IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1))); assert_eq!(socket.port(), 8080);Run
pub fn ip(&self) -> IpAddr1.7.0[src] 
pub fn ip(&self) -> IpAddrReturns the IP address associated with this socket address.
Examples
use std::net::{IpAddr, Ipv4Addr, SocketAddr}; let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080); assert_eq!(socket.ip(), IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)));Run
pub fn set_ip(&mut self, new_ip: IpAddr)1.9.0[src] 
pub fn set_ip(&mut self, new_ip: IpAddr)Changes the IP address associated with this socket address.
Examples
use std::net::{IpAddr, Ipv4Addr, SocketAddr}; let mut socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080); socket.set_ip(IpAddr::V4(Ipv4Addr::new(10, 10, 0, 1))); assert_eq!(socket.ip(), IpAddr::V4(Ipv4Addr::new(10, 10, 0, 1)));Run
pub fn port(&self) -> u16[src] 
pub fn port(&self) -> u16Returns the port number associated with this socket address.
Examples
use std::net::{IpAddr, Ipv4Addr, SocketAddr}; let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080); assert_eq!(socket.port(), 8080);Run
pub fn set_port(&mut self, new_port: u16)1.9.0[src] 
pub fn set_port(&mut self, new_port: u16)Changes the port number associated with this socket address.
Examples
use std::net::{IpAddr, Ipv4Addr, SocketAddr}; let mut socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080); socket.set_port(1025); assert_eq!(socket.port(), 1025);Run
pub fn is_ipv4(&self) -> bool1.16.0[src] 
pub fn is_ipv4(&self) -> boolReturns true if the IP address in this SocketAddr is an
IPv4 address, and false otherwise.
Examples
use std::net::{IpAddr, Ipv4Addr, SocketAddr}; fn main() { let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080); assert_eq!(socket.is_ipv4(), true); assert_eq!(socket.is_ipv6(), false); }Run
pub fn is_ipv6(&self) -> bool1.16.0[src] 
pub fn is_ipv6(&self) -> boolReturns true if the IP address in this SocketAddr is an
IPv6 address, and false otherwise.
Examples
use std::net::{IpAddr, Ipv6Addr, SocketAddr}; fn main() { let socket = SocketAddr::new( IpAddr::V6(Ipv6Addr::new(0, 0, 0, 0, 0, 65535, 0, 1)), 8080); assert_eq!(socket.is_ipv4(), false); assert_eq!(socket.is_ipv6(), true); }Run
Trait Implementations
impl Copy for SocketAddr[src] 
impl Copy for SocketAddrimpl Clone for SocketAddr[src] 
impl Clone for SocketAddrfn clone(&self) -> SocketAddr[src] 
fn clone(&self) -> SocketAddrReturns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)[src] 
fn clone_from(&mut self, source: &Self)Performs copy-assignment from source. Read more
impl PartialEq for SocketAddr[src] 
impl PartialEq for SocketAddrfn eq(&self, other: &SocketAddr) -> bool[src] 
fn eq(&self, other: &SocketAddr) -> boolThis method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, other: &SocketAddr) -> bool[src] 
fn ne(&self, other: &SocketAddr) -> boolThis method tests for !=.
impl Eq for SocketAddr[src] 
impl Eq for SocketAddrimpl Hash for SocketAddr[src] 
impl Hash for SocketAddrfn hash<__H: Hasher>(&self, state: &mut __H)[src] 
fn hash<__H: Hasher>(&self, state: &mut __H)Feeds this value into the given [Hasher]. Read more
fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 1.3.0[src] 
fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, Feeds a slice of this type into the given [Hasher]. Read more
impl Debug for SocketAddr[src] 
impl Debug for SocketAddrfn fmt(&self, f: &mut Formatter) -> Result[src] 
fn fmt(&self, f: &mut Formatter) -> ResultFormats the value using the given formatter. Read more
impl From<SocketAddrV4> for SocketAddr1.16.0[src] 
impl From<SocketAddrV4> for SocketAddrfn from(sock4: SocketAddrV4) -> SocketAddr[src] 
fn from(sock4: SocketAddrV4) -> SocketAddrPerforms the conversion.
impl From<SocketAddrV6> for SocketAddr1.16.0[src] 
impl From<SocketAddrV6> for SocketAddrfn from(sock6: SocketAddrV6) -> SocketAddr[src] 
fn from(sock6: SocketAddrV6) -> SocketAddrPerforms the conversion.
impl<I: Into<IpAddr>> From<(I, u16)> for SocketAddr1.17.0[src] 
impl<I: Into<IpAddr>> From<(I, u16)> for SocketAddrimpl Display for SocketAddr[src] 
impl Display for SocketAddrfn fmt(&self, f: &mut Formatter) -> Result[src] 
fn fmt(&self, f: &mut Formatter) -> ResultFormats the value using the given formatter. Read more
impl ToSocketAddrs for SocketAddr[src] 
impl ToSocketAddrs for SocketAddrtype Iter = IntoIter<SocketAddr>
Returned iterator over socket addresses which this type may correspond to. Read more
fn to_socket_addrs(&self) -> Result<IntoIter<SocketAddr>>[src] 
fn to_socket_addrs(&self) -> Result<IntoIter<SocketAddr>>Converts this object to an iterator of resolved SocketAddrs. Read more
impl FromStr for SocketAddr[src] 
impl FromStr for SocketAddrtype Err = AddrParseError
The associated error which can be returned from parsing.
fn from_str(s: &str) -> Result<SocketAddr, AddrParseError>[src] 
fn from_str(s: &str) -> Result<SocketAddr, AddrParseError>Parses a string s to return a value of this type. Read more
Auto Trait Implementations
impl Send for SocketAddr
impl Send for SocketAddrimpl Sync for SocketAddr
impl Sync for SocketAddrBlanket Implementations
impl<T> From for T[src] 
impl<T> From for Timpl<T, U> TryFrom for T where
    T: From<U>, [src] 
impl<T, U> TryFrom for T where
    T: From<U>, type Error = !
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src] 
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>Performs the conversion.
impl<T, U> TryInto for T where
    U: TryFrom<T>, [src] 
impl<T, U> TryInto 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>[src] 
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>Performs the conversion.
impl<T, U> Into for T where
    U: From<T>, [src] 
impl<T, U> Into for T where
    U: From<T>, impl<T> Borrow for T where
    T: ?Sized, [src] 
impl<T> Borrow for T where
    T: ?Sized, ⓘImportant traits for &'a mut Ifn borrow(&self) -> &T[src] 
fn borrow(&self) -> &TImmutably borrows from an owned value. Read more
impl<T> BorrowMut for T where
    T: ?Sized, [src] 
impl<T> BorrowMut for T where
    T: ?Sized, ⓘImportant traits for &'a mut Ifn borrow_mut(&mut self) -> &mut T[src] 
fn borrow_mut(&mut self) -> &mut TMutably borrows from an owned value. Read more
impl<T> Any for T where
    T: 'static + ?Sized, [src] 
impl<T> Any for T where
    T: 'static + ?Sized, fn get_type_id(&self) -> TypeId[src] 
fn get_type_id(&self) -> TypeId🔬 This is a nightly-only experimental API.  (get_type_id #27745)
this method will likely be replaced by an associated static
Gets the TypeId of self. Read more
impl<T> ToOwned for T where
    T: Clone, [src] 
impl<T> ToOwned for T where
    T: Clone, type Owned = T
fn to_owned(&self) -> T[src] 
fn to_owned(&self) -> TCreates owned data from borrowed data, usually by cloning. Read more
fn clone_into(&self, target: &mut T)[src] 
fn clone_into(&self, target: &mut T)🔬 This is a nightly-only experimental API.  (toowned_clone_into #41263)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
impl<T> ToString for T where
    T: Display + ?Sized, [src] 
impl<T> ToString for T where
    T: Display + ?Sized,