Skip to content

Commit 0f3becf

Browse files
doc/go1.18: list new net/netip and net functions and methods
For #46518 For #47694 Change-Id: I4848556674baf85ceec350645d9eddcd83f1b2e0 Reviewed-on: https://go-review.googlesource.com/c/go/+/373834 Trust: Ian Lance Taylor <[email protected]> Trust: Brad Fitzpatrick <[email protected]> Reviewed-by: Brad Fitzpatrick <[email protected]>
1 parent d7b035f commit 0f3becf

File tree

1 file changed

+32
-2
lines changed

1 file changed

+32
-2
lines changed

doc/go1.18.html

Lines changed: 32 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -457,16 +457,46 @@ <h3 id="netip">New <code>net/netip</code> package</h3>
457457
<a href="/pkg/net/netip/#Prefix"><code>Prefix</code></a>, representing
458458
a network CIDR prefix.
459459
</p>
460+
<p>
461+
The package also defines several functions to create and examine
462+
these new types:
463+
<a href="/pkg/net/netip#AddrFrom4"><code>AddrFrom4</code></a>,
464+
<a href="/pkg/net/netip#AddrFrom16"><code>AddrFrom16</code></a>,
465+
<a href="/pkg/net/netip#AddrFromSlice"><code>AddrFromSlice</code></a>,
466+
<a href="/pkg/net/netip#AddrPortFrom"><code>AddrPortFrom</code></a>,
467+
<a href="/pkg/net/netip#IPv4Unspecified"><code>IPv4Unspecified</code></a>,
468+
<a href="/pkg/net/netip#IPv6LinkLocalAllNodes"><code>IPv6LinkLocalAllNodes</code></a>,
469+
<a href="/pkg/net/netip#IPv6Unspecified"><code>IPv6Unspecified</code></a>,
470+
<a href="/pkg/net/netip#MustParseAddr"><code>MustParseAddr</code></a>,
471+
<a href="/pkg/net/netip#MustParseAddrPort"><code>MustParseAddrPort</code></a>,
472+
<a href="/pkg/net/netip#MustParsePrefix"><code>MustParsePrefix</code></a>,
473+
<a href="/pkg/net/netip#ParseAddr"><code>ParseAddr</code></a>,
474+
<a href="/pkg/net/netip#ParseAddrPort"><code>ParseAddrPort</code></a>,
475+
<a href="/pkg/net/netip#ParsePrefix"><code>ParsePrefix</code></a>,
476+
<a href="/pkg/net/netip#PrefixFrom"><code>PrefixFrom</code></a>.
477+
</p>
460478
<p>
461479
The <a href="/pkg/net/"><code>net</code></a> package includes new
462480
methods that parallel existing methods, but
463481
return <code>netip.AddrPort</code> instead of the
464482
heavier-weight <a href="/pkg/net/#IP"><code>net.IP</code></a> or
465-
<a href="/pkg/net/#UDPAddr"><code>*net.UDPAddr</code></a> types.
483+
<a href="/pkg/net/#UDPAddr"><code>*net.UDPAddr</code></a> types:
484+
<a href="/pkg/net/#Resolver.LookupNetIP"><code>Resolver.LookupNetIP</code></a>,
485+
<a href="/pkg/net/#UDPConn.ReadFromUDPAddrPort"><code>UDPConn.ReadFromUDPAddrPort</code></a>,
486+
<a href="/pkg/net/#UDPConn.ReadMsgUDPAddrPort"><code>UDPConn.ReadMsgUDPAddrPort</code></a>,
487+
<a href="/pkg/net/#UDPConn.WriteToUDPAddrPort"><code>UDPConn.WriteToUDPAddrPort</code></a>,
488+
<a href="/pkg/net/#UDPConn.WriteMsgUDPAddrPort"><code>UDPConn.WriteMsgUDPAddrPort</code></a>.
489+
The new <code>UDPConn</code> methods support allocation-free I/O.
490+
</p>
491+
<p>
466492
The <code>net</code> package also now includes functions and methods
467493
to convert between the existing
468494
<a href="/pkg/net/#TCPAddr"><code>TCPAddr</code></a>/<a href="/pkg/net/#UDPAddr"><code>UDPAddr</code></a>
469-
types and <code>netip.AddrPort</code>.
495+
types and <code>netip.AddrPort</code>:
496+
<a href="/pkg/net/#TCPAddrFromAddrPort"><code>TCPAddrFromAddrPort</code></a>,
497+
<a href="/pkg/net/#UDPAddrFromAddrPort"><code>UDPAddrFromAddrPort</code></a>,
498+
<a href="/pkg/net/#TCPAddr.AddrPort"><code>TCPAddr.AddrPort</code></a>,
499+
<a href="/pkg/net/#UDPAddr.AddrPort"><code>UDPAddr.AddrPort</code></a>.
470500
</p>
471501

472502
<h3 id="minor_library_changes">Minor changes to the library</h3>

0 commit comments

Comments
 (0)