Improve the rtc::Buffer docs

Bug: none
Notry: true
Change-Id: Ie18d2c30617a168eb7cf8b1497e924eeb5083892
Reviewed-on: https://webrtc-review.googlesource.com/25822
Commit-Queue: Karl Wiberg <kwiberg@webrtc.org>
Reviewed-by: Henrik Lundin <henrik.lundin@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#20882}
This commit is contained in:
Karl Wiberg
2017-11-24 13:26:32 +01:00
committed by Commit Bot
parent a319931f3c
commit 09819ec373

View File

@ -214,13 +214,15 @@ class BufferT {
SetData(w.data(), w.size());
}
// Replace the data in the buffer with at most |max_elements| of data, using
// Replaces the data in the buffer with at most |max_elements| of data, using
// the function |setter|, which should have the following signature:
//
// size_t setter(ArrayView<U> view)
// |setter| is given an appropriately typed ArrayView of the area in which to
// write the data (i.e. starting at the beginning of the buffer) and should
// return the number of elements actually written. This number must be <=
// |max_elements|.
//
// |setter| is given an appropriately typed ArrayView of length exactly
// |max_elements| that describes the area where it should write the data; it
// should return the number of elements actually written. (If it doesn't fill
// the whole ArrayView, it should leave the unused space at the end.)
template <typename U = T,
typename F,
typename std::enable_if<
@ -268,13 +270,15 @@ class BufferT {
AppendData(&item, 1);
}
// Append at most |max_elements| to the end of the buffer, using the function
// Appends at most |max_elements| to the end of the buffer, using the function
// |setter|, which should have the following signature:
//
// size_t setter(ArrayView<U> view)
// |setter| is given an appropriately typed ArrayView of the area in which to
// write the data (i.e. starting at the former end of the buffer) and should
// return the number of elements actually written. This number must be <=
// |max_elements|.
//
// |setter| is given an appropriately typed ArrayView of length exactly
// |max_elements| that describes the area where it should write the data; it
// should return the number of elements actually written. (If it doesn't fill
// the whole ArrayView, it should leave the unused space at the end.)
template <typename U = T,
typename F,
typename std::enable_if<