W3cubDocs

/Rust

Enum std::net::SocketAddr

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);

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)));

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)));

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);

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);

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

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);
}

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

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);
}

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 From<SocketAddrV4> for SocketAddr
1.16.0
[src]

Performs the conversion.

impl From<SocketAddrV6> for SocketAddr
1.16.0
[src]

Performs the conversion.

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

© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/net/enum.SocketAddr.html