forward_list.h: Fix comments.

2012-03-14  Paolo Carlini  <paolo.carlini@oracle.com>

	* include/bits/forward_list.h: Fix comments.

From-SVN: r185382
This commit is contained in:
Paolo Carlini 2012-03-14 13:19:43 +00:00 committed by Paolo Carlini
parent 7501ca28e3
commit 43094d442e
2 changed files with 27 additions and 21 deletions

View File

@ -1,3 +1,7 @@
2012-03-14 Paolo Carlini <paolo.carlini@oracle.com>
* include/bits/forward_list.h: Fix comments.
2012-03-13 Terry Guo <terry.guo@arm.com>
* testsuite/Makefile.in (TEST_GCC_EXEC_PREFIX): New.

View File

@ -536,7 +536,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
* @param __al An allocator object.
*
* Create a %forward_list consisting of copies of the elements
* in the initializer_list @a __il. This is linear in __il.size().
* in the initializer_list @a __il. This is linear in the number
* of elements of __il.
*/
forward_list(std::initializer_list<_Tp> __il,
const _Alloc& __al = _Alloc())
@ -585,7 +586,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
*
* Replace the contents of the %forward_list with copies of the
* elements in the initializer_list @a __il. This is linear in
* __il.size().
* the number of elements of __il.
*/
forward_list&
operator=(std::initializer_list<_Tp> __il)
@ -603,8 +604,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
* in the range [@a __first,@a __last).
*
* Note that the assignment completely changes the %forward_list and
* that the resulting %forward_list's size is the same as the number
* of elements assigned. Old data may be lost.
* that the number of elements of the resulting %forward_list's is the
* same as the number of elements assigned. Old data is lost.
*/
template<typename _InputIterator,
typename = std::_RequireInputIter<_InputIterator>>
@ -620,10 +621,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
* @param __n Number of elements to be assigned.
* @param __val Value to be assigned.
*
* This function fills a %forward_list with @a __n copies of the given
* value. Note that the assignment completely changes the
* %forward_list and that the resulting %forward_list's size is the
* same as the number of elements assigned. Old data may be lost.
* This function fills a %forward_list with @a __n copies of the
* given value. Note that the assignment completely changes the
* %forward_list, and that the resulting %forward_list has __n
* elements. Old data is lost.
*/
void
assign(size_type __n, const _Tp& __val)
@ -742,7 +743,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
{ return this->_M_impl._M_head._M_next == 0; }
/**
* Returns the largest possible size of %forward_list.
* Returns the largest possible number of elements of %forward_list.
*/
size_type
max_size() const noexcept
@ -996,9 +997,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
*
* This function will %resize the %forward_list to the specified
* number of elements. If the number is smaller than the
* %forward_list's current size the %forward_list is truncated,
* otherwise the %forward_list is extended and the new elements
* are default constructed.
* %forward_list's current number of elements the %forward_list
* is truncated, otherwise the %forward_list is extended and the
* new elements are default constructed.
*/
void
resize(size_type __sz);
@ -1011,9 +1012,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
*
* This function will %resize the %forward_list to the specified
* number of elements. If the number is smaller than the
* %forward_list's current size the %forward_list is truncated,
* otherwise the %forward_list is extended and new elements are
* populated with given data.
* %forward_list's current number of elements the %forward_list
* is truncated, otherwise the %forward_list is extended and new
* elements are populated with given data.
*/
void
resize(size_type __sz, const value_type& __val);
@ -1233,11 +1234,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
* @brief Forward list equality comparison.
* @param __lx A %forward_list
* @param __ly A %forward_list of the same type as @a __lx.
* @return True iff the size and elements of the forward lists are equal.
* @return True iff the elements of the forward lists are equal.
*
* This is an equivalence relation. It is linear in the size of the
* forward lists. Deques are considered equivalent if corresponding
* elements compare equal.
* This is an equivalence relation. It is linear in the number of
* elements of the forward lists. Deques are considered equivalent
* if corresponding elements compare equal.
*/
template<typename _Tp, typename _Alloc>
bool
@ -1250,8 +1251,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
* @param __ly A %forward_list of the same type as @a __lx.
* @return True iff @a __lx is lexicographically less than @a __ly.
*
* This is a total ordering relation. It is linear in the size of the
* forward lists. The elements must be comparable with @c <.
* This is a total ordering relation. It is linear in the number of
* elements of the forward lists. The elements must be comparable
* with @c <.
*
* See std::lexicographical_compare() for how the determination is made.
*/