GeezerVison is showing doc.rust-lang.org — SocketAddrV4 in std::net - Rust Struct SocketAddrV4 1.0.0 · Source pub struct SocketAddrV4 { /* private fields */ }
Expand descriptionAn IPv4 socket address.
IPv4 socket addresses consist of an IPv4 address and a 16-bit port number, as
stated in IETF RFC 793.
See SocketAddr for a type encompassing both IPv4 and IPv6 socket addresses.
§Portability
SocketAddrV4 is intended to be a portable representation of socket addresses and is likely not
the same as the internal socket address type used by the target operating system’s API. Like all
repr(Rust) structs, however, its exact layout remains undefined and should not be relied upon
between builds.
§Textual representation
SocketAddrV4 provides a FromStr implementation.
It accepts an IPv4 address in its textual representation, followed by a
single :, followed by the port encoded as a decimal integer. Other
formats are not accepted.
§Examples
use std::net::{Ipv4Addr, SocketAddrV4};
let socket = SocketAddrV4::new(Ipv4Addr::new(127, 0, 0, 1), 8080);
assert_eq!("127.0.0.1:8080".parse(), Ok(socket));
assert_eq!(socket.ip(), &Ipv4Addr::new(127, 0, 0, 1));
assert_eq!(socket.port(), 8080);
Implementations§
🔬This is a nightly-only experimental API. (addr_parse_ascii #101035)
Parse an IPv4 socket address from a slice of bytes.
#![feature(addr_parse_ascii)]
use std::net::{Ipv4Addr, SocketAddrV4};
let socket = SocketAddrV4::new(Ipv4Addr::new(127, 0, 0, 1), 8080);
assert_eq!(SocketAddrV4::parse_ascii(b"127.0.0.1:8080"), Ok(socket));
1.0.0 (const: 1.69.0) · SourceCreates a new socket address from an IPv4 address and a port number.
§Examples
use std::net::{SocketAddrV4, Ipv4Addr};
let socket = SocketAddrV4::new(Ipv4Addr::new(127, 0, 0, 1), 8080);
Returns the IP address associated with this socket address.
§Examples
use std::net::{SocketAddrV4, Ipv4Addr};
let socket = SocketAddrV4::new(Ipv4Addr::new(127, 0, 0, 1), 8080);
assert_eq!(socket.ip(), &Ipv4Addr::new(127, 0, 0, 1));
Changes the IP address associated with this socket address.
§Examples
use std::net::{SocketAddrV4, Ipv4Addr};
let mut socket = SocketAddrV4::new(Ipv4Addr::new(127, 0, 0, 1), 8080);
socket.set_ip(Ipv4Addr::new(192, 168, 0, 1));
assert_eq!(socket.ip(), &Ipv4Addr::new(192, 168, 0, 1));
Returns the port number associated with this socket address.
§Examples
use std::net::{SocketAddrV4, Ipv4Addr};
let socket = SocketAddrV4::new(Ipv4Addr::new(127, 0, 0, 1), 8080);
assert_eq!(socket.port(), 8080);
Changes the port number associated with this socket address.
§Examples
use std::net::{SocketAddrV4, Ipv4Addr};
let mut socket = SocketAddrV4::new(Ipv4Addr::new(127, 0, 0, 1), 8080);
socket.set_port(4242);
assert_eq!(socket.port(), 4242);
Trait Implementations§
Performs copy-assignment from source. Read more
Formats the value using the given formatter. Read more
Formats the value using the given formatter. Read more
The associated error which can be returned from parsing.
Parses a string s to return a value of this type. Read more
Compares and returns the maximum of two values. Read more
Compares and returns the minimum of two values. Read more
Restrict a value to a certain interval. Read more
This method returns an ordering between self and other values if one exists. Read more
Tests less than (for self and other) and is used by the < operator. Read more
Tests less than or equal to (for self and other) and is used by the
<= operator. Read more
Tests greater than (for self and other) and is used by the >
operator. Read more
Tests greater than or equal to (for self and other) and is used by
the >= operator. Read more
Returned iterator over socket addresses which this type may correspond
to.
Auto Trait Implementations§Blanket Implementations§
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
🔬This is a nightly-only experimental API. (clone_to_uninit #126799) Performs copy-assignment from self to dest. Read more
Returns the argument unchanged.
Calls U::from(self).
That is, this conversion is whatever the implementation of
From<T> for U chooses to do.
The resulting type after obtaining ownership.
Creates owned data from borrowed data, usually by cloning. Read more
Uses borrowed data to replace owned data, usually by cloning. Read more
Converts the given value to a String. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion. |