Enum std::net::SocketAddr1.0.0 [] [src]

pub enum SocketAddr {
    V4(SocketAddrV4),
    V6(SocketAddrV6),
}

Representation of a socket address for networking applications.

A socket address can either represent the IPv4 or IPv6 protocol and is paired with at least a port number as well. Each protocol may have more specific information about the address available to it as well.

Variants

An IPv4 socket address which is a (ip, port) combination.

An IPv6 socket address.

Methods

impl SocketAddr
[src]

Creates a new socket address from the (ip, port) pair.

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

Returns 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

Change 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

Returns 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

Change 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

Unstable (sockaddr_checker #36949)

Returns true if the IP in this SocketAddr is a valid IPv4 address, false if it's a valid IPv6 address.

Examples

#![feature(sockaddr_checker)]

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

Unstable (sockaddr_checker #36949)

Returns true if the IP in this SocketAddr is a valid IPv6 address, false if it's a valid IPv4 address.

Examples

#![feature(sockaddr_checker)]

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 Clone for SocketAddr
[src]

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

impl PartialEq for SocketAddr
[src]

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.

impl Eq for SocketAddr
[src]

impl Hash for SocketAddr
[src]

Feeds this value into the state given, updating the hasher as necessary.

Feeds a slice of this type into the state provided.

impl Debug for SocketAddr
[src]

Formats the value using the given formatter.

impl Display for SocketAddr
[src]

Formats the value using the given formatter.

impl ToSocketAddrs for SocketAddr
[src]

Returned iterator over socket addresses which this type may correspond to. Read more

Converts this object to an iterator of resolved SocketAddrs. Read more

impl FromStr for SocketAddr
[src]

The associated error which can be returned from parsing.

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