mirror
/
go
mirror of https://github.com/golang/go.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

doc/go1.21: mention changes to the reflect package 

Added Value.Clear, deprecated SliceHeader and StringHeader.

For #55002
For #56906

Change-Id: Ib7497aff830d56fad90c31ec28596e71a448e9ce
Reviewed-on: https://go-review.googlesource.com/c/go/+/498757
Reviewed-by: Ian Lance Taylor <iant@google.com>
Auto-Submit: Ian Lance Taylor <iant@google.com>
Run-TryBot: Ian Lance Taylor <iant@google.com>
Reviewed-by: Eli Bendersky <eliben@google.com>
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Gopher Robot <gobot@golang.org>
This commit is contained in:
Ian Lance Taylor 2023-05-26 14:25:45 -07:00 committed by Gopher Robot
parent dcb27e8a66
commit c2bb350d80
1 changed files with 13 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
doc/go1.21.html
View File

@ -652,15 +652,21 @@ Do not send CLs removing the interior tags from such phrases.
</p>
<p><!-- https://go.dev/issue/55002 -->
TODO: <a href="https://go.dev/issue/55002">https://go.dev/issue/55002</a>: add Value.Clear
The new <a href="/pkg/reflect/#Value"><code>Value</code></a>
method <a href="/pkg/reflect/#Value.Clear"><code>Value.Clear</code></a>
clears the contents of a map or zeros the contents of a slice.
This corresponds to the new <code>clear</code> built-in
<a href="#language">added to the language</a>.
</p>
<p><!-- https://go.dev/issue/56906 -->
TODO: <a href="https://go.dev/issue/56906">https://go.dev/issue/56906</a>: deprecate SliceHeader and StringHeader
</p>
<p><!-- CL 452762 -->
TODO: <a href="https://go.dev/cl/452762">https://go.dev/cl/452762</a>: reflect: deprecate SliceHeader and StringHeader; modified api/next/56906.txt
<p><!-- https://go.dev/issue/56906, CL 452762 -->
The <a href="/pkg/reflect/#SliceHeader"><code>SliceHeader</code></a>
and <a href="/pkg/reflect/#StringHeader"><code>StringHeader</code></a>
types are now deprecated. In new code
prefer <a href="/pkg/unsafe/#Slice"><code>unsafe.Slice</code></a>,
<a href="/pkg/unsafe/#SliceData"><code>unsafe.SliceData</code></a>,
<a href="/pkg/unsafe/#String"><code>unsafe.String</code></a>,
or <a href="/pkg/unsafe/#StringData"><code>unsafe.StringData</code></a>.
</p>
</dd>
</dl><!-- reflect -->