10 lines
13 KiB
HTML
10 lines
13 KiB
HTML
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Converts or resolves without blocking to one or more `SocketAddr` values."><title>ToSocketAddrs in tokio::net - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../static.files/rustdoc-ca0dd0c4.css"><meta name="rustdoc-vars" data-root-path="../../" data-static-root-path="../../static.files/" data-current-crate="tokio" data-themes="" data-resource-suffix="" data-rustdoc-version="1.93.1 (01f6ddf75 2026-02-11) (Arch Linux rust 1:1.93.1-1)" data-channel="1.93.1" data-search-js="search-9e2438ea.js" data-stringdex-js="stringdex-a3946164.js" data-settings-js="settings-c38705f0.js" ><script src="../../static.files/storage-e2aeef58.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../static.files/main-a410ff4d.js"></script><noscript><link rel="stylesheet" href="../../static.files/noscript-263c88ec.css"></noscript><link rel="alternate icon" type="image/png" href="../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../static.files/favicon-044be391.svg"></head><body class="rustdoc trait"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">ToSocketAddrs</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../tokio/index.html">tokio</a><span class="version">1.49.0</span></h2></div><div class="sidebar-elems"><section id="rustdoc-toc"><h2 class="location"><a href="#">ToSocket<wbr>Addrs</a></h2><h3><a href="#">Sections</a></h3><ul class="block top-toc"><li><a href="#dns" title="DNS">DNS</a></li><li><a href="#calling" title="Calling">Calling</a></li></ul><h3><a href="#foreign-impls">Implementations on Foreign Types</a></h3><ul class="block"><li><a href="#impl-ToSocketAddrs-for-%26T" title="&T">&T</a></li><li><a href="#impl-ToSocketAddrs-for-%26%5BSocketAddr%5D" title="&[SocketAddr]">&[SocketAddr]</a></li><li><a href="#impl-ToSocketAddrs-for-(%26str,+u16)" title="(&str, u16)">(&str, u16)</a></li><li><a href="#impl-ToSocketAddrs-for-(IpAddr,+u16)" title="(IpAddr, u16)">(IpAddr, u16)</a></li><li><a href="#impl-ToSocketAddrs-for-(Ipv4Addr,+u16)" title="(Ipv4Addr, u16)">(Ipv4Addr, u16)</a></li><li><a href="#impl-ToSocketAddrs-for-(Ipv6Addr,+u16)" title="(Ipv6Addr, u16)">(Ipv6Addr, u16)</a></li><li><a href="#impl-ToSocketAddrs-for-(String,+u16)" title="(String, u16)">(String, u16)</a></li><li><a href="#impl-ToSocketAddrs-for-SocketAddr" title="SocketAddr">SocketAddr</a></li><li><a href="#impl-ToSocketAddrs-for-SocketAddrV4" title="SocketAddrV4">SocketAddrV4</a></li><li><a href="#impl-ToSocketAddrs-for-SocketAddrV6" title="SocketAddrV6">SocketAddrV6</a></li><li><a href="#impl-ToSocketAddrs-for-String" title="String">String</a></li><li><a href="#impl-ToSocketAddrs-for-str" title="str">str</a></li></ul><h3><a href="#implementors">Implementors</a></h3></section><div id="rustdoc-modnav"><h2><a href="index.html">In tokio::<wbr>net</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../index.html">tokio</a>::<wbr><a href="index.html">net</a></div><h1>Trait <span class="trait">ToSocket<wbr>Addrs</span> <button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../src/tokio/net/addr.rs.html#19">Source</a> </span></div><pre class="rust item-decl"><code>pub trait ToSocketAddrs: ToSocketAddrsPriv { }</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Converts or resolves without blocking to one or more <code>SocketAddr</code> values.</p>
|
|
<h2 id="dns"><a class="doc-anchor" href="#dns">§</a>DNS</h2>
|
|
<p>Implementations of <code>ToSocketAddrs</code> for string types require a DNS lookup.</p>
|
|
<h2 id="calling"><a class="doc-anchor" href="#calling">§</a>Calling</h2>
|
|
<p>Currently, this trait is only used as an argument to Tokio functions that
|
|
need to reference a target socket address. To perform a <code>SocketAddr</code>
|
|
conversion directly, use <a href="fn.lookup_host.html" title="fn tokio::net::lookup_host"><code>lookup_host()</code></a>.</p>
|
|
<p>This trait is sealed and is intended to be opaque. The details of the trait
|
|
will change. Stabilization is pending enhancements to the Rust language.</p>
|
|
</div></details><h2 id="foreign-impls" class="section-header">Implementations on Foreign Types<a href="#foreign-impls" class="anchor">§</a></h2><section id="impl-ToSocketAddrs-for-%26%5BSocketAddr%5D" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#132">Source</a><a href="#impl-ToSocketAddrs-for-%26%5BSocketAddr%5D" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for &[<a class="enum" href="https://doc.rust-lang.org/1.93.1/core/net/socket_addr/enum.SocketAddr.html" title="enum core::net::socket_addr::SocketAddr">SocketAddr</a>]</h3></section><section id="impl-ToSocketAddrs-for-(%26str,+u16)" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#190">Source</a><a href="#impl-ToSocketAddrs-for-(%26str,+u16)" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for (&<a class="primitive" href="https://doc.rust-lang.org/1.93.1/std/primitive.str.html">str</a>, <a class="primitive" href="https://doc.rust-lang.org/1.93.1/std/primitive.u16.html">u16</a>)</h3><span class="item-info"><div class="stab portability">Available on <strong>crate feature <code>net</code></strong> only.</div></span></section><section id="impl-ToSocketAddrs-for-(IpAddr,+u16)" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#90">Source</a><a href="#impl-ToSocketAddrs-for-(IpAddr,+u16)" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for (<a class="enum" href="https://doc.rust-lang.org/1.93.1/core/net/ip_addr/enum.IpAddr.html" title="enum core::net::ip_addr::IpAddr">IpAddr</a>, <a class="primitive" href="https://doc.rust-lang.org/1.93.1/std/primitive.u16.html">u16</a>)</h3></section><section id="impl-ToSocketAddrs-for-(String,+u16)" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#227">Source</a><a href="#impl-ToSocketAddrs-for-(String,+u16)" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for (<a class="struct" href="https://doc.rust-lang.org/1.93.1/alloc/string/struct.String.html" title="struct alloc::string::String">String</a>, <a class="primitive" href="https://doc.rust-lang.org/1.93.1/std/primitive.u16.html">u16</a>)</h3><span class="item-info"><div class="stab portability">Available on <strong>crate feature <code>net</code></strong> only.</div></span></section><section id="impl-ToSocketAddrs-for-(Ipv4Addr,+u16)" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#104">Source</a><a href="#impl-ToSocketAddrs-for-(Ipv4Addr,+u16)" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for (<a class="struct" href="https://doc.rust-lang.org/1.93.1/core/net/ip_addr/struct.Ipv4Addr.html" title="struct core::net::ip_addr::Ipv4Addr">Ipv4Addr</a>, <a class="primitive" href="https://doc.rust-lang.org/1.93.1/std/primitive.u16.html">u16</a>)</h3></section><section id="impl-ToSocketAddrs-for-(Ipv6Addr,+u16)" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#118">Source</a><a href="#impl-ToSocketAddrs-for-(Ipv6Addr,+u16)" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for (<a class="struct" href="https://doc.rust-lang.org/1.93.1/core/net/ip_addr/struct.Ipv6Addr.html" title="struct core::net::ip_addr::Ipv6Addr">Ipv6Addr</a>, <a class="primitive" href="https://doc.rust-lang.org/1.93.1/std/primitive.u16.html">u16</a>)</h3></section><section id="impl-ToSocketAddrs-for-SocketAddr" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#50">Source</a><a href="#impl-ToSocketAddrs-for-SocketAddr" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for <a class="enum" href="https://doc.rust-lang.org/1.93.1/core/net/socket_addr/enum.SocketAddr.html" title="enum core::net::socket_addr::SocketAddr">SocketAddr</a></h3></section><section id="impl-ToSocketAddrs-for-str" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#162">Source</a><a href="#impl-ToSocketAddrs-for-str" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for <a class="primitive" href="https://doc.rust-lang.org/1.93.1/std/primitive.str.html">str</a></h3><span class="item-info"><div class="stab portability">Available on <strong>crate feature <code>net</code></strong> only.</div></span></section><section id="impl-ToSocketAddrs-for-String" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#240">Source</a><a href="#impl-ToSocketAddrs-for-String" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for <a class="struct" href="https://doc.rust-lang.org/1.93.1/alloc/string/struct.String.html" title="struct alloc::string::String">String</a></h3><span class="item-info"><div class="stab portability">Available on <strong>crate feature <code>net</code></strong> only.</div></span></section><section id="impl-ToSocketAddrs-for-SocketAddrV4" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#64">Source</a><a href="#impl-ToSocketAddrs-for-SocketAddrV4" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for <a class="struct" href="https://doc.rust-lang.org/1.93.1/core/net/socket_addr/struct.SocketAddrV4.html" title="struct core::net::socket_addr::SocketAddrV4">SocketAddrV4</a></h3></section><section id="impl-ToSocketAddrs-for-SocketAddrV6" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#77">Source</a><a href="#impl-ToSocketAddrs-for-SocketAddrV6" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for <a class="struct" href="https://doc.rust-lang.org/1.93.1/core/net/socket_addr/struct.SocketAddrV6.html" title="struct core::net::socket_addr::SocketAddrV6">SocketAddrV6</a></h3></section><section id="impl-ToSocketAddrs-for-%26T" class="impl"><a class="src rightside" href="../../src/tokio/net/addr.rs.html#34">Source</a><a href="#impl-ToSocketAddrs-for-%26T" class="anchor">§</a><h3 class="code-header">impl<T: <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> + ?<a class="trait" href="https://doc.rust-lang.org/1.93.1/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>> <a class="trait" href="trait.ToSocketAddrs.html" title="trait tokio::net::ToSocketAddrs">ToSocketAddrs</a> for <a class="primitive" href="https://doc.rust-lang.org/1.93.1/std/primitive.reference.html">&T</a></h3></section><h2 id="implementors" class="section-header">Implementors<a href="#implementors" class="anchor">§</a></h2><div id="implementors-list"></div><script src="../../trait.impl/tokio/net/addr/trait.ToSocketAddrs.js" data-ignore-extern-crates="core,std,alloc" async></script></section></div></main></body></html> |