tree f950758378d269edf93835ade66aa39b27fc2e1f
parent 764c751ae51af5c76cdd4c81f828a977a4feb5c7
author Cristian Staretu <unclejacksons@gmail.com> 1427903991 +0300
committer Rob Pike <r@golang.org> 1428105002 +0000

bytes: export Cap method for buffer

Obtaining the actual size of the underlying storage of the buffer can
be very useful in various scenarios. Long running programs which write
and read large amounts of data to buffers might have to recycle
buffers in order to avoid holding onto potentially huge buffers.

For example, a piece of code which buffers a lot of data in a buffer
might need to release the big buffer and start again with a smaller
buffer after it finished processing the huge amount of data.

In cases where pools of bytes.Buffer are used, being able to check the
size of the allocated data can be very useful.

Instead of forking bytes.Buffer or writing new code, we can export the
Cap() method.

Change-Id: I79d4f0a3cff53b9419d82c8122964761e9e38566
Reviewed-on: https://go-review.googlesource.com/8342
Reviewed-by: Rob Pike <r@golang.org>