Copy edit ArrayView.h

Copy edit, mostly for active voice and agreement.
pull/5392/head
Amanda Butler 2017-10-30 11:03:15 -05:00 committed by GitHub
parent 3c3592a9d3
commit 2038e72782
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 12 deletions

View File

@ -37,15 +37,15 @@ namespace ble {
* Immutable view to an array. * Immutable view to an array.
* *
* Array views encapsulate the pointer to an array and its size into a single * Array views encapsulate the pointer to an array and its size into a single
* object however it does not manage the lifetime of the array viewed. * object; however, it does not manage the lifetime of the array viewed.
* Instances of ArrayView can be used to replace the traditional pair of pointer * You can use instances of ArrayView to replace the traditional pair of pointer
* and size arguments in function calls. * and size arguments in function calls.
* *
* The size member function can be used to query the number of elements present * You can use the size member function to query the number of elements present
* in the array and overloads of the subscript operator allow code using * in the array, and overloads of the subscript operator allow code using
* this object to access to the content of the array viewed. * this object to access to the content of the array viewed.
* *
* @note ArrayView instances can be created easily with the help of the function * @note You can create ArrayView instances with the help of the function
* template make_ArrayView() and make_const_ArrayView(). * template make_ArrayView() and make_const_ArrayView().
* *
* @tparam T type of objects held by the array. * @tparam T type of objects held by the array.
@ -56,7 +56,7 @@ struct ArrayView {
/** /**
* Construct a view to an empty array. * Construct a view to an empty array.
* *
* @post a call to size() will return 0 and data() will return NULL. * @post a call to size() will return 0, and data() will return NULL.
*/ */
ArrayView() : _array(0), _size(0) { } ArrayView() : _array(0), _size(0) { }
@ -79,7 +79,7 @@ struct ArrayView {
* *
* @tparam Size Number of elements of T presents in the array. * @tparam Size Number of elements of T presents in the array.
* *
* @post a call to size() will return Size and data() will return * @post a call to size() will return Size, and data() will return
* a pointer to elements. * a pointer to elements.
*/ */
template<size_t Size> template<size_t Size>
@ -172,7 +172,7 @@ struct ArrayView {
* @param lhs Left hand side of the binary operation. * @param lhs Left hand side of the binary operation.
* @param rhs Right hand side of the binary operation. * @param rhs Right hand side of the binary operation.
* *
* @return True if arrays in input does not have the same size or the same * @return True if arrays in input do not have the same size or the same
* content and false otherwise. * content and false otherwise.
*/ */
friend bool operator!=(const ArrayView& lhs, const ArrayView& rhs) friend bool operator!=(const ArrayView& lhs, const ArrayView& rhs)
@ -196,7 +196,7 @@ private:
* *
* @return The ArrayView to elements. * @return The ArrayView to elements.
* *
* @note This helper avoid the typing of template parameter when ArrayView are * @note This helper avoids the typing of template parameter when ArrayView is
* created 'inline'. * created 'inline'.
*/ */
template<typename T, size_t Size> template<typename T, size_t Size>
@ -215,7 +215,7 @@ ArrayView<T> make_ArrayView(T (&elements)[Size])
* *
* @return The ArrayView to array_ptr with a size of array_size. * @return The ArrayView to array_ptr with a size of array_size.
* *
* @note This helper avoid the typing of template parameter when ArrayView are * @note This helper avoids the typing of template parameter when ArrayView is
* created 'inline'. * created 'inline'.
*/ */
template<typename T> template<typename T>
@ -233,7 +233,7 @@ ArrayView<T> make_ArrayView(T* array_ptr, size_t array_size)
* @param elements The array viewed. * @param elements The array viewed.
* @return The ArrayView to elements. * @return The ArrayView to elements.
* *
* @note This helper avoid the typing of template parameter when ArrayView are * @note This helper avoids the typing of template parameter when ArrayView is
* created 'inline'. * created 'inline'.
*/ */
template<typename T, size_t Size> template<typename T, size_t Size>
@ -252,7 +252,7 @@ ArrayView<const T> make_const_ArrayView(T (&elements)[Size])
* *
* @return The ArrayView to array_ptr with a size of array_size. * @return The ArrayView to array_ptr with a size of array_size.
* *
* @note This helper avoid the typing of template parameter when ArrayView are * @note This helper avoids the typing of template parameter when ArrayView is
* created 'inline'. * created 'inline'.
*/ */
template<typename T> template<typename T>