From: Cuong Manh Le <cuong.manhle.vn@gmail.com>
Date: Mon, 18 Oct 2021 16:54:02 +0000 (+0700)
Subject: doc: document new reflect.UnsafePointer function
X-Git-Tag: go1.18beta1~796
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=6c200017bf0ad9987453d5c265e5a3063ad72dc5;p=gostls13.git

doc: document new reflect.UnsafePointer function

Updates #40592

Change-Id: If66629e47ca9859128ee3ad8fb584e022d7a6982
Reviewed-on: https://go-review.googlesource.com/c/go/+/356255
Trust: Cuong Manh Le <cuong.manhle.vn@gmail.com>
Run-TryBot: Cuong Manh Le <cuong.manhle.vn@gmail.com>
Reviewed-by: Keith Randall <khr@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
---

diff --git a/doc/go1.18.html b/doc/go1.18.html
index d95e55e1ad..087a06c280 100644
--- a/doc/go1.18.html
+++ b/doc/go1.18.html
@@ -175,6 +175,16 @@ Do not send CLs removing the interior tags from such phrases.
       do fewer allocations.
     </p>
   </dd>
+  <dd>
+    <p><!-- CL 350691 -->
+      The new
+      <a href="/pkg/reflect/#Value.UnsafePointer"><code>Value.UnsafePointer</code></a>
+      method returns the Value's value as an <a href="/pkg/unsafe/#Pointer"><code>unsafe.Pointer</code></a>.
+      This allows callers to migrate from <a href="/pkg/reflect/#Value.UnsafeAddr"><code>Value.UnsafeAddr</code></a>
+      and <a href="/pkg/reflect/#Value.Pointer"><code>Value.Pointer</code></a>
+      to eliminate the need to perform uintptr to unsafe.Pointer conversions at the callsite (as unsafe.Pointer rules require).
+    </p>
+  </dd>
 </dl><!-- reflect -->
 
 <dl id="syscall"><dt><a href="/pkg/syscall/">syscall</a></dt>