Skip to content

Commit

Permalink
spec: minimal documention of unsafe.Pointer conversions
Browse files Browse the repository at this point in the history
Per suggestion from rsc as a result of the dicussion of
(abandoned) CL 153110044.

Fixes #7192.

LGTM=r, rsc, iant
R=r, rsc, iant, ken
CC=golang-codereviews
https://golang.org/cl/163050043
  • Loading branch information
griesemer committed Oct 23, 2014
1 parent b511230 commit 5361b74
Showing 1 changed file with 6 additions and 5 deletions.
11 changes: 6 additions & 5 deletions doc/go_spec.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<!--{
"Title": "The Go Programming Language Specification",
"Subtitle": "Version of October 16, 2014",
"Subtitle": "Version of October 23, 2014",
"Path": "/ref/spec"
}-->

Expand Down Expand Up @@ -6207,8 +6207,8 @@ <h3 id="Package_unsafe">Package <code>unsafe</code></h3>
The built-in package <code>unsafe</code>, known to the compiler,
provides facilities for low-level programming including operations
that violate the type system. A package using <code>unsafe</code>
must be vetted manually for type safety. The package provides the
following interface:
must be vetted manually for type safety and may not be portable.
The package provides the following interface:
</p>

<pre class="grammar">
Expand All @@ -6223,10 +6223,11 @@ <h3 id="Package_unsafe">Package <code>unsafe</code></h3>
</pre>

<p>
Any pointer or value of <a href="#Types">underlying type</a> <code>uintptr</code> can be converted to
a <code>Pointer</code> type and vice versa.
A <code>Pointer</code> is a <a href="#Pointer_types">pointer type</a> but a <code>Pointer</code>
value may not be <a href="#Address_operators">dereferenced</a>.
Any pointer or value of <a href="#Types">underlying type</a> <code>uintptr</code> can be converted to
a <code>Pointer</code> type and vice versa.
The effect of converting between <code>Pointer</code> and <code>uintptr</code> is implementation-defined.
</p>

<pre>
Expand Down

0 comments on commit 5361b74

Please sign in to comment.