diff options
author | Robert Griesemer <gri@golang.org> | 2022-11-21 16:36:14 -0800 |
---|---|---|
committer | Gopher Robot <gobot@golang.org> | 2022-11-23 00:25:09 +0000 |
commit | 72fdecafc0c1863f7540bd827a387e7e56836187 (patch) | |
tree | 3bf599daed210edfb07c76c1277703e712610c72 /doc/go_spec.html | |
parent | 753ad5e1d59db9073abba07627723fa3267a52fd (diff) | |
download | go-72fdecafc0c1863f7540bd827a387e7e56836187.tar.gz go-72fdecafc0c1863f7540bd827a387e7e56836187.zip |
spec: add a link to Allocation section in section on append built-in
If needed, the built-in function append allocates a new underlying
array. While we (probably) don't want to specify exactly how much
is allocated (the prose is deliberately vague), if there's more
space allocated than needed (cap > len after allocation), that
extra space is zeroed. Use an explicit link to the section on
Allocation which explicitly states that newly allocated memory
is zeroed.
Fixes #56684.
Change-Id: I9805d37c263b87860ea703ad143f738a0846247e
Reviewed-on: https://go-review.googlesource.com/c/go/+/452619
Reviewed-by: Ian Lance Taylor <iant@google.com>
Run-TryBot: Robert Griesemer <gri@google.com>
Reviewed-by: Robert Griesemer <gri@google.com>
Auto-Submit: Robert Griesemer <gri@google.com>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Joseph Tsai <joetsai@digital-static.net>
Reviewed-by: Matthew Dempsky <mdempsky@google.com>
Diffstat (limited to 'doc/go_spec.html')
-rw-r--r-- | doc/go_spec.html | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/doc/go_spec.html b/doc/go_spec.html index 630012ded8..967bfc4b5c 100644 --- a/doc/go_spec.html +++ b/doc/go_spec.html @@ -7256,7 +7256,7 @@ append(s S, x ...E) S // core type of S is []E <p> If the capacity of <code>s</code> is not large enough to fit the additional -values, <code>append</code> allocates a new, sufficiently large underlying +values, <code>append</code> <a href="#Allocation">allocates</a> a new, sufficiently large underlying array that fits both the existing slice elements and the additional values. Otherwise, <code>append</code> re-uses the underlying array. </p> |