Struct std::os::unix::net::SocketAddr

pub struct SocketAddr { /* private fields */ }

Available on Unix only.

与 Unix 套接字关联的地址。

Examples

use std::os::unix::net::UnixListener;

let socket = match UnixListener::bind("/tmp/sock") {
    Ok(sock) => sock,
    Err(e) => {
        println!("Couldn't bind: {e:?}");
        return
    }
};
let addr = socket.local_addr().expect("Couldn't get local address");

Implementations

impl SocketAddr

pub fn from_pathname<P>(path: P) -> Result<SocketAddr>where P: AsRef<Path>,

使用 AF_UNIX 系列和提供的路径创建一个 SockAddr。

Errors

如果路径长于 SUN_LEN 或包含 NULL 字节，则返回错误。

Examples

use std::os::unix::net::SocketAddr;
use std::path::Path;

let address = SocketAddr::from_pathname("/path/to/socket")?;
assert_eq!(address.as_pathname(), Some(Path::new("/path/to/socket")));

使用 NULL 字节创建 SocketAddr 会导致错误。

use std::os::unix::net::SocketAddr;

assert!(SocketAddr::from_pathname("/path/with/\0/bytes").is_err());

pub fn is_unnamed(&self) -> bool

如果地址未命名，则返回 true。

Examples

命名地址：

use std::os::unix::net::UnixListener;

fn main() -> std::io::Result<()> {
    let socket = UnixListener::bind("/tmp/sock")?;
    let addr = socket.local_addr().expect("Couldn't get local address");
    assert_eq!(addr.is_unnamed(), false);
    Ok(())
}

一个未命名的地址：

use std::os::unix::net::UnixDatagram;

fn main() -> std::io::Result<()> {
    let socket = UnixDatagram::unbound()?;
    let addr = socket.local_addr().expect("Couldn't get local address");
    assert_eq!(addr.is_unnamed(), true);
    Ok(())
}

pub fn as_pathname(&self) -> Option<&Path>

如果它是 pathname 地址，则返回该地址的内容。

Examples

带有路径名：

use std::os::unix::net::UnixListener;
use std::path::Path;

fn main() -> std::io::Result<()> {
    let socket = UnixListener::bind("/tmp/sock")?;
    let addr = socket.local_addr().expect("Couldn't get local address");
    assert_eq!(addr.as_pathname(), Some(Path::new("/tmp/sock")));
    Ok(())
}

没有路径名：

use std::os::unix::net::UnixDatagram;

fn main() -> std::io::Result<()> {
    let socket = UnixDatagram::unbound()?;
    let addr = socket.local_addr().expect("Couldn't get local address");
    assert_eq!(addr.as_pathname(), None);
    Ok(())
}

Trait Implementations

impl Clone for SocketAddr

fn clone(&self) -> SocketAddr

返回值的副本。

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

从 source 执行复制分配。

impl Debug for SocketAddr

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

使用给定的格式化程序格式化该值。

impl SocketAddrExt for SocketAddr

Available on Android or Linux only.

fn as_abstract_name(&self) -> Option<&[u8]>

Available on Linux and (Linux or Android) only.

如果该地址位于抽象命名空间中，则返回该地址的内容。

fn from_abstract_name<N>(name: N) -> Result<Self>where N: AsRef<[u8]>,

Available on Linux and (Linux or Android) only.

在抽象命名空间中创建一个 Unix 套接字地址。