git
/
gcc
mirror of git://gcc.gnu.org/git/gcc.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

user.cfg.in (PDF_HYPERLINKS): To NO. 

2011-08-06  Benjamin Kosnik  <bkoz@redhat.com>

	* doc/doxygen/user.cfg.in (PDF_HYPERLINKS): To NO.

2011-08-06  Benjamin Kosnik  <bkoz@redhat.com>

	* doc/doxygen/user.cfg.in: Add scoped_allocator.

	* include/debug/safe_sequence.h: Fix doxygen markup.
	* include/debug/safe_unordered_base.h: Same.
	* include/debug/safe_local_iterator.tcc: Same.
	* include/debug/safe_unordered_container.h: Same.
	* include/std/valarray: Same.
	* include/std/iomanip: Same.
	* include/std/streambuf: Same.
	* include/std/bitset: Same.
	* include/std/fstream: Same.
	* include/std/functional: Same.
	* include/std/istream: Same.
	* include/std/ostream: Same.
	* include/std/scoped_allocator: Same.
	* include/std/sstream: Same.
	* include/parallel/multiway_merge.h: Same.
	* include/parallel/base.h: Same.
	* include/parallel/for_each_selectors.h: Same.
	* include/parallel/multiway_mergesort.h: Same.
	* include/parallel/search.h: Same.
	* include/parallel/partial_sum.h: Same.
	* include/parallel/queue.h: Same.
	* include/parallel/sort.h: Same.
	* include/parallel/random_number.h: Same.
	* include/ext/vstring.h: Same.
	* include/ext/algorithm: Same.
	* include/ext/pb_ds/assoc_container.h: Same.
	* include/ext/bitmap_allocator.h: Same.
	* include/ext/stdio_filebuf.h: Same.
	* include/ext/memory: Same.
	* include/ext/functional: Same.
	* include/bits/basic_ios.h: Same.
	* include/bits/stl_list.h: Same.
	* include/bits/stl_map.h: Same.
	* include/bits/stl_algobase.h: Same.
	* include/bits/stl_queue.h: Same.
	* include/bits/gslice.h: Same.
	* include/bits/locale_classes.h: Same.
	* include/bits/stl_set.h: Same.
	* include/bits/locale_facets.h: Same.
	* include/bits/stl_stack.h: Same.
	* include/bits/stl_heap.h: Same.
	* include/bits/forward_list.h: Same.
	* include/bits/stream_iterator.h: Same.
	* include/bits/basic_string.h: Same.
	* include/bits/stl_multimap.h: Same.
	* include/bits/stl_pair.h: Same.
	* include/bits/ios_base.h: Same.
	* include/bits/stl_numeric.h: Same.
	* include/bits/stl_vector.h: Same.
	* include/bits/stl_deque.h: Same.
	* include/bits/codecvt.h: Same.
	* include/bits/stl_multiset.h: Same.
	* include/bits/stl_uninitialized.h: Same.
	* include/bits/ptr_traits.h: Same.
	* include/bits/slice_array.h: Same.
	* include/bits/stl_iterator_base_funcs.h: Same.
	* include/bits/stl_algo.h: Same.
	* include/bits/stl_iterator.h: Same.
	* include/bits/stl_tempbuf.h: Same.
	* include/bits/regex.h: Same.
	* include/bits/range_access.h: Same.
	* include/bits/random.h: Same.
	* include/bits/alloc_traits.h: Same.
	* include/bits/regex_error.h: Same.
	* include/bits/locale_facets_nonio.h: Same.
	* include/bits/stl_relops.h: Same.
	* include/backward/auto_ptr.h: Same.
	* libsupc++/initializer_list: Same.

	* testsuite/23_containers/list/requirements/dr438/assign_neg.cc:
	Adjust line numbers.
	* testsuite/23_containers/list/requirements/dr438/insert_neg.cc: Same.
	* testsuite/23_containers/list/requirements/dr438/constructor_1_neg.cc:
	Same.
	* testsuite/23_containers/list/requirements/dr438/constructor_2_neg.cc:
	Same.

From-SVN: r177542
This commit is contained in:
Benjamin Kosnik 2011-08-07 07:27:06 +00:00 committed by Benjamin Kosnik
parent 77d2c8b34f
commit 93c66bc68a
74 changed files with 3786 additions and 3612 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

85
libstdc++-v3/ChangeLog
View File

@ -1,3 +1,88 @@
2011-08-06 Benjamin Kosnik <bkoz@redhat.com>
* doc/doxygen/user.cfg.in (PDF_HYPERLINKS): To NO.
2011-08-06 Benjamin Kosnik <bkoz@redhat.com>
* doc/doxygen/user.cfg.in: Add scoped_allocator.
* include/debug/safe_sequence.h: Fix doxygen markup.
* include/debug/safe_unordered_base.h: Same.
* include/debug/safe_local_iterator.tcc: Same.
* include/debug/safe_unordered_container.h: Same.
* include/std/valarray: Same.
* include/std/iomanip: Same.
* include/std/streambuf: Same.
* include/std/bitset: Same.
* include/std/fstream: Same.
* include/std/functional: Same.
* include/std/istream: Same.
* include/std/ostream: Same.
* include/std/scoped_allocator: Same.
* include/std/sstream: Same.
* include/parallel/multiway_merge.h: Same.
* include/parallel/base.h: Same.
* include/parallel/for_each_selectors.h: Same.
* include/parallel/multiway_mergesort.h: Same.
* include/parallel/search.h: Same.
* include/parallel/partial_sum.h: Same.
* include/parallel/queue.h: Same.
* include/parallel/sort.h: Same.
* include/parallel/random_number.h: Same.
* include/ext/vstring.h: Same.
* include/ext/algorithm: Same.
* include/ext/pb_ds/assoc_container.h: Same.
* include/ext/bitmap_allocator.h: Same.
* include/ext/stdio_filebuf.h: Same.
* include/ext/memory: Same.
* include/ext/functional: Same.
* include/bits/basic_ios.h: Same.
* include/bits/stl_list.h: Same.
* include/bits/stl_map.h: Same.
* include/bits/stl_algobase.h: Same.
* include/bits/stl_queue.h: Same.
* include/bits/gslice.h: Same.
* include/bits/locale_classes.h: Same.
* include/bits/stl_set.h: Same.
* include/bits/locale_facets.h: Same.
* include/bits/stl_stack.h: Same.
* include/bits/stl_heap.h: Same.
* include/bits/forward_list.h: Same.
* include/bits/stream_iterator.h: Same.
* include/bits/basic_string.h: Same.
* include/bits/stl_multimap.h: Same.
* include/bits/stl_pair.h: Same.
* include/bits/ios_base.h: Same.
* include/bits/stl_numeric.h: Same.
* include/bits/stl_vector.h: Same.
* include/bits/stl_deque.h: Same.
* include/bits/codecvt.h: Same.
* include/bits/stl_multiset.h: Same.
* include/bits/stl_uninitialized.h: Same.
* include/bits/ptr_traits.h: Same.
* include/bits/slice_array.h: Same.
* include/bits/stl_iterator_base_funcs.h: Same.
* include/bits/stl_algo.h: Same.
* include/bits/stl_iterator.h: Same.
* include/bits/stl_tempbuf.h: Same.
* include/bits/regex.h: Same.
* include/bits/range_access.h: Same.
* include/bits/random.h: Same.
* include/bits/alloc_traits.h: Same.
* include/bits/regex_error.h: Same.
* include/bits/locale_facets_nonio.h: Same.
* include/bits/stl_relops.h: Same.
* include/backward/auto_ptr.h: Same.
* libsupc++/initializer_list: Same.
* testsuite/23_containers/list/requirements/dr438/assign_neg.cc:
Adjust line numbers.
* testsuite/23_containers/list/requirements/dr438/insert_neg.cc: Same.
* testsuite/23_containers/list/requirements/dr438/constructor_1_neg.cc:
Same.
* testsuite/23_containers/list/requirements/dr438/constructor_2_neg.cc:
Same.
2011-08-05 Rainer Orth <ro@CeBiTec.Uni-Bielefeld.DE> 2011-08-05 Rainer Orth <ro@CeBiTec.Uni-Bielefeld.DE>
* acinclude.m4 (GLIBCXX_EXPORT_INCLUDES): Point TOPLEVEL_INCLUDES * acinclude.m4 (GLIBCXX_EXPORT_INCLUDES): Point TOPLEVEL_INCLUDES

3
libstdc++-v3/doc/doxygen/user.cfg.in
View File

@ -648,6 +648,7 @@ INPUT = @srcdir@/doc/doxygen/doxygroups.cc \
include/random \ include/random \
include/ratio \ include/ratio \
include/regex \ include/regex \
include/scoped_allocator \
include/set \ include/set \
include/sstream \ include/sstream \
include/stack \ include/stack \
@ -1384,7 +1385,7 @@ LATEX_FOOTER =
# contain links (just like the HTML output) instead of page references # contain links (just like the HTML output) instead of page references
# This makes the output suitable for online browsing using a pdf viewer. # This makes the output suitable for online browsing using a pdf viewer.
PDF_HYPERLINKS = YES PDF_HYPERLINKS = NO
# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of # If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of
# plain latex in the generated Makefile. Set this option to YES to get a # plain latex in the generated Makefile. Set this option to YES to get a

24
libstdc++-v3/include/backward/auto_ptr.h
View File

@ -95,30 +95,30 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief An %auto_ptr is usually constructed from a raw pointer. * @brief An %auto_ptr is usually constructed from a raw pointer.
* @param p A pointer (defaults to NULL). * @param __p A pointer (defaults to NULL).
* *
* This object now @e owns the object pointed to by @a p. * This object now @e owns the object pointed to by @a __p.
*/ */
explicit explicit
auto_ptr(element_type* __p = 0) throw() : _M_ptr(__p) { } auto_ptr(element_type* __p = 0) throw() : _M_ptr(__p) { }
/** /**
* @brief An %auto_ptr can be constructed from another %auto_ptr. * @brief An %auto_ptr can be constructed from another %auto_ptr.
* @param a Another %auto_ptr of the same type. * @param __a Another %auto_ptr of the same type.
* *
* This object now @e owns the object previously owned by @a a, * This object now @e owns the object previously owned by @a __a,
* which has given up ownership. * which has given up ownership.
*/ */
auto_ptr(auto_ptr& __a) throw() : _M_ptr(__a.release()) { } auto_ptr(auto_ptr& __a) throw() : _M_ptr(__a.release()) { }
/** /**
* @brief An %auto_ptr can be constructed from another %auto_ptr. * @brief An %auto_ptr can be constructed from another %auto_ptr.
* @param a Another %auto_ptr of a different but related type. * @param __a Another %auto_ptr of a different but related type.
* *
* A pointer-to-Tp1 must be convertible to a * A pointer-to-Tp1 must be convertible to a
* pointer-to-Tp/element_type. * pointer-to-Tp/element_type.
* *
* This object now @e owns the object previously owned by @a a, * This object now @e owns the object previously owned by @a __a,
* which has given up ownership. * which has given up ownership.
*/ */
template<typename _Tp1> template<typename _Tp1>
@ -126,9 +126,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief %auto_ptr assignment operator. * @brief %auto_ptr assignment operator.
* @param a Another %auto_ptr of the same type. * @param __a Another %auto_ptr of the same type.
* *
* This object now @e owns the object previously owned by @a a, * This object now @e owns the object previously owned by @a __a,
* which has given up ownership. The object that this one @e * which has given up ownership. The object that this one @e
* used to own and track has been deleted. * used to own and track has been deleted.
*/ */
@ -141,11 +141,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief %auto_ptr assignment operator. * @brief %auto_ptr assignment operator.
* @param a Another %auto_ptr of a different but related type. * @param __a Another %auto_ptr of a different but related type.
* *
* A pointer-to-Tp1 must be convertible to a pointer-to-Tp/element_type. * A pointer-to-Tp1 must be convertible to a pointer-to-Tp/element_type.
* *
* This object now @e owns the object previously owned by @a a, * This object now @e owns the object previously owned by @a __a,
* which has given up ownership. The object that this one @e * which has given up ownership. The object that this one @e
* used to own and track has been deleted. * used to own and track has been deleted.
*/ */
@ -231,9 +231,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Forcibly deletes the managed object. * @brief Forcibly deletes the managed object.
* @param p A pointer (defaults to NULL). * @param __p A pointer (defaults to NULL).
* *
* This object now @e owns the object pointed to by @a p. The * This object now @e owns the object pointed to by @a __p. The
* previous object has been deleted. * previous object has been deleted.
*/ */
void void

59
libstdc++-v3/include/bits/alloc_traits.h
View File

@ -22,6 +22,11 @@
// see the files COPYING3 and COPYING.RUNTIME respectively. If not, see // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
// <http://www.gnu.org/licenses/>. // <http://www.gnu.org/licenses/>.
/** @file bits/alloc_traits.h
* This is an internal header file, included by other library headers.
* Do not attempt to use it directly. @headername{scoped_allocator}
*/
#ifndef _ALLOC_TRAITS_H #ifndef _ALLOC_TRAITS_H
#define _ALLOC_TRAITS_H 1 #define _ALLOC_TRAITS_H 1
@ -346,8 +351,8 @@ _GLIBCXX_ALLOC_TR_NESTED_TYPE(propagate_on_container_swap,
/** /**
* @brief Allocate memory. * @brief Allocate memory.
* @param a An allocator. * @param __a An allocator.
* @param n The number of objects to allocate space for. * @param __n The number of objects to allocate space for.
* *
* Calls @c a.allocate(n) * Calls @c a.allocate(n)
*/ */
@ -357,9 +362,9 @@ _GLIBCXX_ALLOC_TR_NESTED_TYPE(propagate_on_container_swap,
/** /**
* @brief Allocate memory. * @brief Allocate memory.
* @param a An allocator. * @param __a An allocator.
* @param n The number of objects to allocate space for. * @param __n The number of objects to allocate space for.
* @param hint Aid to locality. * @param __hint Aid to locality.
* @return Memory of suitable size and alignment for @a n objects * @return Memory of suitable size and alignment for @a n objects
* of type @c value_type * of type @c value_type
* *
@ -372,9 +377,9 @@ _GLIBCXX_ALLOC_TR_NESTED_TYPE(propagate_on_container_swap,
/** /**
* @brief Deallocate memory. * @brief Deallocate memory.
* @param a An allocator. * @param __a An allocator.
* @param p Pointer to the memory to deallocate. * @param __p Pointer to the memory to deallocate.
* @param n The number of objects space was allocated for. * @param __n The number of objects space was allocated for.
* *
* Calls <tt> a.deallocate(p, n) </tt> * Calls <tt> a.deallocate(p, n) </tt>
*/ */
@ -382,27 +387,27 @@ _GLIBCXX_ALLOC_TR_NESTED_TYPE(propagate_on_container_swap,
{ __a.deallocate(__p, __n); } { __a.deallocate(__p, __n); }
/** /**
* @brief Construct an object of type @a Tp * @brief Construct an object of type @a _Tp
* @param a An allocator. * @param __a An allocator.
* @param p Pointer to memory of suitable size and alignment for Tp * @param __p Pointer to memory of suitable size and alignment for Tp
* @param args Constructor arguments. * @param __args Constructor arguments.
* *
* Calls <tt> a.construct(p, std::forward<Args>(args)...) </tt> * Calls <tt> __a.construct(__p, std::forward<Args>(__args)...) </tt>
* if that expression is well-formed, otherwise uses placement-new * if that expression is well-formed, otherwise uses placement-new
* to construct an object of type @a Tp at location @a p from the * to construct an object of type @a _Tp at location @a __p from the
* arguments @a args... * arguments @a __args...
*/ */
template<typename _Tp, typename... _Args> template<typename _Tp, typename... _Args>
static void construct(_Alloc& __a, _Tp* __p, _Args&&... __args) static void construct(_Alloc& __a, _Tp* __p, _Args&&... __args)
{ _S_construct(__a, __p, std::forward<_Args>(__args)...); } { _S_construct(__a, __p, std::forward<_Args>(__args)...); }
/** /**
* @brief Destroy an object of type @a Tp * @brief Destroy an object of type @a _Tp
* @param a An allocator. * @param __a An allocator.
* @param p Pointer to the object to destroy * @param __p Pointer to the object to destroy
* *
* Calls @c a.destroy(p) if that expression is well-formed, * Calls @c __a.destroy(__p) if that expression is well-formed,
* otherwise calls @c p->~Tp() * otherwise calls @c __p->~_Tp()
*/ */
template <class _Tp> template <class _Tp>
static void destroy(_Alloc& __a, _Tp* __p) static void destroy(_Alloc& __a, _Tp* __p)
@ -410,10 +415,10 @@ _GLIBCXX_ALLOC_TR_NESTED_TYPE(propagate_on_container_swap,
/** /**
* @brief The maximum supported allocation size * @brief The maximum supported allocation size
* @param a An allocator. * @param __a An allocator.
* @return @c a.max_size() or @c numeric_limits<size_type>::max() * @return @c __a.max_size() or @c numeric_limits<size_type>::max()
* *
* Returns @c a.max_size() if that expression is well-formed, * Returns @c __a.max_size() if that expression is well-formed,
* otherwise returns @c numeric_limits<size_type>::max() * otherwise returns @c numeric_limits<size_type>::max()
*/ */
static size_type max_size(const _Alloc& __a) static size_type max_size(const _Alloc& __a)
@ -421,11 +426,11 @@ _GLIBCXX_ALLOC_TR_NESTED_TYPE(propagate_on_container_swap,
/** /**
* @brief Obtain an allocator to use when copying a container. * @brief Obtain an allocator to use when copying a container.
* @param rhs An allocator. * @param __rhs An allocator.
* @return @c rhs.select_on_container_copy_construction() or @a rhs * @return @c __rhs.select_on_container_copy_construction() or @a __rhs
* *
* Returns @c rhs.select_on_container_copy_construction() if that * Returns @c __rhs.select_on_container_copy_construction() if that
* expression is well-formed, otherwise returns @a rhs * expression is well-formed, otherwise returns @a __rhs
*/ */
static _Alloc static _Alloc
select_on_container_copy_construction(const _Alloc& __rhs) select_on_container_copy_construction(const _Alloc& __rhs)

20
libstdc++-v3/include/bits/basic_ios.h
View File

@ -131,7 +131,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief [Re]sets the error state. * @brief [Re]sets the error state.
* @param state The new state flag(s) to set. * @param __state The new state flag(s) to set.
* *
* See std::ios_base::iostate for the possible bit values. Most * See std::ios_base::iostate for the possible bit values. Most
* users will not need to pass an argument. * users will not need to pass an argument.
@ -141,7 +141,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Sets additional flags in the error state. * @brief Sets additional flags in the error state.
* @param state The additional state flag(s) to set. * @param __state The additional state flag(s) to set.
* *
* See std::ios_base::iostate for the possible bit values. * See std::ios_base::iostate for the possible bit values.
*/ */
@ -216,7 +216,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Throwing exceptions on errors. * @brief Throwing exceptions on errors.
* @param except The new exceptions mask. * @param __except The new exceptions mask.
* *
* By default, error flags are set silently. You can set an * By default, error flags are set silently. You can set an
* exceptions mask for each stream; if a bit in the mask becomes set * exceptions mask for each stream; if a bit in the mask becomes set
@ -289,7 +289,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Ties this stream to an output stream. * @brief Ties this stream to an output stream.
* @param tiestr The output stream. * @param __tiestr The output stream.
* @return The previously tied output stream, or NULL if the stream * @return The previously tied output stream, or NULL if the stream
* was not tied. * was not tied.
* *
@ -315,7 +315,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Changing the underlying buffer. * @brief Changing the underlying buffer.
* @param sb The new stream buffer. * @param __sb The new stream buffer.
* @return The previous stream buffer. * @return The previous stream buffer.
* *
* Associates a new buffer with the current stream, and clears the * Associates a new buffer with the current stream, and clears the
@ -371,7 +371,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Sets a new @a empty character. * @brief Sets a new @a empty character.
* @param ch The new character. * @param __ch The new character.
* @return The previous fill character. * @return The previous fill character.
* *
* The fill character is used to fill out space when P+ characters * The fill character is used to fill out space when P+ characters
@ -389,7 +389,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// Locales: // Locales:
/** /**
* @brief Moves to a new locale. * @brief Moves to a new locale.
* @param loc The new locale. * @param __loc The new locale.
* @return The previous locale. * @return The previous locale.
* *
* Calls @c ios_base::imbue(loc), and if a stream buffer is associated * Calls @c ios_base::imbue(loc), and if a stream buffer is associated
@ -403,8 +403,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Squeezes characters. * @brief Squeezes characters.
* @param c The character to narrow. * @param __c The character to narrow.
* @param dfault The character to narrow. * @param __dfault The character to narrow.
* @return The narrowed character. * @return The narrowed character.
* *
* Maps a character of @c char_type to a character of @c char, * Maps a character of @c char_type to a character of @c char,
@ -424,7 +424,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Widens characters. * @brief Widens characters.
* @param c The character to widen. * @param __c The character to widen.
* @return The widened character. * @return The widened character.
* *
* Maps a character of @c char to a character of @c char_type. * Maps a character of @c char to a character of @c char_type.

1128
libstdc++-v3/include/bits/basic_string.h
View File

File diff suppressed because it is too large Load Diff

36
libstdc++-v3/include/bits/codecvt.h
View File

@ -104,13 +104,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* output, returns codecvt_base::partial. Otherwise the * output, returns codecvt_base::partial. Otherwise the
* conversion failed and codecvt_base::error is returned. * conversion failed and codecvt_base::error is returned.
* *
* @param state Persistent conversion state data. * @param __state Persistent conversion state data.
* @param from Start of input. * @param __from Start of input.
* @param from_end End of input. * @param __from_end End of input.
* @param from_next Returns start of unconverted data. * @param __from_next Returns start of unconverted data.
* @param to Start of output buffer. * @param __to Start of output buffer.
* @param to_end End of output buffer. * @param __to_end End of output buffer.
* @param to_next Returns start of unused output area. * @param __to_next Returns start of unused output area.
* @return codecvt_base::result. * @return codecvt_base::result.
*/ */
result result
@ -146,10 +146,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* output has insufficient space, returns codecvt_base::partial. * output has insufficient space, returns codecvt_base::partial.
* Otherwise the reset failed and codecvt_base::error is returned. * Otherwise the reset failed and codecvt_base::error is returned.
* *
* @param state Persistent conversion state data. * @param __state Persistent conversion state data.
* @param to Start of output buffer. * @param __to Start of output buffer.
* @param to_end End of output buffer. * @param __to_end End of output buffer.
* @param to_next Returns start of unused output area. * @param __to_next Returns start of unused output area.
* @return codecvt_base::result. * @return codecvt_base::result.
*/ */
result result
@ -184,13 +184,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* output, returns codecvt_base::partial. Otherwise the * output, returns codecvt_base::partial. Otherwise the
* conversion failed and codecvt_base::error is returned. * conversion failed and codecvt_base::error is returned.
* *
* @param state Persistent conversion state data. * @param __state Persistent conversion state data.
* @param from Start of input. * @param __from Start of input.
* @param from_end End of input. * @param __from_end End of input.
* @param from_next Returns start of unconverted data. * @param __from_next Returns start of unconverted data.
* @param to Start of output buffer. * @param __to Start of output buffer.
* @param to_end End of output buffer. * @param __to_end End of output buffer.
* @param to_next Returns start of unused output area. * @param __to_next Returns start of unused output area.
* @return codecvt_base::result. * @return codecvt_base::result.
*/ */
result result

214
libstdc++-v3/include/bits/forward_list.h
View File

@ -435,7 +435,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %forward_list with no elements. * @brief Creates a %forward_list with no elements.
* @param al An allocator object. * @param __al An allocator object.
*/ */
explicit explicit
forward_list(const _Alloc& __al = _Alloc()) forward_list(const _Alloc& __al = _Alloc())
@ -444,8 +444,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Copy constructor with allocator argument. * @brief Copy constructor with allocator argument.
* @param list Input list to copy. * @param __list Input list to copy.
* @param al An allocator object. * @param __al An allocator object.
*/ */
forward_list(const forward_list& __list, const _Alloc& __al) forward_list(const forward_list& __list, const _Alloc& __al)
: _Base(__list, __al) : _Base(__list, __al)
@ -453,8 +453,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Move constructor with allocator argument. * @brief Move constructor with allocator argument.
* @param list Input list to move. * @param __list Input list to move.
* @param al An allocator object. * @param __al An allocator object.
*/ */
forward_list(forward_list&& __list, const _Alloc& __al) forward_list(forward_list&& __list, const _Alloc& __al)
: _Base(std::move(__list), __al) : _Base(std::move(__list), __al)
@ -462,9 +462,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %forward_list with default constructed elements. * @brief Creates a %forward_list with default constructed elements.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* *
* This constructor creates the %forward_list with @a n default * This constructor creates the %forward_list with @a __n default
* constructed elements. * constructed elements.
*/ */
explicit explicit
@ -474,12 +474,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %forward_list with copies of an exemplar element. * @brief Creates a %forward_list with copies of an exemplar element.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* @param value An element to copy. * @param __value An element to copy.
* @param al An allocator object. * @param __al An allocator object.
* *
* This constructor fills the %forward_list with @a n copies of @a * This constructor fills the %forward_list with @a __n copies of
* value. * @a __value.
*/ */
forward_list(size_type __n, const _Tp& __value, forward_list(size_type __n, const _Tp& __value,
const _Alloc& __al = _Alloc()) const _Alloc& __al = _Alloc())
@ -488,13 +488,13 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %forward_list from a range. * @brief Builds a %forward_list from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param al An allocator object. * @param __al An allocator object.
* *
* Create a %forward_list consisting of copies of the elements from * Create a %forward_list consisting of copies of the elements from
* [@a first,@a last). This is linear in N (where N is * [@a __first,@a __last). This is linear in N (where N is
* distance(@a first,@a last)). * distance(@a __first,@a __last)).
*/ */
template<typename _InputIterator> template<typename _InputIterator>
forward_list(_InputIterator __first, _InputIterator __last, forward_list(_InputIterator __first, _InputIterator __last,
@ -508,11 +508,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief The %forward_list copy constructor. * @brief The %forward_list copy constructor.
* @param list A %forward_list of identical element and allocator * @param __list A %forward_list of identical element and allocator
* types. * types.
* *
* The newly-created %forward_list uses a copy of the allocation * The newly-created %forward_list uses a copy of the allocation
* object used by @a list. * object used by @a __list.
*/ */
forward_list(const forward_list& __list) forward_list(const forward_list& __list)
: _Base(__list._M_get_Node_allocator()) : _Base(__list._M_get_Node_allocator())
@ -520,11 +520,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief The %forward_list move constructor. * @brief The %forward_list move constructor.
* @param list A %forward_list of identical element and allocator * @param __list A %forward_list of identical element and allocator
* types. * types.
* *
* The newly-created %forward_list contains the exact contents of @a * The newly-created %forward_list contains the exact contents of @a
* forward_list. The contents of @a list are a valid, but unspecified * forward_list. The contents of @a __list are a valid, but unspecified
* %forward_list. * %forward_list.
*/ */
forward_list(forward_list&& __list) noexcept forward_list(forward_list&& __list) noexcept
@ -532,11 +532,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %forward_list from an initializer_list * @brief Builds a %forward_list from an initializer_list
* @param il An initializer_list of value_type. * @param __il An initializer_list of value_type.
* @param al An allocator object. * @param __al An allocator object.
* *
* Create a %forward_list consisting of copies of the elements * 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 __il.size().
*/ */
forward_list(std::initializer_list<_Tp> __il, forward_list(std::initializer_list<_Tp> __il,
const _Alloc& __al = _Alloc()) const _Alloc& __al = _Alloc())
@ -551,10 +551,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief The %forward_list assignment operator. * @brief The %forward_list assignment operator.
* @param list A %forward_list of identical element and allocator * @param __list A %forward_list of identical element and allocator
* types. * types.
* *
* All the elements of @a list are copied, but unlike the copy * All the elements of @a __list are copied, but unlike the copy
* constructor, the allocator object is not copied. * constructor, the allocator object is not copied.
*/ */
forward_list& forward_list&
@ -562,11 +562,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief The %forward_list move assignment operator. * @brief The %forward_list move assignment operator.
* @param list A %forward_list of identical element and allocator * @param __list A %forward_list of identical element and allocator
* types. * types.
* *
* The contents of @a list are moved into this %forward_list * The contents of @a __list are moved into this %forward_list
* (without copying). @a list is a valid, but unspecified * (without copying). @a __list is a valid, but unspecified
* %forward_list * %forward_list
*/ */
forward_list& forward_list&
@ -581,11 +581,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief The %forward_list initializer list assignment operator. * @brief The %forward_list initializer list assignment operator.
* @param il An initializer_list of value_type. * @param __il An initializer_list of value_type.
* *
* Replace the contents of the %forward_list with copies of the * Replace the contents of the %forward_list with copies of the
* elements in the initializer_list @a il. This is linear in * elements in the initializer_list @a __il. This is linear in
* il.size(). * __il.size().
*/ */
forward_list& forward_list&
operator=(std::initializer_list<_Tp> __il) operator=(std::initializer_list<_Tp> __il)
@ -596,11 +596,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Assigns a range to a %forward_list. * @brief Assigns a range to a %forward_list.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* This function fills a %forward_list with copies of the elements * This function fills a %forward_list with copies of the elements
* in the range [@a first,@a last). * in the range [@a __first,@a __last).
* *
* Note that the assignment completely changes the %forward_list and * Note that the assignment completely changes the %forward_list and
* that the resulting %forward_list's size is the same as the number * that the resulting %forward_list's size is the same as the number
@ -616,10 +616,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Assigns a given value to a %forward_list. * @brief Assigns a given value to a %forward_list.
* @param n Number of elements to be assigned. * @param __n Number of elements to be assigned.
* @param val Value to be assigned. * @param __val Value to be assigned.
* *
* This function fills a %forward_list with @a n copies of the given * This function fills a %forward_list with @a __n copies of the given
* value. Note that the assignment completely changes the * value. Note that the assignment completely changes the
* %forward_list and that the resulting %forward_list's size is 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. * same as the number of elements assigned. Old data may be lost.
@ -633,10 +633,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Assigns an initializer_list to a %forward_list. * @brief Assigns an initializer_list to a %forward_list.
* @param il An initializer_list of value_type. * @param __il An initializer_list of value_type.
* *
* Replace the contents of the %forward_list with copies of the * Replace the contents of the %forward_list with copies of the
* elements in the initializer_list @a il. This is linear in * elements in the initializer_list @a __il. This is linear in
* il.size(). * il.size().
*/ */
void void
@ -776,7 +776,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Constructs object in %forward_list at the front of the * @brief Constructs object in %forward_list at the front of the
* list. * list.
* @param args Arguments. * @param __args Arguments.
* *
* This function will insert an object of type Tp constructed * This function will insert an object of type Tp constructed
* with Tp(std::forward<Args>(args)...) at the front of the list * with Tp(std::forward<Args>(args)...) at the front of the list
@ -792,7 +792,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Add data to the front of the %forward_list. * @brief Add data to the front of the %forward_list.
* @param val Data to be added. * @param __val Data to be added.
* *
* This is a typical stack operation. The function creates an * This is a typical stack operation. The function creates an
* element at the front of the %forward_list and assigns the given * element at the front of the %forward_list and assigns the given
@ -830,8 +830,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Constructs object in %forward_list after the specified * @brief Constructs object in %forward_list after the specified
* iterator. * iterator.
* @param pos A const_iterator into the %forward_list. * @param __pos A const_iterator into the %forward_list.
* @param args Arguments. * @param __args Arguments.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert an object of type T constructed * This function will insert an object of type T constructed
@ -849,8 +849,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts given value into %forward_list after specified * @brief Inserts given value into %forward_list after specified
* iterator. * iterator.
* @param pos An iterator into the %forward_list. * @param __pos An iterator into the %forward_list.
* @param val Data to be inserted. * @param __val Data to be inserted.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert a copy of the given value after * This function will insert a copy of the given value after
@ -872,9 +872,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts a number of copies of given data into the * @brief Inserts a number of copies of given data into the
* %forward_list. * %forward_list.
* @param pos An iterator into the %forward_list. * @param __pos An iterator into the %forward_list.
* @param n Number of elements to be inserted. * @param __n Number of elements to be inserted.
* @param val Data to be inserted. * @param __val Data to be inserted.
* @return An iterator pointing to the last inserted copy of * @return An iterator pointing to the last inserted copy of
* @a val or @a pos if @a n == 0. * @a val or @a pos if @a n == 0.
* *
@ -889,15 +889,15 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts a range into the %forward_list. * @brief Inserts a range into the %forward_list.
* @param position An iterator into the %forward_list. * @param __pos An iterator into the %forward_list.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @return An iterator pointing to the last inserted element or * @return An iterator pointing to the last inserted element or
* @a pos if @a first == @a last. * @a __pos if @a __first == @a __last.
* *
* This function will insert copies of the data in the range [@a * This function will insert copies of the data in the range
* first,@a last) into the %forward_list after the location specified * [@a __first,@a __last) into the %forward_list after the
* by @a pos. * location specified by @a __pos.
* *
* This operation is linear in the number of elements inserted and * This operation is linear in the number of elements inserted and
* does not invalidate iterators and references. * does not invalidate iterators and references.
@ -910,14 +910,14 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts the contents of an initializer_list into * @brief Inserts the contents of an initializer_list into
* %forward_list after the specified iterator. * %forward_list after the specified iterator.
* @param pos An iterator into the %forward_list. * @param __pos An iterator into the %forward_list.
* @param il An initializer_list of value_type. * @param __il An initializer_list of value_type.
* @return An iterator pointing to the last inserted element * @return An iterator pointing to the last inserted element
* or @a pos if @a il is empty. * or @a __pos if @a __il is empty.
* *
* This function will insert copies of the data in the * This function will insert copies of the data in the
* initializer_list @a il into the %forward_list before the location * initializer_list @a __il into the %forward_list before the location
* specified by @a pos. * specified by @a __pos.
* *
* This operation is linear in the number of elements inserted and * This operation is linear in the number of elements inserted and
* does not invalidate iterators and references. * does not invalidate iterators and references.
@ -928,7 +928,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Removes the element pointed to by the iterator following * @brief Removes the element pointed to by the iterator following
* @c pos. * @c pos.
* @param pos Iterator pointing before element to be erased. * @param __pos Iterator pointing before element to be erased.
* @return An iterator pointing to the element following the one * @return An iterator pointing to the element following the one
* that was erased, or end() if no such element exists. * that was erased, or end() if no such element exists.
* *
@ -949,14 +949,14 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove a range of elements. * @brief Remove a range of elements.
* @param pos Iterator pointing before the first element to be * @param __pos Iterator pointing before the first element to be
* erased. * erased.
* @param last Iterator pointing to one past the last element to be * @param __last Iterator pointing to one past the last element to be
* erased. * erased.
* @return @last. * @return @ __last.
* *
* This function will erase the elements in the range @a * This function will erase the elements in the range
* (pos,last) and shorten the %forward_list accordingly. * @a (__pos,__last) and shorten the %forward_list accordingly.
* *
* This operation is linear time in the size of the range and only * This operation is linear time in the size of the range and only
* invalidates iterators/references to the element being removed. * invalidates iterators/references to the element being removed.
@ -974,8 +974,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Swaps data with another %forward_list. * @brief Swaps data with another %forward_list.
* @param list A %forward_list of the same element and allocator * @param __list A %forward_list of the same element and allocator
* types. * types.
* *
* This exchanges the elements between two lists in constant * This exchanges the elements between two lists in constant
* time. Note that the global std::swap() function is * time. Note that the global std::swap() function is
@ -990,7 +990,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Resizes the %forward_list to the specified number of * @brief Resizes the %forward_list to the specified number of
* elements. * elements.
* @param sz Number of elements the %forward_list should contain. * @param __sz Number of elements the %forward_list should contain.
* *
* This function will %resize the %forward_list to the specified * This function will %resize the %forward_list to the specified
* number of elements. If the number is smaller than the * number of elements. If the number is smaller than the
@ -1004,8 +1004,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Resizes the %forward_list to the specified number of * @brief Resizes the %forward_list to the specified number of
* elements. * elements.
* @param sz Number of elements the %forward_list should contain. * @param __sz Number of elements the %forward_list should contain.
* @param val Data with which new elements should be populated. * @param __val Data with which new elements should be populated.
* *
* This function will %resize the %forward_list to the specified * This function will %resize the %forward_list to the specified
* number of elements. If the number is smaller than the * number of elements. If the number is smaller than the
@ -1032,8 +1032,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Insert contents of another %forward_list. * @brief Insert contents of another %forward_list.
* @param pos Iterator referencing the element to insert after. * @param __pos Iterator referencing the element to insert after.
* @param list Source list. * @param __list Source list.
* *
* The elements of @a list are inserted in constant time after * The elements of @a list are inserted in constant time after
* the element referenced by @a pos. @a list becomes an empty * the element referenced by @a pos. @a list becomes an empty
@ -1050,10 +1050,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Insert element from another %forward_list. * @brief Insert element from another %forward_list.
* @param pos Iterator referencing the element to insert after. * @param __pos Iterator referencing the element to insert after.
* @param list Source list. * @param __list Source list.
* @param i Iterator referencing the element before the element * @param __i Iterator referencing the element before the element
* to move. * to move.
* *
* Removes the element in list @a list referenced by @a i and * Removes the element in list @a list referenced by @a i and
* inserts it into the current list after @a pos. * inserts it into the current list after @a pos.
@ -1072,16 +1072,16 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Insert range from another %forward_list. * @brief Insert range from another %forward_list.
* @param pos Iterator referencing the element to insert after. * @param __pos Iterator referencing the element to insert after.
* @param list Source list. * @param __list Source list.
* @param before Iterator referencing before the start of range * @param __before Iterator referencing before the start of range
* in list. * in list.
* @param last Iterator referencing the end of range in list. * @param __last Iterator referencing the end of range in list.
* *
* Removes elements in the range (before,last) and inserts them * Removes elements in the range (__before,__last) and inserts them
* after @a pos in constant time. * after @a __pos in constant time.
* *
* Undefined if @a pos is in (before,last). * Undefined if @a __pos is in (__before,__last).
*/ */
void void
splice_after(const_iterator __pos, forward_list&& __list, splice_after(const_iterator __pos, forward_list&& __list,
@ -1089,9 +1089,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove all elements equal to value. * @brief Remove all elements equal to value.
* @param val The value to remove. * @param __val The value to remove.
* *
* Removes every element in the list equal to @a value. * Removes every element in the list equal to @a __val.
* Remaining elements stay in list order. Note that this * Remaining elements stay in list order. Note that this
* function only erases the elements, and that if the elements * function only erases the elements, and that if the elements
* themselves are pointers, the pointed-to memory is not * themselves are pointers, the pointed-to memory is not
@ -1103,7 +1103,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove all elements satisfying a predicate. * @brief Remove all elements satisfying a predicate.
* @param pred Unary predicate function or object. * @param __pred Unary predicate function or object.
* *
* Removes every element in the list for which the predicate * Removes every element in the list for which the predicate
* returns true. Remaining elements stay in list order. Note * returns true. Remaining elements stay in list order. Note
@ -1132,7 +1132,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove consecutive elements satisfying a predicate. * @brief Remove consecutive elements satisfying a predicate.
* @param binary_pred Binary predicate function or object. * @param __binary_pred Binary predicate function or object.
* *
* For each consecutive set of elements [first,last) that * For each consecutive set of elements [first,last) that
* satisfy predicate(first,i) where i is an iterator in * satisfy predicate(first,i) where i is an iterator in
@ -1148,12 +1148,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Merge sorted lists. * @brief Merge sorted lists.
* @param list Sorted list to merge. * @param __list Sorted list to merge.
* *
* Assumes that both @a list and this list are sorted according to * Assumes that both @a list and this list are sorted according to
* operator<(). Merges elements of @a list into this list in * operator<(). Merges elements of @a __list into this list in
* sorted order, leaving @a list empty when complete. Elements in * sorted order, leaving @a __list empty when complete. Elements in
* this list precede elements in @a list that are equal. * this list precede elements in @a __list that are equal.
*/ */
void void
merge(forward_list&& __list) merge(forward_list&& __list)
@ -1161,13 +1161,13 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Merge sorted lists according to comparison function. * @brief Merge sorted lists according to comparison function.
* @param list Sorted list to merge. * @param __list Sorted list to merge.
* @param comp Comparison function defining sort order. * @param __comp Comparison function defining sort order.
* *
* Assumes that both @a list and this list are sorted according to * Assumes that both @a __list and this list are sorted according to
* comp. Merges elements of @a list into this list * comp. Merges elements of @a __list into this list
* in sorted order, leaving @a list empty when complete. Elements * in sorted order, leaving @a __list empty when complete. Elements
* in this list precede elements in @a list that are equivalent * in this list precede elements in @a __list that are equivalent
* according to comp(). * according to comp().
*/ */
template<typename _Comp> template<typename _Comp>
@ -1235,8 +1235,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Forward list equality comparison. * @brief Forward list equality comparison.
* @param lx A %forward_list * @param __lx A %forward_list
* @param ly A %forward_list of the same type as @a lx. * @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 size and elements of the forward lists are equal.
* *
* This is an equivalence relation. It is linear in the size of the * This is an equivalence relation. It is linear in the size of the
@ -1250,9 +1250,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Forward list ordering relation. * @brief Forward list ordering relation.
* @param lx A %forward_list. * @param __lx A %forward_list.
* @param ly A %forward_list of the same type as @a lx. * @param __ly A %forward_list of the same type as @a __lx.
* @return True iff @a lx is lexicographically less than @a ly. * @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 * This is a total ordering relation. It is linear in the size of the
* forward lists. The elements must be comparable with @c <. * forward lists. The elements must be comparable with @c <.

13
libstdc++-v3/include/bits/gslice.h
View File

@ -1,7 +1,7 @@
// The template and inlines for the -*- C++ -*- gslice class. // The template and inlines for the -*- C++ -*- gslice class.
// Copyright (C) 1997, 1998, 1999, 2000, 2001, 2004, 2005, 2006, 2009, 2010 // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2004, 2005, 2006, 2009, 2010,
// Free Software Foundation, Inc. // 2011 Free Software Foundation, Inc.
// //
// This file is part of the GNU ISO C++ Library. This library is free // This file is part of the GNU ISO C++ Library. This library is free
// software; you can redistribute it and/or modify it under the // software; you can redistribute it and/or modify it under the
@ -74,11 +74,12 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* Constructs a slice with as many dimensions as the length of the @a l * Constructs a slice with as many dimensions as the length of the @a l
* and @a s arrays. * and @a s arrays.
* *
* @param o Offset in array of first element. * @param __o Offset in array of first element.
* @param l Array of dimension lengths. * @param __l Array of dimension lengths.
* @param s Array of dimension strides between array elements. * @param __s Array of dimension strides between array elements.
*/ */
gslice(size_t, const valarray<size_t>&, const valarray<size_t>&); gslice(size_t __o, const valarray<size_t>& __l,
const valarray<size_t>& __s);
// XXX: the IS says the copy-ctor and copy-assignment operators are // XXX: the IS says the copy-ctor and copy-assignment operators are
// synthesized by the compiler but they are just unsuitable // synthesized by the compiler but they are just unsuitable

30
libstdc++-v3/include/bits/ios_base.h
View File

@ -427,15 +427,15 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief The type of an event callback function. * @brief The type of an event callback function.
* @param event One of the members of the event enum. * @param __e One of the members of the event enum.
* @param ios_base Reference to the ios_base object. * @param __b Reference to the ios_base object.
* @param int The integer provided when the callback was registered. * @param __i The integer provided when the callback was registered.
* *
* Event callbacks are user defined functions that get called during * Event callbacks are user defined functions that get called during
* several ios_base and basic_ios functions, specifically imbue(), * several ios_base and basic_ios functions, specifically imbue(),
* copyfmt(), and ~ios(). * copyfmt(), and ~ios().
*/ */
typedef void (*event_callback) (event, ios_base&, int); typedef void (*event_callback) (event __e, ios_base& __b, int __i);
/** /**
* @brief Add the callback __fn with parameter __index. * @brief Add the callback __fn with parameter __index.
@ -555,10 +555,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Setting new format flags all at once. * @brief Setting new format flags all at once.
* @param fmtfl The new flags to set. * @param __fmtfl The new flags to set.
* @return The previous format control flags. * @return The previous format control flags.
* *
* This function overwrites all the format flags with @a fmtfl. * This function overwrites all the format flags with @a __fmtfl.
*/ */
fmtflags fmtflags
flags(fmtflags __fmtfl) flags(fmtflags __fmtfl)
@ -570,7 +570,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Setting new format flags. * @brief Setting new format flags.
* @param fmtfl Additional flags to set. * @param __fmtfl Additional flags to set.
* @return The previous format control flags. * @return The previous format control flags.
* *
* This function sets additional flags in format control. Flags that * This function sets additional flags in format control. Flags that
@ -586,8 +586,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Setting new format flags. * @brief Setting new format flags.
* @param fmtfl Additional flags to set. * @param __fmtfl Additional flags to set.
* @param mask The flags mask for @a fmtfl. * @param __mask The flags mask for @a fmtfl.
* @return The previous format control flags. * @return The previous format control flags.
* *
* This function clears @a mask in the format flags, then sets * This function clears @a mask in the format flags, then sets
@ -604,9 +604,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Clearing format flags. * @brief Clearing format flags.
* @param mask The flags to unset. * @param __mask The flags to unset.
* *
* This function clears @a mask in the format flags. * This function clears @a __mask in the format flags.
*/ */
void void
unsetf(fmtflags __mask) unsetf(fmtflags __mask)
@ -625,7 +625,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Changing flags. * @brief Changing flags.
* @param prec The new precision value. * @param __prec The new precision value.
* @return The previous value of precision(). * @return The previous value of precision().
*/ */
streamsize streamsize
@ -648,7 +648,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Changing flags. * @brief Changing flags.
* @param wide The new width value. * @param __wide The new width value.
* @return The previous value of width(). * @return The previous value of width().
*/ */
streamsize streamsize
@ -662,7 +662,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// [27.4.2.4] ios_base static members // [27.4.2.4] ios_base static members
/** /**
* @brief Interaction with the standard C I/O objects. * @brief Interaction with the standard C I/O objects.
* @param sync Whether to synchronize or not. * @param __sync Whether to synchronize or not.
* @return True if the standard streams were previously synchronized. * @return True if the standard streams were previously synchronized.
* *
* The synchronization referred to is @e only that between the standard * The synchronization referred to is @e only that between the standard
@ -676,7 +676,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// [27.4.2.3] ios_base locale functions // [27.4.2.3] ios_base locale functions
/** /**
* @brief Setting a new locale. * @brief Setting a new locale.
* @param loc The new locale. * @param __loc The new locale.
* @return The previous locale. * @return The previous locale.
* *
* Sets the new locale for this stream, and then invokes each callback * Sets the new locale for this stream, and then invokes each callback

111
libstdc++-v3/include/bits/locale_classes.h
View File

@ -123,7 +123,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* Constructs a copy of @a other. * Constructs a copy of @a other.
* *
* @param other The locale to copy. * @param __other The locale to copy.
*/ */
locale(const locale& __other) throw(); locale(const locale& __other) throw();
@ -132,8 +132,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* Constructs a copy of the named C library locale. * Constructs a copy of the named C library locale.
* *
* @param s Name of the locale to construct. * @param __s Name of the locale to construct.
* @throw std::runtime_error if s is null or an undefined locale. * @throw std::runtime_error if __s is null or an undefined locale.
*/ */
explicit explicit
locale(const char* __s); locale(const char* __s);
@ -145,10 +145,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* cat are replaced with those from the locale named by @a s. If base is * cat are replaced with those from the locale named by @a s. If base is
* named, this locale instance will also be named. * named, this locale instance will also be named.
* *
* @param base The locale to copy. * @param __base The locale to copy.
* @param s Name of the locale to use facets from. * @param __s Name of the locale to use facets from.
* @param cat Set of categories defining the facets to use from s. * @param __cat Set of categories defining the facets to use from __s.
* @throw std::runtime_error if s is null or an undefined locale. * @throw std::runtime_error if __s is null or an undefined locale.
*/ */
locale(const locale& __base, const char* __s, category __cat); locale(const locale& __base, const char* __s, category __cat);
@ -159,21 +159,22 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* cat are replaced with those from the locale @a add. If @a base and @a * cat are replaced with those from the locale @a add. If @a base and @a
* add are named, this locale instance will also be named. * add are named, this locale instance will also be named.
* *
* @param base The locale to copy. * @param __base The locale to copy.
* @param add The locale to use facets from. * @param __add The locale to use facets from.
* @param cat Set of categories defining the facets to use from add. * @param __cat Set of categories defining the facets to use from add.
*/ */
locale(const locale& __base, const locale& __add, category __cat); locale(const locale& __base, const locale& __add, category __cat);
/** /**
* @brief Construct locale with another facet. * @brief Construct locale with another facet.
* *
* Constructs a copy of the locale @a other. The facet @f is added to * Constructs a copy of the locale @a __other. The facet @a __f
* @other, replacing an existing facet of type Facet if there is one. If * is added to @a __other, replacing an existing facet of type
* @f is null, this locale is a copy of @a other. * Facet if there is one. If @a __f is null, this locale is a
* copy of @a __other.
* *
* @param other The locale to copy. * @param __other The locale to copy.
* @param f The facet to add in. * @param __f The facet to add in.
*/ */
template<typename _Facet> template<typename _Facet>
locale(const locale& __other, _Facet* __f); locale(const locale& __other, _Facet* __f);
@ -186,7 +187,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* Set this locale to be a copy of @a other. * Set this locale to be a copy of @a other.
* *
* @param other The locale to copy. * @param __other The locale to copy.
* @return A reference to this locale. * @return A reference to this locale.
*/ */
const locale& const locale&
@ -199,10 +200,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* existing facet of type Facet from the locale @a other into the new * existing facet of type Facet from the locale @a other into the new
* locale. * locale.
* *
* @param Facet The facet type to copy from other * @tparam _Facet The facet type to copy from other
* @param other The locale to copy from. * @param __other The locale to copy from.
* @return Newly constructed locale. * @return Newly constructed locale.
* @throw std::runtime_error if other has no facet of type Facet. * @throw std::runtime_error if __other has no facet of type _Facet.
*/ */
template<typename _Facet> template<typename _Facet>
locale locale
@ -219,7 +220,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Locale equality. * @brief Locale equality.
* *
* @param other The locale to compare against. * @param __other The locale to compare against.
* @return True if other and this refer to the same locale instance, are * @return True if other and this refer to the same locale instance, are
* copies, or have the same name. False otherwise. * copies, or have the same name. False otherwise.
*/ */
@ -229,8 +230,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Locale inequality. * @brief Locale inequality.
* *
* @param other The locale to compare against. * @param __other The locale to compare against.
* @return ! (*this == other) * @return ! (*this == __other)
*/ */
bool bool
operator!=(const locale& __other) const throw() operator!=(const locale& __other) const throw()
@ -247,9 +248,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* std::sort(v.begin(), v.end(), loc); * std::sort(v.begin(), v.end(), loc);
* @endcode * @endcode
* *
* @param s1 First string to compare. * @param __s1 First string to compare.
* @param s2 Second string to compare. * @param __s2 Second string to compare.
* @return True if collate<Char> facet compares s1 < s2, else false. * @return True if collate<_Char> facet compares __s1 < __s2, else false.
*/ */
template<typename _Char, typename _Traits, typename _Alloc> template<typename _Char, typename _Traits, typename _Alloc>
bool bool
@ -264,11 +265,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* copy of the previous global locale. If the argument has a name, it * copy of the previous global locale. If the argument has a name, it
* will also call std::setlocale(LC_ALL, loc.name()). * will also call std::setlocale(LC_ALL, loc.name()).
* *
* @param locale The new locale to make global. * @param __loc The new locale to make global.
* @return Copy of the old global locale. * @return Copy of the old global locale.
*/ */
static locale static locale
global(const locale&); global(const locale& __loc);
/** /**
* @brief Return reference to the C locale. * @brief Return reference to the C locale.
@ -365,7 +366,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* facet is destroyed when the last referencing locale is destroyed. * facet is destroyed when the last referencing locale is destroyed.
* Otherwise the facet will never be destroyed. * Otherwise the facet will never be destroyed.
* *
* @param refs The initial value for reference count. * @param __refs The initial value for reference count.
*/ */
explicit explicit
facet(size_t __refs = 0) throw() : _M_refcount(__refs ? 1 : 0) facet(size_t __refs = 0) throw() : _M_refcount(__refs ? 1 : 0)
@ -576,9 +577,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* provided as the template parameter. Facets derived from the facet * provided as the template parameter. Facets derived from the facet
* parameter will also return true. * parameter will also return true.
* *
* @param Facet The facet type to test the presence of. * @tparam _Facet The facet type to test the presence of.
* @param locale The locale to test. * @param __loc The locale to test.
* @return true if locale contains a facet of type Facet, else false. * @return true if __loc contains a facet of type _Facet, else false.
*/ */
template<typename _Facet> template<typename _Facet>
bool bool
@ -592,10 +593,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* there is a suitable facet to return. It throws std::bad_cast if the * there is a suitable facet to return. It throws std::bad_cast if the
* locale doesn't contain a facet of type Facet. * locale doesn't contain a facet of type Facet.
* *
* @param Facet The facet type to access. * @tparam _Facet The facet type to access.
* @param locale The locale to use. * @param __loc The locale to use.
* @return Reference to facet of type Facet. * @return Reference to facet of type Facet.
* @throw std::bad_cast if locale doesn't contain a facet of type Facet. * @throw std::bad_cast if __loc doesn't contain a facet of type _Facet.
*/ */
template<typename _Facet> template<typename _Facet>
const _Facet& const _Facet&
@ -639,7 +640,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* This is the constructor provided by the standard. * This is the constructor provided by the standard.
* *
* @param refs Passed to the base facet class. * @param __refs Passed to the base facet class.
*/ */
explicit explicit
collate(size_t __refs = 0) collate(size_t __refs = 0)
@ -652,8 +653,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* This is a constructor for use by the library itself to set up new * This is a constructor for use by the library itself to set up new
* locales. * locales.
* *
* @param cloc The C locale. * @param __cloc The C locale.
* @param refs Passed to the base facet class. * @param __refs Passed to the base facet class.
*/ */
explicit explicit
collate(__c_locale __cloc, size_t __refs = 0) collate(__c_locale __cloc, size_t __refs = 0)
@ -666,10 +667,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* This function compares two strings and returns the result by calling * This function compares two strings and returns the result by calling
* collate::do_compare(). * collate::do_compare().
* *
* @param lo1 Start of string 1. * @param __lo1 Start of string 1.
* @param hi1 End of string 1. * @param __hi1 End of string 1.
* @param lo2 Start of string 2. * @param __lo2 Start of string 2.
* @param hi2 End of string 2. * @param __hi2 End of string 2.
* @return 1 if string1 > string2, -1 if string1 < string2, else 0. * @return 1 if string1 > string2, -1 if string1 < string2, else 0.
*/ */
int int
@ -687,8 +688,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* locales, it may replace two chars with one, change a char for * locales, it may replace two chars with one, change a char for
* another, etc. It does so by returning collate::do_transform(). * another, etc. It does so by returning collate::do_transform().
* *
* @param lo Start of string. * @param __lo Start of string.
* @param hi End of string. * @param __hi End of string.
* @return Transformed string_type. * @return Transformed string_type.
*/ */
string_type string_type
@ -701,8 +702,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* This function computes and returns a hash on the input string. It * This function computes and returns a hash on the input string. It
* does so by returning collate::do_hash(). * does so by returning collate::do_hash().
* *
* @param lo Start of string. * @param __lo Start of string.
* @param hi End of string. * @param __hi End of string.
* @return Hash value. * @return Hash value.
*/ */
long long
@ -728,10 +729,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* This function is a hook for derived classes to change the value * This function is a hook for derived classes to change the value
* returned. @see compare(). * returned. @see compare().
* *
* @param lo1 Start of string 1. * @param __lo1 Start of string 1.
* @param hi1 End of string 1. * @param __hi1 End of string 1.
* @param lo2 Start of string 2. * @param __lo2 Start of string 2.
* @param hi2 End of string 2. * @param __hi2 End of string 2.
* @return 1 if string1 > string2, -1 if string1 < string2, else 0. * @return 1 if string1 > string2, -1 if string1 < string2, else 0.
*/ */
virtual int virtual int
@ -744,11 +745,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* This function is a hook for derived classes to change the value * This function is a hook for derived classes to change the value
* returned. * returned.
* *
* @param lo1 Start of string 1. * @param __lo Start.
* @param hi1 End of string 1. * @param __hi End.
* @param lo2 Start of string 2. * @return transformed string.
* @param hi2 End of string 2.
* @return 1 if string1 > string2, -1 if string1 < string2, else 0.
*/ */
virtual string_type virtual string_type
do_transform(const _CharT* __lo, const _CharT* __hi) const; do_transform(const _CharT* __lo, const _CharT* __hi) const;
@ -759,8 +758,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* This function computes and returns a hash on the input string. This * This function computes and returns a hash on the input string. This
* function is a hook for derived classes to change the value returned. * function is a hook for derived classes to change the value returned.
* *
* @param lo Start of string. * @param __lo Start of string.
* @param hi End of string. * @param __hi End of string.
* @return Hash value. * @return Hash value.
*/ */
virtual long virtual long

619
libstdc++-v3/include/bits/locale_facets.h
View File

File diff suppressed because it is too large Load Diff

331
libstdc++-v3/include/bits/locale_facets_nonio.h
View File

@ -203,8 +203,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* This is a constructor for use by the library itself to set up new * This is a constructor for use by the library itself to set up new
* locales. * locales.
* *
* @param cloc The C locale. * @param __cloc The C locale.
* @param s The name of a locale. * @param __s The name of a locale.
* @param refs Passed to the base facet class. * @param refs Passed to the base facet class.
*/ */
explicit explicit
@ -384,7 +384,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* This is the constructor provided by the standard. * This is the constructor provided by the standard.
* *
* @param refs Passed to the base facet class. * @param __refs Passed to the base facet class.
*/ */
explicit explicit
time_get(size_t __refs = 0) time_get(size_t __refs = 0)
@ -420,11 +420,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* the end, err |= ios_base::failbit. If parsing reads all the * the end, err |= ios_base::failbit. If parsing reads all the
* characters, err |= ios_base::eofbit. * characters, err |= ios_base::eofbit.
* *
* @param beg Start of string to parse. * @param __beg Start of string to parse.
* @param end End of string to parse. * @param __end End of string to parse.
* @param io Source of the locale. * @param __io Source of the locale.
* @param err Error flags to set. * @param __err Error flags to set.
* @param tm Pointer to struct tm to fill in. * @param __tm Pointer to struct tm to fill in.
* @return Iterator to first char beyond time string. * @return Iterator to first char beyond time string.
*/ */
iter_type iter_type
@ -445,11 +445,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* the end, err |= ios_base::failbit. If parsing reads all the * the end, err |= ios_base::failbit. If parsing reads all the
* characters, err |= ios_base::eofbit. * characters, err |= ios_base::eofbit.
* *
* @param beg Start of string to parse. * @param __beg Start of string to parse.
* @param end End of string to parse. * @param __end End of string to parse.
* @param io Source of the locale. * @param __io Source of the locale.
* @param err Error flags to set. * @param __err Error flags to set.
* @param tm Pointer to struct tm to fill in. * @param __tm Pointer to struct tm to fill in.
* @return Iterator to first char beyond date string. * @return Iterator to first char beyond date string.
*/ */
iter_type iter_type
@ -473,11 +473,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* If an error occurs before the end, err |= ios_base::failbit. If * If an error occurs before the end, err |= ios_base::failbit. If
* parsing reads all the characters, err |= ios_base::eofbit. * parsing reads all the characters, err |= ios_base::eofbit.
* *
* @param beg Start of string to parse. * @param __beg Start of string to parse.
* @param end End of string to parse. * @param __end End of string to parse.
* @param io Source of the locale. * @param __io Source of the locale.
* @param err Error flags to set. * @param __err Error flags to set.
* @param tm Pointer to struct tm to fill in. * @param __tm Pointer to struct tm to fill in.
* @return Iterator to first char beyond weekday name. * @return Iterator to first char beyond weekday name.
*/ */
iter_type iter_type
@ -502,11 +502,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* parsing reads all the characters, err |= * parsing reads all the characters, err |=
* ios_base::eofbit. * ios_base::eofbit.
* *
* @param beg Start of string to parse. * @param __beg Start of string to parse.
* @param end End of string to parse. * @param __end End of string to parse.
* @param io Source of the locale. * @param __io Source of the locale.
* @param err Error flags to set. * @param __err Error flags to set.
* @param tm Pointer to struct tm to fill in. * @param __tm Pointer to struct tm to fill in.
* @return Iterator to first char beyond month name. * @return Iterator to first char beyond month name.
*/ */
iter_type iter_type
@ -528,11 +528,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* If an error occurs before the end, err |= ios_base::failbit. If * If an error occurs before the end, err |= ios_base::failbit. If
* parsing reads all the characters, err |= ios_base::eofbit. * parsing reads all the characters, err |= ios_base::eofbit.
* *
* @param beg Start of string to parse. * @param __beg Start of string to parse.
* @param end End of string to parse. * @param __end End of string to parse.
* @param io Source of the locale. * @param __io Source of the locale.
* @param err Error flags to set. * @param __err Error flags to set.
* @param tm Pointer to struct tm to fill in. * @param __tm Pointer to struct tm to fill in.
* @return Iterator to first char beyond year. * @return Iterator to first char beyond year.
*/ */
iter_type iter_type
@ -566,11 +566,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* derived classes to change the value returned. @see get_time() for * derived classes to change the value returned. @see get_time() for
* details. * details.
* *
* @param beg Start of string to parse. * @param __beg Start of string to parse.
* @param end End of string to parse. * @param __end End of string to parse.
* @param io Source of the locale. * @param __io Source of the locale.
* @param err Error flags to set. * @param __err Error flags to set.
* @param tm Pointer to struct tm to fill in. * @param __tm Pointer to struct tm to fill in.
* @return Iterator to first char beyond time string. * @return Iterator to first char beyond time string.
*/ */
virtual iter_type virtual iter_type
@ -585,11 +585,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* derived classes to change the value returned. @see get_date() for * derived classes to change the value returned. @see get_date() for
* details. * details.
* *
* @param beg Start of string to parse. * @param __beg Start of string to parse.
* @param end End of string to parse. * @param __end End of string to parse.
* @param io Source of the locale. * @param __io Source of the locale.
* @param err Error flags to set. * @param __err Error flags to set.
* @param tm Pointer to struct tm to fill in. * @param __tm Pointer to struct tm to fill in.
* @return Iterator to first char beyond date string. * @return Iterator to first char beyond date string.
*/ */
virtual iter_type virtual iter_type
@ -604,11 +604,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* classes to change the value returned. @see get_weekday() for * classes to change the value returned. @see get_weekday() for
* details. * details.
* *
* @param beg Start of string to parse. * @param __beg Start of string to parse.
* @param end End of string to parse. * @param __end End of string to parse.
* @param io Source of the locale. * @param __io Source of the locale.
* @param err Error flags to set. * @param __err Error flags to set.
* @param tm Pointer to struct tm to fill in. * @param __tm Pointer to struct tm to fill in.
* @return Iterator to first char beyond weekday name. * @return Iterator to first char beyond weekday name.
*/ */
virtual iter_type virtual iter_type
@ -623,11 +623,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* classes to change the value returned. @see get_monthname() for * classes to change the value returned. @see get_monthname() for
* details. * details.
* *
* @param beg Start of string to parse. * @param __beg Start of string to parse.
* @param end End of string to parse. * @param __end End of string to parse.
* @param io Source of the locale. * @param __io Source of the locale.
* @param err Error flags to set. * @param __err Error flags to set.
* @param tm Pointer to struct tm to fill in. * @param __tm Pointer to struct tm to fill in.
* @return Iterator to first char beyond month name. * @return Iterator to first char beyond month name.
*/ */
virtual iter_type virtual iter_type
@ -642,11 +642,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* hook for derived classes to change the value returned. @see * hook for derived classes to change the value returned. @see
* get_year() for details. * get_year() for details.
* *
* @param beg Start of string to parse. * @param __beg Start of string to parse.
* @param end End of string to parse. * @param __end End of string to parse.
* @param io Source of the locale. * @param __io Source of the locale.
* @param err Error flags to set. * @param __err Error flags to set.
* @param tm Pointer to struct tm to fill in. * @param __tm Pointer to struct tm to fill in.
* @return Iterator to first char beyond year. * @return Iterator to first char beyond year.
*/ */
virtual iter_type virtual iter_type
@ -730,7 +730,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* This is the constructor provided by the standard. * This is the constructor provided by the standard.
* *
* @param refs Passed to the base facet class. * @param __refs Passed to the base facet class.
*/ */
explicit explicit
time_put(size_t __refs = 0) time_put(size_t __refs = 0)
@ -743,12 +743,12 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* provided format string. The format string is interpreted as by * provided format string. The format string is interpreted as by
* strftime(). * strftime().
* *
* @param s The stream to write to. * @param __s The stream to write to.
* @param io Source of locale. * @param __io Source of locale.
* @param fill char_type to use for padding. * @param __fill char_type to use for padding.
* @param tm Struct tm with date and time info to format. * @param __tm Struct tm with date and time info to format.
* @param beg Start of format string. * @param __beg Start of format string.
* @param end End of format string. * @param __end End of format string.
* @return Iterator after writing. * @return Iterator after writing.
*/ */
iter_type iter_type
@ -763,12 +763,12 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* are interpreted as by strftime(). It does so by returning * are interpreted as by strftime(). It does so by returning
* time_put::do_put(). * time_put::do_put().
* *
* @param s The stream to write to. * @param __s The stream to write to.
* @param io Source of locale. * @param __io Source of locale.
* @param fill char_type to use for padding. * @param __fill char_type to use for padding.
* @param tm Struct tm with date and time info to format. * @param __tm Struct tm with date and time info to format.
* @param format Format char. * @param __format Format char.
* @param mod Optional modifier char. * @param __mod Optional modifier char.
* @return Iterator after writing. * @return Iterator after writing.
*/ */
iter_type iter_type
@ -790,12 +790,12 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* for derived classes to change the value returned. @see put() for * for derived classes to change the value returned. @see put() for
* more details. * more details.
* *
* @param s The stream to write to. * @param __s The stream to write to.
* @param io Source of locale. * @param __io Source of locale.
* @param fill char_type to use for padding. * @param __fill char_type to use for padding.
* @param tm Struct tm with date and time info to format. * @param __tm Struct tm with date and time info to format.
* @param format Format char. * @param __format Format char.
* @param mod Optional modifier char. * @param __mod Optional modifier char.
* @return Iterator after writing. * @return Iterator after writing.
*/ */
virtual iter_type virtual iter_type
@ -957,7 +957,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* This is the constructor provided by the standard. * This is the constructor provided by the standard.
* *
* @param refs Passed to the base facet class. * @param __refs Passed to the base facet class.
*/ */
explicit explicit
moneypunct(size_t __refs = 0) moneypunct(size_t __refs = 0)
@ -969,8 +969,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* This is an internal constructor. * This is an internal constructor.
* *
* @param cache Cache for optimization. * @param __cache Cache for optimization.
* @param refs Passed to the base facet class. * @param __refs Passed to the base facet class.
*/ */
explicit explicit
moneypunct(__cache_type* __cache, size_t __refs = 0) moneypunct(__cache_type* __cache, size_t __refs = 0)
@ -983,9 +983,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* This is a constructor for use by the library itself to set up new * This is a constructor for use by the library itself to set up new
* locales. * locales.
* *
* @param cloc The C locale. * @param __cloc The C locale.
* @param s The name of a locale. * @param __s The name of a locale.
* @param refs Passed to the base facet class. * @param __refs Passed to the base facet class.
*/ */
explicit explicit
moneypunct(__c_locale __cloc, const char* __s, size_t __refs = 0) moneypunct(__c_locale __cloc, const char* __s, size_t __refs = 0)
@ -1386,7 +1386,7 @@ _GLIBCXX_BEGIN_NAMESPACE_LDBL
* *
* This is the constructor provided by the standard. * This is the constructor provided by the standard.
* *
* @param refs Passed to the base facet class. * @param __refs Passed to the base facet class.
*/ */
explicit explicit
money_get(size_t __refs = 0) : facet(__refs) { } money_get(size_t __refs = 0) : facet(__refs) { }
@ -1394,7 +1394,7 @@ _GLIBCXX_BEGIN_NAMESPACE_LDBL
/** /**
* @brief Read and parse a monetary value. * @brief Read and parse a monetary value.
* *
* This function reads characters from @a s, interprets them as a * This function reads characters from @a __s, interprets them as a
* monetary value according to moneypunct and ctype facets retrieved * monetary value according to moneypunct and ctype facets retrieved
* from io.getloc(), and returns the result in @a units as an integral * from io.getloc(), and returns the result in @a units as an integral
* value moneypunct::frac_digits() * the actual amount. For example, * value moneypunct::frac_digits() * the actual amount. For example,
@ -1409,12 +1409,12 @@ _GLIBCXX_BEGIN_NAMESPACE_LDBL
* *
* This function works by returning the result of do_get(). * This function works by returning the result of do_get().
* *
* @param s Start of characters to parse. * @param __s Start of characters to parse.
* @param end End of characters to parse. * @param __end End of characters to parse.
* @param intl Parameter to use_facet<moneypunct<CharT,intl> >. * @param __intl Parameter to use_facet<moneypunct<CharT,intl> >.
* @param io Source of facets and io state. * @param __io Source of facets and io state.
* @param err Error field to set if parsing fails. * @param __err Error field to set if parsing fails.
* @param units Place to store result of parsing. * @param __units Place to store result of parsing.
* @return Iterator referencing first character beyond valid money * @return Iterator referencing first character beyond valid money
* amount. * amount.
*/ */
@ -1426,7 +1426,7 @@ _GLIBCXX_BEGIN_NAMESPACE_LDBL
/** /**
* @brief Read and parse a monetary value. * @brief Read and parse a monetary value.
* *
* This function reads characters from @a s, interprets them as * This function reads characters from @a __s, interprets them as
* a monetary value according to moneypunct and ctype facets * a monetary value according to moneypunct and ctype facets
* retrieved from io.getloc(), and returns the result in @a * retrieved from io.getloc(), and returns the result in @a
* digits. For example, the string $10.01 in a US locale would * digits. For example, the string $10.01 in a US locale would
@ -1440,12 +1440,12 @@ _GLIBCXX_BEGIN_NAMESPACE_LDBL
* *
* This function works by returning the result of do_get(). * This function works by returning the result of do_get().
* *
* @param s Start of characters to parse. * @param __s Start of characters to parse.
* @param end End of characters to parse. * @param __end End of characters to parse.
* @param intl Parameter to use_facet<moneypunct<CharT,intl> >. * @param __intl Parameter to use_facet<moneypunct<CharT,intl> >.
* @param io Source of facets and io state. * @param __io Source of facets and io state.
* @param err Error field to set if parsing fails. * @param __err Error field to set if parsing fails.
* @param digits Place to store result of parsing. * @param __digits Place to store result of parsing.
* @return Iterator referencing first character beyond valid money * @return Iterator referencing first character beyond valid money
* amount. * amount.
*/ */
@ -1536,7 +1536,7 @@ _GLIBCXX_BEGIN_NAMESPACE_LDBL
* *
* This is the constructor provided by the standard. * This is the constructor provided by the standard.
* *
* @param refs Passed to the base facet class. * @param __refs Passed to the base facet class.
*/ */
explicit explicit
money_put(size_t __refs = 0) : facet(__refs) { } money_put(size_t __refs = 0) : facet(__refs) { }
@ -1546,16 +1546,16 @@ _GLIBCXX_BEGIN_NAMESPACE_LDBL
* *
* This function formats @a units as a monetary value according to * This function formats @a units as a monetary value according to
* moneypunct and ctype facets retrieved from io.getloc(), and writes * moneypunct and ctype facets retrieved from io.getloc(), and writes
* the resulting characters to @a s. For example, the value 1001 in a * the resulting characters to @a __s. For example, the value 1001 in a
* US locale would write <code>$10.01</code> to @a s. * US locale would write <code>$10.01</code> to @a __s.
* *
* This function works by returning the result of do_put(). * This function works by returning the result of do_put().
* *
* @param s The stream to write to. * @param __s The stream to write to.
* @param intl Parameter to use_facet<moneypunct<CharT,intl> >. * @param __intl Parameter to use_facet<moneypunct<CharT,intl> >.
* @param io Source of facets and io state. * @param __io Source of facets and io state.
* @param fill char_type to use for padding. * @param __fill char_type to use for padding.
* @param units Place to store result of parsing. * @param __units Place to store result of parsing.
* @return Iterator after writing. * @return Iterator after writing.
*/ */
iter_type iter_type
@ -1568,17 +1568,17 @@ _GLIBCXX_BEGIN_NAMESPACE_LDBL
* *
* This function formats @a digits as a monetary value * This function formats @a digits as a monetary value
* according to moneypunct and ctype facets retrieved from * according to moneypunct and ctype facets retrieved from
* io.getloc(), and writes the resulting characters to @a s. * io.getloc(), and writes the resulting characters to @a __s.
* For example, the string <code>1001</code> in a US locale * For example, the string <code>1001</code> in a US locale
* would write <code>$10.01</code> to @a s. * would write <code>$10.01</code> to @a __s.
* *
* This function works by returning the result of do_put(). * This function works by returning the result of do_put().
* *
* @param s The stream to write to. * @param __s The stream to write to.
* @param intl Parameter to use_facet<moneypunct<CharT,intl> >. * @param __intl Parameter to use_facet<moneypunct<CharT,intl> >.
* @param io Source of facets and io state. * @param __io Source of facets and io state.
* @param fill char_type to use for padding. * @param __fill char_type to use for padding.
* @param units Place to store result of parsing. * @param __digits Place to store result of parsing.
* @return Iterator after writing. * @return Iterator after writing.
*/ */
iter_type iter_type
@ -1596,17 +1596,17 @@ _GLIBCXX_BEGIN_NAMESPACE_LDBL
* *
* This function formats @a units as a monetary value according to * This function formats @a units as a monetary value according to
* moneypunct and ctype facets retrieved from io.getloc(), and writes * moneypunct and ctype facets retrieved from io.getloc(), and writes
* the resulting characters to @a s. For example, the value 1001 in a * the resulting characters to @a __s. For example, the value 1001 in a
* US locale would write <code>$10.01</code> to @a s. * US locale would write <code>$10.01</code> to @a __s.
* *
* This function is a hook for derived classes to change the value * This function is a hook for derived classes to change the value
* returned. @see put(). * returned. @see put().
* *
* @param s The stream to write to. * @param __s The stream to write to.
* @param intl Parameter to use_facet<moneypunct<CharT,intl> >. * @param __intl Parameter to use_facet<moneypunct<CharT,intl> >.
* @param io Source of facets and io state. * @param __io Source of facets and io state.
* @param fill char_type to use for padding. * @param __fill char_type to use for padding.
* @param units Place to store result of parsing. * @param __units Place to store result of parsing.
* @return Iterator after writing. * @return Iterator after writing.
*/ */
// XXX GLIBCXX_ABI Deprecated // XXX GLIBCXX_ABI Deprecated
@ -1625,18 +1625,18 @@ _GLIBCXX_BEGIN_NAMESPACE_LDBL
* *
* This function formats @a digits as a monetary value * This function formats @a digits as a monetary value
* according to moneypunct and ctype facets retrieved from * according to moneypunct and ctype facets retrieved from
* io.getloc(), and writes the resulting characters to @a s. * io.getloc(), and writes the resulting characters to @a __s.
* For example, the string <code>1001</code> in a US locale * For example, the string <code>1001</code> in a US locale
* would write <code>$10.01</code> to @a s. * would write <code>$10.01</code> to @a __s.
* *
* This function is a hook for derived classes to change the value * This function is a hook for derived classes to change the value
* returned. @see put(). * returned. @see put().
* *
* @param s The stream to write to. * @param __s The stream to write to.
* @param intl Parameter to use_facet<moneypunct<CharT,intl> >. * @param __intl Parameter to use_facet<moneypunct<CharT,intl> >.
* @param io Source of facets and io state. * @param __io Source of facets and io state.
* @param fill char_type to use for padding. * @param __fill char_type to use for padding.
* @param units Place to store result of parsing. * @param __digits Place to store result of parsing.
* @return Iterator after writing. * @return Iterator after writing.
*/ */
virtual iter_type virtual iter_type
@ -1717,7 +1717,7 @@ _GLIBCXX_END_NAMESPACE_LDBL
* *
* This is the constructor provided by the standard. * This is the constructor provided by the standard.
* *
* @param refs Passed to the base facet class. * @param __refs Passed to the base facet class.
*/ */
explicit explicit
messages(size_t __refs = 0); messages(size_t __refs = 0);
@ -1729,9 +1729,9 @@ _GLIBCXX_END_NAMESPACE_LDBL
* This is a constructor for use by the library itself to set up new * This is a constructor for use by the library itself to set up new
* locales. * locales.
* *
* @param cloc The C locale. * @param __cloc The C locale.
* @param s The name of a locale. * @param __s The name of a locale.
* @param refs Refcount to pass to the base class. * @param __refs Refcount to pass to the base class.
*/ */
explicit explicit
messages(__c_locale __cloc, const char* __s, size_t __refs = 0); messages(__c_locale __cloc, const char* __s, size_t __refs = 0);
@ -1740,10 +1740,10 @@ _GLIBCXX_END_NAMESPACE_LDBL
* @brief Open a message catalog. * @brief Open a message catalog.
* *
* This function opens and returns a handle to a message catalog by * This function opens and returns a handle to a message catalog by
* returning do_open(s, loc). * returning do_open(__s, __loc).
* *
* @param s The catalog to open. * @param __s The catalog to open.
* @param loc Locale to use for character set conversions. * @param __loc Locale to use for character set conversions.
* @return Handle to the catalog or value < 0 if open fails. * @return Handle to the catalog or value < 0 if open fails.
*/ */
catalog catalog
@ -1759,9 +1759,9 @@ _GLIBCXX_END_NAMESPACE_LDBL
* message catalog root directory for gnu gettext and is ignored * message catalog root directory for gnu gettext and is ignored
* otherwise. * otherwise.
* *
* @param s The catalog to open. * @param __s The catalog to open.
* @param loc Locale to use for character set conversions. * @param __loc Locale to use for character set conversions.
* @param dir Message catalog root directory. * @param __dir Message catalog root directory.
* @return Handle to the catalog or value < 0 if open fails. * @return Handle to the catalog or value < 0 if open fails.
*/ */
catalog catalog
@ -1773,14 +1773,14 @@ _GLIBCXX_END_NAMESPACE_LDBL
* This function retrieves and returns a message from a catalog by * This function retrieves and returns a message from a catalog by
* returning do_get(c, set, msgid, s). * returning do_get(c, set, msgid, s).
* *
* For gnu, @a set and @a msgid are ignored. Returns gettext(s). * For gnu, @a __set and @a msgid are ignored. Returns gettext(s).
* For default, returns s. For ieee, returns catgets(c,set,msgid,s). * For default, returns s. For ieee, returns catgets(c,set,msgid,s).
* *
* @param c The catalog to access. * @param __c The catalog to access.
* @param set Implementation-defined. * @param __set Implementation-defined.
* @param msgid Implementation-defined. * @param __msgid Implementation-defined.
* @param s Default return value if retrieval fails. * @param __s Default return value if retrieval fails.
* @return Retrieved message or @a s if get fails. * @return Retrieved message or @a __s if get fails.
*/ */
string_type string_type
get(catalog __c, int __set, int __msgid, const string_type& __s) const get(catalog __c, int __set, int __msgid, const string_type& __s) const
@ -1791,7 +1791,7 @@ _GLIBCXX_END_NAMESPACE_LDBL
* *
* Closes catalog @a c by calling do_close(c). * Closes catalog @a c by calling do_close(c).
* *
* @param c The catalog to close. * @param __c The catalog to close.
*/ */
void void
close(catalog __c) const close(catalog __c) const
@ -1809,8 +1809,8 @@ _GLIBCXX_END_NAMESPACE_LDBL
* implementation-defined manner. This function is a hook for derived * implementation-defined manner. This function is a hook for derived
* classes to change the value returned. * classes to change the value returned.
* *
* @param s The catalog to open. * @param __s The catalog to open.
* @param loc Locale to use for character set conversions. * @param __loc Locale to use for character set conversions.
* @return Handle to the opened catalog, value < 0 if open failed. * @return Handle to the opened catalog, value < 0 if open failed.
*/ */
virtual catalog virtual catalog
@ -1823,14 +1823,14 @@ _GLIBCXX_END_NAMESPACE_LDBL
* implementation-defined manner. This function is a hook for derived * implementation-defined manner. This function is a hook for derived
* classes to change the value returned. * classes to change the value returned.
* *
* For gnu, @a set and @a msgid are ignored. Returns gettext(s). * For gnu, @a __set and @a __msgid are ignored. Returns gettext(s).
* For default, returns s. For ieee, returns catgets(c,set,msgid,s). * For default, returns s. For ieee, returns catgets(c,set,msgid,s).
* *
* @param c The catalog to access. * @param __c The catalog to access.
* @param set Implementation-defined. * @param __set Implementation-defined.
* @param msgid Implementation-defined. * @param __msgid Implementation-defined.
* @param s Default return value if retrieval fails. * @param __s Default return value if retrieval fails.
* @return Retrieved message or @a s if get fails. * @return Retrieved message or @a __s if get fails.
*/ */
virtual string_type virtual string_type
do_get(catalog, int, int, const string_type& __dfault) const; do_get(catalog, int, int, const string_type& __dfault) const;
@ -1838,7 +1838,7 @@ _GLIBCXX_END_NAMESPACE_LDBL
/* /*
* @brief Close a message catalog. * @brief Close a message catalog.
* *
* @param c The catalog to close. * @param __c The catalog to close.
*/ */
virtual void virtual void
do_close(catalog) const; do_close(catalog) const;
@ -1855,40 +1855,7 @@ _GLIBCXX_END_NAMESPACE_LDBL
string_type string_type
_M_convert_from_char(char*) const _M_convert_from_char(char*) const
{ {
#if 0 // XXX
// Length of message string without terminating null.
size_t __len = char_traits<char>::length(__msg) - 1;
// "everybody can easily convert the string using
// mbsrtowcs/wcsrtombs or with iconv()"
// Convert char* to _CharT in locale used to open catalog.
// XXX need additional template parameter on messages class for this..
// typedef typename codecvt<char, _CharT, _StateT> __codecvt_type;
typedef typename codecvt<char, _CharT, mbstate_t> __codecvt_type;
__codecvt_type::state_type __state;
// XXX may need to initialize state.
//initialize_state(__state._M_init());
char* __from_next;
// XXX what size for this string?
_CharT* __to = static_cast<_CharT*>(__builtin_alloca(__len + 1));
const __codecvt_type& __cvt = use_facet<__codecvt_type>(_M_locale_conv);
__cvt.out(__state, __msg, __msg + __len, __from_next,
__to, __to + __len + 1, __to_next);
return string_type(__to);
#endif
#if 0
typedef ctype<_CharT> __ctype_type;
// const __ctype_type& __cvt = use_facet<__ctype_type>(_M_locale_msg);
const __ctype_type& __cvt = use_facet<__ctype_type>(locale());
// XXX Again, proper length of converted string an issue here.
// For now, assume the converted length is not larger.
_CharT* __dest = static_cast<_CharT*>(__builtin_alloca(__len + 1));
__cvt.widen(__msg, __msg + __len, __dest);
return basic_string<_CharT>(__dest);
#endif
return string_type(); return string_type();
} }
}; };

4
libstdc++-v3/include/bits/ptr_traits.h
View File

@ -207,8 +207,8 @@ _GLIBCXX_HAS_NESTED_TYPE(difference_type)
/** /**
* @brief Obtain a pointer to an object * @brief Obtain a pointer to an object
* @param r A reference to an object of type @c element_type * @param __r A reference to an object of type @c element_type
* @return @c addressof(r) * @return @c addressof(__r)
*/ */
static pointer static pointer
pointer_to(typename __ptrtr_not_void<element_type>::__type& __r) noexcept pointer_to(typename __ptrtr_not_void<element_type>::__type& __r) noexcept

237
libstdc++-v3/include/bits/random.h
View File

@ -294,9 +294,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _UIntType1, _UIntType1 __a1, _UIntType1 __c1, template<typename _UIntType1, _UIntType1 __a1, _UIntType1 __c1,
_UIntType1 __m1, typename _CharT, typename _Traits> _UIntType1 __m1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::linear_congruential_engine<_UIntType1, const std::linear_congruential_engine<_UIntType1,
__a1, __c1, __m1>&); __a1, __c1, __m1>& __lcr);
/** /**
* @brief Sets the state of the engine by reading its textual * @brief Sets the state of the engine by reading its textual
@ -314,9 +314,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _UIntType1, _UIntType1 __a1, _UIntType1 __c1, template<typename _UIntType1, _UIntType1 __a1, _UIntType1 __c1,
_UIntType1 __m1, typename _CharT, typename _Traits> _UIntType1 __m1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::linear_congruential_engine<_UIntType1, __a1, std::linear_congruential_engine<_UIntType1, __a1,
__c1, __m1>&); __c1, __m1>& __lcr);
private: private:
_UIntType _M_x; _UIntType _M_x;
@ -355,17 +355,20 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* This algorithm was originally invented by Makoto Matsumoto and * This algorithm was originally invented by Makoto Matsumoto and
* Takuji Nishimura. * Takuji Nishimura.
* *
* @var word_size The number of bits in each element of the state vector. * @tparam __w Word size, the number of bits in each element of
* @var state_size The degree of recursion. * the state vector.
* @var shift_size The period parameter. * @tparam __n The degree of recursion.
* @var mask_bits The separation point bit index. * @tparam __m The period parameter.
* @var parameter_a The last row of the twist matrix. * @tparam __r The separation point bit index.
* @var output_u The first right-shift tempering matrix parameter. * @tparam __a The last row of the twist matrix.
* @var output_s The first left-shift tempering matrix parameter. * @tparam __u The first right-shift tempering matrix parameter.
* @var output_b The first left-shift tempering matrix mask. * @tparam __d The first right-shift tempering matrix mask.
* @var output_t The second left-shift tempering matrix parameter. * @tparam __s The first left-shift tempering matrix parameter.
* @var output_c The second left-shift tempering matrix mask. * @tparam __b The first left-shift tempering matrix mask.
* @var output_l The second right-shift tempering matrix parameter. * @tparam __t The second left-shift tempering matrix parameter.
* @tparam __c The second left-shift tempering matrix mask.
* @tparam __l The second right-shift tempering matrix parameter.
* @tparam __f Initialization multiplier.
*/ */
template<typename _UIntType, size_t __w, template<typename _UIntType, size_t __w,
size_t __n, size_t __m, size_t __r, size_t __n, size_t __m, size_t __r,
@ -511,10 +514,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
_UIntType1 __c1, size_t __l1, _UIntType1 __f1, _UIntType1 __c1, size_t __l1, _UIntType1 __f1,
typename _CharT, typename _Traits> typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::mersenne_twister_engine<_UIntType1, __w1, __n1, const std::mersenne_twister_engine<_UIntType1, __w1, __n1,
__m1, __r1, __a1, __u1, __d1, __s1, __b1, __t1, __c1, __m1, __r1, __a1, __u1, __d1, __s1, __b1, __t1, __c1,
__l1, __f1>&); __l1, __f1>& __x);
/** /**
* @brief Extracts the current state of a % mersenne_twister_engine * @brief Extracts the current state of a % mersenne_twister_engine
@ -537,10 +540,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
_UIntType1 __c1, size_t __l1, _UIntType1 __f1, _UIntType1 __c1, size_t __l1, _UIntType1 __f1,
typename _CharT, typename _Traits> typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::mersenne_twister_engine<_UIntType1, __w1, __n1, __m1, std::mersenne_twister_engine<_UIntType1, __w1, __n1, __m1,
__r1, __a1, __u1, __d1, __s1, __b1, __t1, __c1, __r1, __a1, __u1, __d1, __s1, __b1, __t1, __c1,
__l1, __f1>&); __l1, __f1>& __x);
private: private:
_UIntType _M_x[state_size]; _UIntType _M_x[state_size];
@ -801,21 +804,21 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* @brief Copy constructs a %discard_block_engine engine. * @brief Copy constructs a %discard_block_engine engine.
* *
* Copies an existing base class random number generator. * Copies an existing base class random number generator.
* @param rng An existing (base class) engine object. * @param __rng An existing (base class) engine object.
*/ */
explicit explicit
discard_block_engine(const _RandomNumberEngine& __rne) discard_block_engine(const _RandomNumberEngine& __rng)
: _M_b(__rne), _M_n(0) { } : _M_b(__rng), _M_n(0) { }
/** /**
* @brief Move constructs a %discard_block_engine engine. * @brief Move constructs a %discard_block_engine engine.
* *
* Copies an existing base class random number generator. * Copies an existing base class random number generator.
* @param rng An existing (base class) engine object. * @param __rng An existing (base class) engine object.
*/ */
explicit explicit
discard_block_engine(_RandomNumberEngine&& __rne) discard_block_engine(_RandomNumberEngine&& __rng)
: _M_b(std::move(__rne)), _M_n(0) { } : _M_b(std::move(__rng)), _M_n(0) { }
/** /**
* @brief Seed constructs a %discard_block_engine engine. * @brief Seed constructs a %discard_block_engine engine.
@ -944,9 +947,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _RandomNumberEngine1, size_t __p1, size_t __r1, template<typename _RandomNumberEngine1, size_t __p1, size_t __r1,
typename _CharT, typename _Traits> typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::discard_block_engine<_RandomNumberEngine1, const std::discard_block_engine<_RandomNumberEngine1,
__p1, __r1>&); __p1, __r1>& __x);
/** /**
* @brief Extracts the current state of a % subtract_with_carry_engine * @brief Extracts the current state of a % subtract_with_carry_engine
@ -962,9 +965,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _RandomNumberEngine1, size_t __p1, size_t __r1, template<typename _RandomNumberEngine1, size_t __p1, size_t __r1,
typename _CharT, typename _Traits> typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::discard_block_engine<_RandomNumberEngine1, std::discard_block_engine<_RandomNumberEngine1,
__p1, __r1>&); __p1, __r1>& __x);
private: private:
_RandomNumberEngine _M_b; _RandomNumberEngine _M_b;
@ -1019,21 +1022,21 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* @brief Copy constructs a %independent_bits_engine engine. * @brief Copy constructs a %independent_bits_engine engine.
* *
* Copies an existing base class random number generator. * Copies an existing base class random number generator.
* @param rng An existing (base class) engine object. * @param __rng An existing (base class) engine object.
*/ */
explicit explicit
independent_bits_engine(const _RandomNumberEngine& __rne) independent_bits_engine(const _RandomNumberEngine& __rng)
: _M_b(__rne) { } : _M_b(__rng) { }
/** /**
* @brief Move constructs a %independent_bits_engine engine. * @brief Move constructs a %independent_bits_engine engine.
* *
* Copies an existing base class random number generator. * Copies an existing base class random number generator.
* @param rng An existing (base class) engine object. * @param __rng An existing (base class) engine object.
*/ */
explicit explicit
independent_bits_engine(_RandomNumberEngine&& __rne) independent_bits_engine(_RandomNumberEngine&& __rng)
: _M_b(std::move(__rne)) { } : _M_b(std::move(__rng)) { }
/** /**
* @brief Seed constructs a %independent_bits_engine engine. * @brief Seed constructs a %independent_bits_engine engine.
@ -1238,22 +1241,22 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* @brief Copy constructs a %shuffle_order_engine engine. * @brief Copy constructs a %shuffle_order_engine engine.
* *
* Copies an existing base class random number generator. * Copies an existing base class random number generator.
* @param rng An existing (base class) engine object. * @param __rng An existing (base class) engine object.
*/ */
explicit explicit
shuffle_order_engine(const _RandomNumberEngine& __rne) shuffle_order_engine(const _RandomNumberEngine& __rng)
: _M_b(__rne) : _M_b(__rng)
{ _M_initialize(); } { _M_initialize(); }
/** /**
* @brief Move constructs a %shuffle_order_engine engine. * @brief Move constructs a %shuffle_order_engine engine.
* *
* Copies an existing base class random number generator. * Copies an existing base class random number generator.
* @param rng An existing (base class) engine object. * @param __rng An existing (base class) engine object.
*/ */
explicit explicit
shuffle_order_engine(_RandomNumberEngine&& __rne) shuffle_order_engine(_RandomNumberEngine&& __rng)
: _M_b(std::move(__rne)) : _M_b(std::move(__rng))
{ _M_initialize(); } { _M_initialize(); }
/** /**
@ -1383,9 +1386,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _RandomNumberEngine1, size_t __k1, template<typename _RandomNumberEngine1, size_t __k1,
typename _CharT, typename _Traits> typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::shuffle_order_engine<_RandomNumberEngine1, const std::shuffle_order_engine<_RandomNumberEngine1,
__k1>&); __k1>& __x);
/** /**
* @brief Extracts the current state of a % subtract_with_carry_engine * @brief Extracts the current state of a % subtract_with_carry_engine
@ -1401,8 +1404,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _RandomNumberEngine1, size_t __k1, template<typename _RandomNumberEngine1, size_t __k1,
typename _CharT, typename _Traits> typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::shuffle_order_engine<_RandomNumberEngine1, __k1>&); std::shuffle_order_engine<_RandomNumberEngine1, __k1>& __x);
private: private:
void _M_initialize() void _M_initialize()
@ -1816,8 +1819,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Constructs a uniform_real_distribution object. * @brief Constructs a uniform_real_distribution object.
* *
* @param __min [IN] The lower bound of the distribution. * @param __a [IN] The lower bound of the distribution.
* @param __max [IN] The upper bound of the distribution. * @param __b [IN] The upper bound of the distribution.
*/ */
explicit explicit
uniform_real_distribution(_RealType __a = _RealType(0), uniform_real_distribution(_RealType __a = _RealType(0),
@ -2104,8 +2107,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::normal_distribution<_RealType1>&); const std::normal_distribution<_RealType1>& __x);
/** /**
* @brief Extracts a %normal_distribution random number distribution * @brief Extracts a %normal_distribution random number distribution
@ -2119,8 +2122,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::normal_distribution<_RealType1>&); std::normal_distribution<_RealType1>& __x);
private: private:
param_type _M_param; param_type _M_param;
@ -2280,8 +2283,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::lognormal_distribution<_RealType1>&); const std::lognormal_distribution<_RealType1>& __x);
/** /**
* @brief Extracts a %lognormal_distribution random number distribution * @brief Extracts a %lognormal_distribution random number distribution
@ -2295,8 +2298,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::lognormal_distribution<_RealType1>&); std::lognormal_distribution<_RealType1>& __x);
private: private:
param_type _M_param; param_type _M_param;
@ -2473,8 +2476,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::gamma_distribution<_RealType1>&); const std::gamma_distribution<_RealType1>& __x);
/** /**
* @brief Extracts a %gamma_distribution random number distribution * @brief Extracts a %gamma_distribution random number distribution
@ -2487,8 +2490,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::gamma_distribution<_RealType1>&); std::gamma_distribution<_RealType1>& __x);
private: private:
param_type _M_param; param_type _M_param;
@ -2637,8 +2640,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::chi_squared_distribution<_RealType1>&); const std::chi_squared_distribution<_RealType1>& __x);
/** /**
* @brief Extracts a %chi_squared_distribution random number distribution * @brief Extracts a %chi_squared_distribution random number distribution
@ -2652,8 +2655,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::chi_squared_distribution<_RealType1>&); std::chi_squared_distribution<_RealType1>& __x);
private: private:
param_type _M_param; param_type _M_param;
@ -2821,8 +2824,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType, typename _CharT, typename _Traits> template<typename _RealType, typename _CharT, typename _Traits>
std::basic_ostream<_CharT, _Traits>& std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::cauchy_distribution<_RealType>&); const std::cauchy_distribution<_RealType>& __x);
/** /**
* @brief Extracts a %cauchy_distribution random number distribution * @brief Extracts a %cauchy_distribution random number distribution
@ -2836,8 +2839,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType, typename _CharT, typename _Traits> template<typename _RealType, typename _CharT, typename _Traits>
std::basic_istream<_CharT, _Traits>& std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::cauchy_distribution<_RealType>&); std::cauchy_distribution<_RealType>& __x);
/** /**
@ -2992,8 +2995,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::fisher_f_distribution<_RealType1>&); const std::fisher_f_distribution<_RealType1>& __x);
/** /**
* @brief Extracts a %fisher_f_distribution random number distribution * @brief Extracts a %fisher_f_distribution random number distribution
@ -3007,8 +3010,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::fisher_f_distribution<_RealType1>&); std::fisher_f_distribution<_RealType1>& __x);
private: private:
param_type _M_param; param_type _M_param;
@ -3165,8 +3168,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::student_t_distribution<_RealType1>&); const std::student_t_distribution<_RealType1>& __x);
/** /**
* @brief Extracts a %student_t_distribution random number distribution * @brief Extracts a %student_t_distribution random number distribution
@ -3180,8 +3183,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::student_t_distribution<_RealType1>&); std::student_t_distribution<_RealType1>& __x);
private: private:
param_type _M_param; param_type _M_param;
@ -3359,8 +3362,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _CharT, typename _Traits> template<typename _CharT, typename _Traits>
std::basic_ostream<_CharT, _Traits>& std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::bernoulli_distribution&); const std::bernoulli_distribution& __x);
/** /**
* @brief Extracts a %bernoulli_distribution random number distribution * @brief Extracts a %bernoulli_distribution random number distribution
@ -3545,8 +3548,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _IntType1, template<typename _IntType1,
typename _CharT, typename _Traits> typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::binomial_distribution<_IntType1>&); const std::binomial_distribution<_IntType1>& __x);
/** /**
* @brief Extracts a %binomial_distribution random number distribution * @brief Extracts a %binomial_distribution random number distribution
@ -3561,8 +3564,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _IntType1, template<typename _IntType1,
typename _CharT, typename _Traits> typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::binomial_distribution<_IntType1>&); std::binomial_distribution<_IntType1>& __x);
private: private:
template<typename _UniformRandomNumberGenerator> template<typename _UniformRandomNumberGenerator>
@ -3738,8 +3741,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _IntType, template<typename _IntType,
typename _CharT, typename _Traits> typename _CharT, typename _Traits>
std::basic_ostream<_CharT, _Traits>& std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::geometric_distribution<_IntType>&); const std::geometric_distribution<_IntType>& __x);
/** /**
* @brief Extracts a %geometric_distribution random number distribution * @brief Extracts a %geometric_distribution random number distribution
@ -3753,8 +3756,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _IntType, template<typename _IntType,
typename _CharT, typename _Traits> typename _CharT, typename _Traits>
std::basic_istream<_CharT, _Traits>& std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::geometric_distribution<_IntType>&); std::geometric_distribution<_IntType>& __x);
/** /**
@ -3898,8 +3901,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _IntType1, typename _CharT, typename _Traits> template<typename _IntType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::negative_binomial_distribution<_IntType1>&); const std::negative_binomial_distribution<_IntType1>& __x);
/** /**
* @brief Extracts a %negative_binomial_distribution random number * @brief Extracts a %negative_binomial_distribution random number
@ -3913,8 +3916,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _IntType1, typename _CharT, typename _Traits> template<typename _IntType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::negative_binomial_distribution<_IntType1>&); std::negative_binomial_distribution<_IntType1>& __x);
private: private:
param_type _M_param; param_type _M_param;
@ -4085,8 +4088,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _IntType1, typename _CharT, typename _Traits> template<typename _IntType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::poisson_distribution<_IntType1>&); const std::poisson_distribution<_IntType1>& __x);
/** /**
* @brief Extracts a %poisson_distribution random number distribution * @brief Extracts a %poisson_distribution random number distribution
@ -4100,8 +4103,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _IntType1, typename _CharT, typename _Traits> template<typename _IntType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::poisson_distribution<_IntType1>&); std::poisson_distribution<_IntType1>& __x);
private: private:
param_type _M_param; param_type _M_param;
@ -4281,8 +4284,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType, typename _CharT, typename _Traits> template<typename _RealType, typename _CharT, typename _Traits>
std::basic_ostream<_CharT, _Traits>& std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::exponential_distribution<_RealType>&); const std::exponential_distribution<_RealType>& __x);
/** /**
* @brief Extracts a %exponential_distribution random number distribution * @brief Extracts a %exponential_distribution random number distribution
@ -4296,8 +4299,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType, typename _CharT, typename _Traits> template<typename _RealType, typename _CharT, typename _Traits>
std::basic_istream<_CharT, _Traits>& std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::exponential_distribution<_RealType>&); std::exponential_distribution<_RealType>& __x);
/** /**
@ -4456,8 +4459,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType, typename _CharT, typename _Traits> template<typename _RealType, typename _CharT, typename _Traits>
std::basic_ostream<_CharT, _Traits>& std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::weibull_distribution<_RealType>&); const std::weibull_distribution<_RealType>& __x);
/** /**
* @brief Extracts a %weibull_distribution random number distribution * @brief Extracts a %weibull_distribution random number distribution
@ -4471,8 +4474,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType, typename _CharT, typename _Traits> template<typename _RealType, typename _CharT, typename _Traits>
std::basic_istream<_CharT, _Traits>& std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::weibull_distribution<_RealType>&); std::weibull_distribution<_RealType>& __x);
/** /**
@ -4631,8 +4634,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType, typename _CharT, typename _Traits> template<typename _RealType, typename _CharT, typename _Traits>
std::basic_ostream<_CharT, _Traits>& std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::extreme_value_distribution<_RealType>&); const std::extreme_value_distribution<_RealType>& __x);
/** /**
* @brief Extracts a %extreme_value_distribution random number * @brief Extracts a %extreme_value_distribution random number
@ -4646,8 +4649,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType, typename _CharT, typename _Traits> template<typename _RealType, typename _CharT, typename _Traits>
std::basic_istream<_CharT, _Traits>& std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::extreme_value_distribution<_RealType>&); std::extreme_value_distribution<_RealType>& __x);
/** /**
@ -4808,8 +4811,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _IntType1, typename _CharT, typename _Traits> template<typename _IntType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::discrete_distribution<_IntType1>&); const std::discrete_distribution<_IntType1>& __x);
/** /**
* @brief Extracts a %discrete_distribution random number distribution * @brief Extracts a %discrete_distribution random number distribution
@ -4824,8 +4827,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _IntType1, typename _CharT, typename _Traits> template<typename _IntType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::discrete_distribution<_IntType1>&); std::discrete_distribution<_IntType1>& __x);
private: private:
param_type _M_param; param_type _M_param;
@ -5047,8 +5050,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::piecewise_constant_distribution<_RealType1>&); const std::piecewise_constant_distribution<_RealType1>& __x);
/** /**
* @brief Extracts a %piecewise_constan_distribution random * @brief Extracts a %piecewise_constan_distribution random
@ -5063,8 +5066,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::piecewise_constant_distribution<_RealType1>&); std::piecewise_constant_distribution<_RealType1>& __x);
private: private:
param_type _M_param; param_type _M_param;
@ -5289,8 +5292,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_ostream<_CharT, _Traits>& friend std::basic_ostream<_CharT, _Traits>&
operator<<(std::basic_ostream<_CharT, _Traits>&, operator<<(std::basic_ostream<_CharT, _Traits>& __os,
const std::piecewise_linear_distribution<_RealType1>&); const std::piecewise_linear_distribution<_RealType1>& __x);
/** /**
* @brief Extracts a %piecewise_linear_distribution random number * @brief Extracts a %piecewise_linear_distribution random number
@ -5305,8 +5308,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
*/ */
template<typename _RealType1, typename _CharT, typename _Traits> template<typename _RealType1, typename _CharT, typename _Traits>
friend std::basic_istream<_CharT, _Traits>& friend std::basic_istream<_CharT, _Traits>&
operator>>(std::basic_istream<_CharT, _Traits>&, operator>>(std::basic_istream<_CharT, _Traits>& __is,
std::piecewise_linear_distribution<_RealType1>&); std::piecewise_linear_distribution<_RealType1>& __x);
private: private:
param_type _M_param; param_type _M_param;

12
libstdc++-v3/include/bits/range_access.h
View File

@ -41,7 +41,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Return an iterator pointing to the first element of * @brief Return an iterator pointing to the first element of
* the container. * the container.
* @param cont Container. * @param __cont Container.
*/ */
template<class _Container> template<class _Container>
inline auto inline auto
@ -51,7 +51,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Return an iterator pointing to the first element of * @brief Return an iterator pointing to the first element of
* the const container. * the const container.
* @param cont Container. * @param __cont Container.
*/ */
template<class _Container> template<class _Container>
inline auto inline auto
@ -61,7 +61,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Return an iterator pointing to one past the last element of * @brief Return an iterator pointing to one past the last element of
* the container. * the container.
* @param cont Container. * @param __cont Container.
*/ */
template<class _Container> template<class _Container>
inline auto inline auto
@ -71,7 +71,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Return an iterator pointing to one past the last element of * @brief Return an iterator pointing to one past the last element of
* the const container. * the const container.
* @param cont Container. * @param __cont Container.
*/ */
template<class _Container> template<class _Container>
inline auto inline auto
@ -80,7 +80,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Return an iterator pointing to the first element of the array. * @brief Return an iterator pointing to the first element of the array.
* @param arr Array. * @param __arr Array.
*/ */
template<class _Tp, size_t _Nm> template<class _Tp, size_t _Nm>
inline _Tp* inline _Tp*
@ -90,7 +90,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Return an iterator pointing to one past the last element * @brief Return an iterator pointing to one past the last element
* of the array. * of the array.
* @param arr Array. * @param __arr Array.
*/ */
template<class _Tp, size_t _Nm> template<class _Tp, size_t _Nm>
inline _Tp* inline _Tp*

670
libstdc++-v3/include/bits/regex.h
View File

File diff suppressed because it is too large Load Diff

4
libstdc++-v3/include/bits/regex_error.h
View File

@ -99,7 +99,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
static constexpr error_type error_space(_S_error_space); static constexpr error_type error_space(_S_error_space);
/** /**
* One of <em>*?+{<em> was not preceded by a valid regular expression. * One of <em>*?+{</em> was not preceded by a valid regular expression.
*/ */
static constexpr error_type error_badrepeat(_S_error_badrepeat); static constexpr error_type error_badrepeat(_S_error_badrepeat);
@ -136,7 +136,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Constructs a regex_error object. * @brief Constructs a regex_error object.
* *
* @param ecode the regex error code. * @param __ecode the regex error code.
*/ */
explicit explicit
regex_error(regex_constants::error_type __ecode); regex_error(regex_constants::error_type __ecode);

10
libstdc++-v3/include/bits/slice_array.h
View File

@ -1,7 +1,7 @@
// The template and inlines for the -*- C++ -*- slice_array class. // The template and inlines for the -*- C++ -*- slice_array class.
// Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2004, 2005, 2006, 2009, // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2004, 2005, 2006, 2009,
// 2010 Free Software Foundation, Inc. // 2010, 2011 Free Software Foundation, Inc.
// //
// This file is part of the GNU ISO C++ Library. This library is free // This file is part of the GNU ISO C++ Library. This library is free
// software; you can redistribute it and/or modify it under the // software; you can redistribute it and/or modify it under the
@ -66,11 +66,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Construct a slice. * @brief Construct a slice.
* *
* @param o Offset in array of first element. * @param __o Offset in array of first element.
* @param d Number of elements in slice. * @param __d Number of elements in slice.
* @param s Stride between array elements. * @param __s Stride between array elements.
*/ */
slice(size_t, size_t, size_t); slice(size_t __o, size_t __d, size_t __s);
/// Return array offset of first slice element. /// Return array offset of first slice element.
size_t start() const; size_t start() const;

1295
libstdc++-v3/include/bits/stl_algo.h
View File

File diff suppressed because it is too large Load Diff

118
libstdc++-v3/include/bits/stl_algobase.h
View File

@ -106,8 +106,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Swaps the contents of two iterators. * @brief Swaps the contents of two iterators.
* @ingroup mutating_algorithms * @ingroup mutating_algorithms
* @param a An iterator. * @param __a An iterator.
* @param b Another iterator. * @param __b Another iterator.
* @return Nothing. * @return Nothing.
* *
* This function swaps the values pointed to by two iterators, not the * This function swaps the values pointed to by two iterators, not the
@ -145,9 +145,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Swap the elements of two sequences. * @brief Swap the elements of two sequences.
* @ingroup mutating_algorithms * @ingroup mutating_algorithms
* @param first1 A forward iterator. * @param __first1 A forward iterator.
* @param last1 A forward iterator. * @param __last1 A forward iterator.
* @param first2 A forward iterator. * @param __first2 A forward iterator.
* @return An iterator equal to @p first2+(last1-first1). * @return An iterator equal to @p first2+(last1-first1).
* *
* Swaps each element in the range @p [first1,last1) with the * Swaps each element in the range @p [first1,last1) with the
@ -174,8 +174,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief This does what you think it does. * @brief This does what you think it does.
* @ingroup sorting_algorithms * @ingroup sorting_algorithms
* @param a A thing of arbitrary type. * @param __a A thing of arbitrary type.
* @param b Another thing of arbitrary type. * @param __b Another thing of arbitrary type.
* @return The lesser of the parameters. * @return The lesser of the parameters.
* *
* This is the simple classic generic implementation. It will work on * This is the simple classic generic implementation. It will work on
@ -197,8 +197,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief This does what you think it does. * @brief This does what you think it does.
* @ingroup sorting_algorithms * @ingroup sorting_algorithms
* @param a A thing of arbitrary type. * @param __a A thing of arbitrary type.
* @param b Another thing of arbitrary type. * @param __b Another thing of arbitrary type.
* @return The greater of the parameters. * @return The greater of the parameters.
* *
* This is the simple classic generic implementation. It will work on * This is the simple classic generic implementation. It will work on
@ -220,9 +220,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief This does what you think it does. * @brief This does what you think it does.
* @ingroup sorting_algorithms * @ingroup sorting_algorithms
* @param a A thing of arbitrary type. * @param __a A thing of arbitrary type.
* @param b Another thing of arbitrary type. * @param __b Another thing of arbitrary type.
* @param comp A @link comparison_functors comparison functor@endlink. * @param __comp A @link comparison_functors comparison functor@endlink.
* @return The lesser of the parameters. * @return The lesser of the parameters.
* *
* This will work on temporary expressions, since they are only evaluated * This will work on temporary expressions, since they are only evaluated
@ -241,9 +241,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief This does what you think it does. * @brief This does what you think it does.
* @ingroup sorting_algorithms * @ingroup sorting_algorithms
* @param a A thing of arbitrary type. * @param __a A thing of arbitrary type.
* @param b Another thing of arbitrary type. * @param __b Another thing of arbitrary type.
* @param comp A @link comparison_functors comparison functor@endlink. * @param __comp A @link comparison_functors comparison functor@endlink.
* @return The greater of the parameters. * @return The greater of the parameters.
* *
* This will work on temporary expressions, since they are only evaluated * This will work on temporary expressions, since they are only evaluated
@ -425,9 +425,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Copies the range [first,last) into result. * @brief Copies the range [first,last) into result.
* @ingroup mutating_algorithms * @ingroup mutating_algorithms
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param result An output iterator. * @param __result An output iterator.
* @return result + (first - last) * @return result + (first - last)
* *
* This inline function will boil down to a call to @c memmove whenever * This inline function will boil down to a call to @c memmove whenever
@ -458,9 +458,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Moves the range [first,last) into result. * @brief Moves the range [first,last) into result.
* @ingroup mutating_algorithms * @ingroup mutating_algorithms
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param result An output iterator. * @param __result An output iterator.
* @return result + (first - last) * @return result + (first - last)
* *
* This inline function will boil down to a call to @c memmove whenever * This inline function will boil down to a call to @c memmove whenever
@ -593,9 +593,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Copies the range [first,last) into result. * @brief Copies the range [first,last) into result.
* @ingroup mutating_algorithms * @ingroup mutating_algorithms
* @param first A bidirectional iterator. * @param __first A bidirectional iterator.
* @param last A bidirectional iterator. * @param __last A bidirectional iterator.
* @param result A bidirectional iterator. * @param __result A bidirectional iterator.
* @return result - (first - last) * @return result - (first - last)
* *
* The function has the same effect as copy, but starts at the end of the * The function has the same effect as copy, but starts at the end of the
@ -629,9 +629,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Moves the range [first,last) into result. * @brief Moves the range [first,last) into result.
* @ingroup mutating_algorithms * @ingroup mutating_algorithms
* @param first A bidirectional iterator. * @param __first A bidirectional iterator.
* @param last A bidirectional iterator. * @param __last A bidirectional iterator.
* @param result A bidirectional iterator. * @param __result A bidirectional iterator.
* @return result - (first - last) * @return result - (first - last)
* *
* The function has the same effect as move, but starts at the end of the * The function has the same effect as move, but starts at the end of the
@ -701,9 +701,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Fills the range [first,last) with copies of value. * @brief Fills the range [first,last) with copies of value.
* @ingroup mutating_algorithms * @ingroup mutating_algorithms
* @param first A forward iterator. * @param __first A forward iterator.
* @param last A forward iterator. * @param __last A forward iterator.
* @param value A reference-to-const of arbitrary type. * @param __value A reference-to-const of arbitrary type.
* @return Nothing. * @return Nothing.
* *
* This function fills a range with copies of the same value. For char * This function fills a range with copies of the same value. For char
@ -758,9 +758,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Fills the range [first,first+n) with copies of value. * @brief Fills the range [first,first+n) with copies of value.
* @ingroup mutating_algorithms * @ingroup mutating_algorithms
* @param first An output iterator. * @param __first An output iterator.
* @param n The count of copies to perform. * @param __n The count of copies to perform.
* @param value A reference-to-const of arbitrary type. * @param __value A reference-to-const of arbitrary type.
* @return The iterator at first+n. * @return The iterator at first+n.
* *
* This function fills a range with copies of the same value. For char * This function fills a range with copies of the same value. For char
@ -923,9 +923,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Finds the first position in which @a val could be inserted * @brief Finds the first position in which @a val could be inserted
* without changing the ordering. * without changing the ordering.
* @param first An iterator. * @param __first An iterator.
* @param last Another iterator. * @param __last Another iterator.
* @param val The search term. * @param __val The search term.
* @return An iterator pointing to the first element <em>not less * @return An iterator pointing to the first element <em>not less
* than</em> @a val, or end() if every element is less than * than</em> @a val, or end() if every element is less than
* @a val. * @a val.
@ -996,9 +996,9 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
/** /**
* @brief Tests a range for element-wise equality. * @brief Tests a range for element-wise equality.
* @ingroup non_mutating_algorithms * @ingroup non_mutating_algorithms
* @param first1 An input iterator. * @param __first1 An input iterator.
* @param last1 An input iterator. * @param __last1 An input iterator.
* @param first2 An input iterator. * @param __first2 An input iterator.
* @return A boolean true or false. * @return A boolean true or false.
* *
* This compares the elements of two ranges using @c == and returns true or * This compares the elements of two ranges using @c == and returns true or
@ -1025,10 +1025,10 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
/** /**
* @brief Tests a range for element-wise equality. * @brief Tests a range for element-wise equality.
* @ingroup non_mutating_algorithms * @ingroup non_mutating_algorithms
* @param first1 An input iterator. * @param __first1 An input iterator.
* @param last1 An input iterator. * @param __last1 An input iterator.
* @param first2 An input iterator. * @param __first2 An input iterator.
* @param binary_pred A binary predicate @link functors * @param __binary_pred A binary predicate @link functors
* functor@endlink. * functor@endlink.
* @return A boolean true or false. * @return A boolean true or false.
* *
@ -1056,10 +1056,10 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
/** /**
* @brief Performs @b dictionary comparison on ranges. * @brief Performs @b dictionary comparison on ranges.
* @ingroup sorting_algorithms * @ingroup sorting_algorithms
* @param first1 An input iterator. * @param __first1 An input iterator.
* @param last1 An input iterator. * @param __last1 An input iterator.
* @param first2 An input iterator. * @param __first2 An input iterator.
* @param last2 An input iterator. * @param __last2 An input iterator.
* @return A boolean true or false. * @return A boolean true or false.
* *
* <em>Returns true if the sequence of elements defined by the range * <em>Returns true if the sequence of elements defined by the range
@ -1092,11 +1092,11 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
/** /**
* @brief Performs @b dictionary comparison on ranges. * @brief Performs @b dictionary comparison on ranges.
* @ingroup sorting_algorithms * @ingroup sorting_algorithms
* @param first1 An input iterator. * @param __first1 An input iterator.
* @param last1 An input iterator. * @param __last1 An input iterator.
* @param first2 An input iterator. * @param __first2 An input iterator.
* @param last2 An input iterator. * @param __last2 An input iterator.
* @param comp A @link comparison_functors comparison functor@endlink. * @param __comp A @link comparison_functors comparison functor@endlink.
* @return A boolean true or false. * @return A boolean true or false.
* *
* The same as the four-parameter @c lexicographical_compare, but uses the * The same as the four-parameter @c lexicographical_compare, but uses the
@ -1132,9 +1132,9 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
/** /**
* @brief Finds the places in ranges which don't match. * @brief Finds the places in ranges which don't match.
* @ingroup non_mutating_algorithms * @ingroup non_mutating_algorithms
* @param first1 An input iterator. * @param __first1 An input iterator.
* @param last1 An input iterator. * @param __last1 An input iterator.
* @param first2 An input iterator. * @param __first2 An input iterator.
* @return A pair of iterators pointing to the first mismatch. * @return A pair of iterators pointing to the first mismatch.
* *
* This compares the elements of two ranges using @c == and returns a pair * This compares the elements of two ranges using @c == and returns a pair
@ -1166,10 +1166,10 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
/** /**
* @brief Finds the places in ranges which don't match. * @brief Finds the places in ranges which don't match.
* @ingroup non_mutating_algorithms * @ingroup non_mutating_algorithms
* @param first1 An input iterator. * @param __first1 An input iterator.
* @param last1 An input iterator. * @param __last1 An input iterator.
* @param first2 An input iterator. * @param __first2 An input iterator.
* @param binary_pred A binary predicate @link functors * @param __binary_pred A binary predicate @link functors
* functor@endlink. * functor@endlink.
* @return A pair of iterators pointing to the first mismatch. * @return A pair of iterators pointing to the first mismatch.
* *

174
libstdc++-v3/include/bits/stl_deque.h
View File

@ -68,7 +68,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief This function controls the size of memory nodes. * @brief This function controls the size of memory nodes.
* @param size The size of an element. * @param __size The size of an element.
* @return The number (not byte size) of elements per node. * @return The number (not byte size) of elements per node.
* *
* This function started off as a compiler kludge from SGI, but * This function started off as a compiler kludge from SGI, but
@ -569,7 +569,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Layout storage. * @brief Layout storage.
* @param num_elements The count of T's for which to allocate space * @param __num_elements The count of T's for which to allocate space
* at first. * at first.
* @return Nothing. * @return Nothing.
* *
@ -664,7 +664,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
* - iterator _M_start, _M_finish * - iterator _M_start, _M_finish
* *
* map_size is at least 8. %map is an array of map_size * map_size is at least 8. %map is an array of map_size
* pointers-to-@anodes. (The name %map has nothing to do with the * pointers-to-@a nodes. (The name %map has nothing to do with the
* std::map class, and @b nodes should not be confused with * std::map class, and @b nodes should not be confused with
* std::list's usage of @a node.) * std::list's usage of @a node.)
* *
@ -780,7 +780,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %deque with no elements. * @brief Creates a %deque with no elements.
* @param a An allocator object. * @param __a An allocator object.
*/ */
explicit explicit
deque(const allocator_type& __a) deque(const allocator_type& __a)
@ -789,7 +789,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Creates a %deque with default constructed elements. * @brief Creates a %deque with default constructed elements.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* *
* This constructor fills the %deque with @a n default * This constructor fills the %deque with @a n default
* constructed elements. * constructed elements.
@ -801,11 +801,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %deque with copies of an exemplar element. * @brief Creates a %deque with copies of an exemplar element.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* @param value An element to copy. * @param __value An element to copy.
* @param a An allocator. * @param __a An allocator.
* *
* This constructor fills the %deque with @a n copies of @a value. * This constructor fills the %deque with @a __n copies of @a __value.
*/ */
deque(size_type __n, const value_type& __value, deque(size_type __n, const value_type& __value,
const allocator_type& __a = allocator_type()) const allocator_type& __a = allocator_type())
@ -814,11 +814,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
/** /**
* @brief Creates a %deque with copies of an exemplar element. * @brief Creates a %deque with copies of an exemplar element.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* @param value An element to copy. * @param __value An element to copy.
* @param a An allocator. * @param __a An allocator.
* *
* This constructor fills the %deque with @a n copies of @a value. * This constructor fills the %deque with @a __n copies of @a __value.
*/ */
explicit explicit
deque(size_type __n, const value_type& __value = value_type(), deque(size_type __n, const value_type& __value = value_type(),
@ -829,10 +829,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Deque copy constructor. * @brief %Deque copy constructor.
* @param x A %deque of identical element and allocator types. * @param __x A %deque of identical element and allocator types.
* *
* The newly-created %deque uses a copy of the allocation object used * The newly-created %deque uses a copy of the allocation object used
* by @a x. * by @a __x.
*/ */
deque(const deque& __x) deque(const deque& __x)
: _Base(__x._M_get_Tp_allocator(), __x.size()) : _Base(__x._M_get_Tp_allocator(), __x.size())
@ -843,24 +843,24 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Deque move constructor. * @brief %Deque move constructor.
* @param x A %deque of identical element and allocator types. * @param __x A %deque of identical element and allocator types.
* *
* The newly-created %deque contains the exact contents of @a x. * The newly-created %deque contains the exact contents of @a __x.
* The contents of @a x are a valid, but unspecified %deque. * The contents of @a __x are a valid, but unspecified %deque.
*/ */
deque(deque&& __x) deque(deque&& __x)
: _Base(std::move(__x)) { } : _Base(std::move(__x)) { }
/** /**
* @brief Builds a %deque from an initializer list. * @brief Builds a %deque from an initializer list.
* @param l An initializer_list. * @param __l An initializer_list.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %deque consisting of copies of the elements in the * Create a %deque consisting of copies of the elements in the
* initializer_list @a l. * initializer_list @a __l.
* *
* This will call the element type's copy constructor N times * This will call the element type's copy constructor N times
* (where N is l.size()) and do no memory reallocation. * (where N is __l.size()) and do no memory reallocation.
*/ */
deque(initializer_list<value_type> __l, deque(initializer_list<value_type> __l,
const allocator_type& __a = allocator_type()) const allocator_type& __a = allocator_type())
@ -873,16 +873,16 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %deque from a range. * @brief Builds a %deque from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %deque consisting of copies of the elements from [first, * Create a %deque consisting of copies of the elements from [__first,
* last). * __last).
* *
* If the iterators are forward, bidirectional, or random-access, then * If the iterators are forward, bidirectional, or random-access, then
* this will call the elements' copy constructor N times (where N is * this will call the elements' copy constructor N times (where N is
* distance(first,last)) and do no memory reallocation. But if only * distance(__first,__last)) and do no memory reallocation. But if only
* input iterators are used, then this will do at most 2N calls to the * input iterators are used, then this will do at most 2N calls to the
* copy constructor, and logN memory reallocations. * copy constructor, and logN memory reallocations.
*/ */
@ -906,7 +906,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Deque assignment operator. * @brief %Deque assignment operator.
* @param x A %deque of identical element and allocator types. * @param __x A %deque of identical element and allocator types.
* *
* All the elements of @a x are copied, but unlike the copy constructor, * All the elements of @a x are copied, but unlike the copy constructor,
* the allocator object is not copied. * the allocator object is not copied.
@ -917,10 +917,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Deque move assignment operator. * @brief %Deque move assignment operator.
* @param x A %deque of identical element and allocator types. * @param __x A %deque of identical element and allocator types.
* *
* The contents of @a x are moved into this deque (without copying). * The contents of @a __x are moved into this deque (without copying).
* @a x is a valid, but unspecified %deque. * @a __x is a valid, but unspecified %deque.
*/ */
deque& deque&
operator=(deque&& __x) operator=(deque&& __x)
@ -934,10 +934,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Assigns an initializer list to a %deque. * @brief Assigns an initializer list to a %deque.
* @param l An initializer_list. * @param __l An initializer_list.
* *
* This function fills a %deque with copies of the elements in the * This function fills a %deque with copies of the elements in the
* initializer_list @a l. * initializer_list @a __l.
* *
* Note that the assignment completely changes the %deque and that the * Note that the assignment completely changes the %deque and that the
* resulting %deque's size is the same as the number of elements * resulting %deque's size is the same as the number of elements
@ -953,8 +953,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Assigns a given value to a %deque. * @brief Assigns a given value to a %deque.
* @param n Number of elements to be assigned. * @param __n Number of elements to be assigned.
* @param val Value to be assigned. * @param __val Value to be assigned.
* *
* This function fills a %deque with @a n copies of the given * This function fills a %deque with @a n copies of the given
* value. Note that the assignment completely changes the * value. Note that the assignment completely changes the
@ -967,11 +967,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Assigns a range to a %deque. * @brief Assigns a range to a %deque.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* This function fills a %deque with copies of the elements in the * This function fills a %deque with copies of the elements in the
* range [first,last). * range [__first,__last).
* *
* Note that the assignment completely changes the %deque and that the * Note that the assignment completely changes the %deque and that the
* resulting %deque's size is the same as the number of elements * resulting %deque's size is the same as the number of elements
@ -988,10 +988,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Assigns an initializer list to a %deque. * @brief Assigns an initializer list to a %deque.
* @param l An initializer_list. * @param __l An initializer_list.
* *
* This function fills a %deque with copies of the elements in the * This function fills a %deque with copies of the elements in the
* initializer_list @a l. * initializer_list @a __l.
* *
* Note that the assignment completely changes the %deque and that the * Note that the assignment completely changes the %deque and that the
* resulting %deque's size is the same as the number of elements * resulting %deque's size is the same as the number of elements
@ -1129,7 +1129,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Resizes the %deque to the specified number of elements. * @brief Resizes the %deque to the specified number of elements.
* @param new_size Number of elements the %deque should contain. * @param __new_size Number of elements the %deque should contain.
* *
* This function will %resize the %deque to the specified * This function will %resize the %deque to the specified
* number of elements. If the number is smaller than the * number of elements. If the number is smaller than the
@ -1149,8 +1149,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Resizes the %deque to the specified number of elements. * @brief Resizes the %deque to the specified number of elements.
* @param new_size Number of elements the %deque should contain. * @param __new_size Number of elements the %deque should contain.
* @param x Data with which new elements should be populated. * @param __x Data with which new elements should be populated.
* *
* This function will %resize the %deque to the specified * This function will %resize the %deque to the specified
* number of elements. If the number is smaller than the * number of elements. If the number is smaller than the
@ -1171,8 +1171,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
/** /**
* @brief Resizes the %deque to the specified number of elements. * @brief Resizes the %deque to the specified number of elements.
* @param new_size Number of elements the %deque should contain. * @param __new_size Number of elements the %deque should contain.
* @param x Data with which new elements should be populated. * @param __x Data with which new elements should be populated.
* *
* This function will %resize the %deque to the specified * This function will %resize the %deque to the specified
* number of elements. If the number is smaller than the * number of elements. If the number is smaller than the
@ -1210,7 +1210,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// element access // element access
/** /**
* @brief Subscript access to the data contained in the %deque. * @brief Subscript access to the data contained in the %deque.
* @param n The index of the element for which data should be * @param __n The index of the element for which data should be
* accessed. * accessed.
* @return Read/write reference to data. * @return Read/write reference to data.
* *
@ -1225,7 +1225,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Subscript access to the data contained in the %deque. * @brief Subscript access to the data contained in the %deque.
* @param n The index of the element for which data should be * @param __n The index of the element for which data should be
* accessed. * accessed.
* @return Read-only (constant) reference to data. * @return Read-only (constant) reference to data.
* *
@ -1250,10 +1250,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
public: public:
/** /**
* @brief Provides access to the data contained in the %deque. * @brief Provides access to the data contained in the %deque.
* @param n The index of the element for which data should be * @param __n The index of the element for which data should be
* accessed. * accessed.
* @return Read/write reference to data. * @return Read/write reference to data.
* @throw std::out_of_range If @a n is an invalid index. * @throw std::out_of_range If @a __n is an invalid index.
* *
* This function provides for safer data access. The parameter * This function provides for safer data access. The parameter
* is first checked that it is in the range of the deque. The * is first checked that it is in the range of the deque. The
@ -1268,10 +1268,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Provides access to the data contained in the %deque. * @brief Provides access to the data contained in the %deque.
* @param n The index of the element for which data should be * @param __n The index of the element for which data should be
* accessed. * accessed.
* @return Read-only (constant) reference to data. * @return Read-only (constant) reference to data.
* @throw std::out_of_range If @a n is an invalid index. * @throw std::out_of_range If @a __n is an invalid index.
* *
* This function provides for safer data access. The parameter is first * This function provides for safer data access. The parameter is first
* checked that it is in the range of the deque. The function throws * checked that it is in the range of the deque. The function throws
@ -1327,7 +1327,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// [23.2.1.2] modifiers // [23.2.1.2] modifiers
/** /**
* @brief Add data to the front of the %deque. * @brief Add data to the front of the %deque.
* @param x Data to be added. * @param __x Data to be added.
* *
* This is a typical stack operation. The function creates an * This is a typical stack operation. The function creates an
* element at the front of the %deque and assigns the given * element at the front of the %deque and assigns the given
@ -1358,7 +1358,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Add data to the end of the %deque. * @brief Add data to the end of the %deque.
* @param x Data to be added. * @param __x Data to be added.
* *
* This is a typical stack operation. The function creates an * This is a typical stack operation. The function creates an
* element at the end of the %deque and assigns the given data * element at the end of the %deque and assigns the given data
@ -1433,8 +1433,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Inserts an object in %deque before specified iterator. * @brief Inserts an object in %deque before specified iterator.
* @param position An iterator into the %deque. * @param __position An iterator into the %deque.
* @param args Arguments. * @param __args Arguments.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert an object of type T constructed * This function will insert an object of type T constructed
@ -1447,8 +1447,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts given value into %deque before specified iterator. * @brief Inserts given value into %deque before specified iterator.
* @param position An iterator into the %deque. * @param __position An iterator into the %deque.
* @param x Data to be inserted. * @param __x Data to be inserted.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert a copy of the given value before the * This function will insert a copy of the given value before the
@ -1460,8 +1460,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Inserts given rvalue into %deque before specified iterator. * @brief Inserts given rvalue into %deque before specified iterator.
* @param position An iterator into the %deque. * @param __position An iterator into the %deque.
* @param x Data to be inserted. * @param __x Data to be inserted.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert a copy of the given rvalue before the * This function will insert a copy of the given rvalue before the
@ -1473,12 +1473,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts an initializer list into the %deque. * @brief Inserts an initializer list into the %deque.
* @param p An iterator into the %deque. * @param __p An iterator into the %deque.
* @param l An initializer_list. * @param __l An initializer_list.
* *
* This function will insert copies of the data in the * This function will insert copies of the data in the
* initializer_list @a l into the %deque before the location * initializer_list @a __l into the %deque before the location
* specified by @a p. This is known as <em>list insert</em>. * specified by @a __p. This is known as <em>list insert</em>.
*/ */
void void
insert(iterator __p, initializer_list<value_type> __l) insert(iterator __p, initializer_list<value_type> __l)
@ -1487,12 +1487,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts a number of copies of given data into the %deque. * @brief Inserts a number of copies of given data into the %deque.
* @param position An iterator into the %deque. * @param __position An iterator into the %deque.
* @param n Number of elements to be inserted. * @param __n Number of elements to be inserted.
* @param x Data to be inserted. * @param __x Data to be inserted.
* *
* This function will insert a specified number of copies of the given * This function will insert a specified number of copies of the given
* data before the location specified by @a position. * data before the location specified by @a __position.
*/ */
void void
insert(iterator __position, size_type __n, const value_type& __x) insert(iterator __position, size_type __n, const value_type& __x)
@ -1500,13 +1500,13 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts a range into the %deque. * @brief Inserts a range into the %deque.
* @param position An iterator into the %deque. * @param __position An iterator into the %deque.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* This function will insert copies of the data in the range * This function will insert copies of the data in the range
* [first,last) into the %deque before the location specified * [__first,__last) into the %deque before the location specified
* by @a pos. This is known as <em>range insert</em>. * by @a __position. This is known as <em>range insert</em>.
*/ */
template<typename _InputIterator> template<typename _InputIterator>
void void
@ -1520,7 +1520,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove element at given position. * @brief Remove element at given position.
* @param position Iterator pointing to element to be erased. * @param __position Iterator pointing to element to be erased.
* @return An iterator pointing to the next element (or end()). * @return An iterator pointing to the next element (or end()).
* *
* This function will erase the element at the given position and thus * This function will erase the element at the given position and thus
@ -1536,14 +1536,14 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove a range of elements. * @brief Remove a range of elements.
* @param first Iterator pointing to the first element to be erased. * @param __first Iterator pointing to the first element to be erased.
* @param last Iterator pointing to one past the last element to be * @param __last Iterator pointing to one past the last element to be
* erased. * erased.
* @return An iterator pointing to the element pointed to by @a last * @return An iterator pointing to the element pointed to by @a last
* prior to erasing (or end()). * prior to erasing (or end()).
* *
* This function will erase the elements in the range [first,last) and * This function will erase the elements in the range
* shorten the %deque accordingly. * [__first,__last) and shorten the %deque accordingly.
* *
* The user is cautioned that * The user is cautioned that
* this function only erases the elements, and that if the elements * this function only erases the elements, and that if the elements
@ -1555,7 +1555,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Swaps data with another %deque. * @brief Swaps data with another %deque.
* @param x A %deque of the same element and allocator types. * @param __x A %deque of the same element and allocator types.
* *
* This exchanges the elements between two deques in constant time. * This exchanges the elements between two deques in constant time.
* (Four pointers, so it should be quite fast.) * (Four pointers, so it should be quite fast.)
@ -1616,8 +1616,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Fills the deque with whatever is in [first,last). * @brief Fills the deque with whatever is in [first,last).
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @return Nothing. * @return Nothing.
* *
* If the iterators are actually forward iterators (or better), then the * If the iterators are actually forward iterators (or better), then the
@ -1638,7 +1638,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Fills the %deque with copies of value. * @brief Fills the %deque with copies of value.
* @param value Initial value. * @param __value Initial value.
* @return Nothing. * @return Nothing.
* @pre _M_start and _M_finish have already been initialized, * @pre _M_start and _M_finish have already been initialized,
* but none of the %deque's elements have yet been constructed. * but none of the %deque's elements have yet been constructed.
@ -1914,8 +1914,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Deque equality comparison. * @brief Deque equality comparison.
* @param x A %deque. * @param __x A %deque.
* @param y A %deque of the same type as @a x. * @param __y A %deque of the same type as @a __x.
* @return True iff the size and elements of the deques are equal. * @return True iff the size and elements of the deques are equal.
* *
* This is an equivalence relation. It is linear in the size of the * This is an equivalence relation. It is linear in the size of the
@ -1931,9 +1931,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Deque ordering relation. * @brief Deque ordering relation.
* @param x A %deque. * @param __x A %deque.
* @param y A %deque of the same type as @a x. * @param __y A %deque of the same type as @a __x.
* @return True iff @a x is lexicographically less than @a y. * @return True iff @a x is lexicographically less than @a __y.
* *
* This is a total ordering relation. It is linear in the size of the * This is a total ordering relation. It is linear in the size of the
* deques. The elements must be comparable with @c <. * deques. The elements must be comparable with @c <.

103
libstdc++-v3/include/bits/stl_heap.h
View File

@ -144,12 +144,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Push an element onto a heap. * @brief Push an element onto a heap.
* @param first Start of heap. * @param __first Start of heap.
* @param last End of heap + element. * @param __last End of heap + element.
* @ingroup heap_algorithms * @ingroup heap_algorithms
* *
* This operation pushes the element at last-1 onto the valid heap over the * This operation pushes the element at last-1 onto the valid heap
* range [first,last-1). After completion, [first,last) is a valid heap. * over the range [__first,__last-1). After completion,
* [__first,__last) is a valid heap.
*/ */
template<typename _RandomAccessIterator> template<typename _RandomAccessIterator>
inline void inline void
@ -191,14 +192,15 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Push an element onto a heap using comparison functor. * @brief Push an element onto a heap using comparison functor.
* @param first Start of heap. * @param __first Start of heap.
* @param last End of heap + element. * @param __last End of heap + element.
* @param comp Comparison functor. * @param __comp Comparison functor.
* @ingroup heap_algorithms * @ingroup heap_algorithms
* *
* This operation pushes the element at last-1 onto the valid heap over the * This operation pushes the element at __last-1 onto the valid
* range [first,last-1). After completion, [first,last) is a valid heap. * heap over the range [__first,__last-1). After completion,
* Compare operations are performed using comp. * [__first,__last) is a valid heap. Compare operations are
* performed using comp.
*/ */
template<typename _RandomAccessIterator, typename _Compare> template<typename _RandomAccessIterator, typename _Compare>
inline void inline void
@ -266,12 +268,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Pop an element off a heap. * @brief Pop an element off a heap.
* @param first Start of heap. * @param __first Start of heap.
* @param last End of heap. * @param __last End of heap.
* @ingroup heap_algorithms * @ingroup heap_algorithms
* *
* This operation pops the top of the heap. The elements first and last-1 * This operation pops the top of the heap. The elements __first
* are swapped and [first,last-1) is made into a heap. * and __last-1 are swapped and [__first,__last-1) is made into a
* heap.
*/ */
template<typename _RandomAccessIterator> template<typename _RandomAccessIterator>
inline void inline void
@ -338,14 +341,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Pop an element off a heap using comparison functor. * @brief Pop an element off a heap using comparison functor.
* @param first Start of heap. * @param __first Start of heap.
* @param last End of heap. * @param __last End of heap.
* @param comp Comparison functor to use. * @param __comp Comparison functor to use.
* @ingroup heap_algorithms * @ingroup heap_algorithms
* *
* This operation pops the top of the heap. The elements first and last-1 * This operation pops the top of the heap. The elements __first
* are swapped and [first,last-1) is made into a heap. Comparisons are * and __last-1 are swapped and [__first,__last-1) is made into a
* made using comp. * heap. Comparisons are made using comp.
*/ */
template<typename _RandomAccessIterator, typename _Compare> template<typename _RandomAccessIterator, typename _Compare>
inline void inline void
@ -364,11 +367,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Construct a heap over a range. * @brief Construct a heap over a range.
* @param first Start of heap. * @param __first Start of heap.
* @param last End of heap. * @param __last End of heap.
* @ingroup heap_algorithms * @ingroup heap_algorithms
* *
* This operation makes the elements in [first,last) into a heap. * This operation makes the elements in [__first,__last) into a heap.
*/ */
template<typename _RandomAccessIterator> template<typename _RandomAccessIterator>
void void
@ -402,13 +405,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Construct a heap over a range using comparison functor. * @brief Construct a heap over a range using comparison functor.
* @param first Start of heap. * @param __first Start of heap.
* @param last End of heap. * @param __last End of heap.
* @param comp Comparison functor to use. * @param __comp Comparison functor to use.
* @ingroup heap_algorithms * @ingroup heap_algorithms
* *
* This operation makes the elements in [first,last) into a heap. * This operation makes the elements in [__first,__last) into a heap.
* Comparisons are made using comp. * Comparisons are made using __comp.
*/ */
template<typename _RandomAccessIterator, typename _Compare> template<typename _RandomAccessIterator, typename _Compare>
void void
@ -443,11 +446,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Sort a heap. * @brief Sort a heap.
* @param first Start of heap. * @param __first Start of heap.
* @param last End of heap. * @param __last End of heap.
* @ingroup heap_algorithms * @ingroup heap_algorithms
* *
* This operation sorts the valid heap in the range [first,last). * This operation sorts the valid heap in the range [__first,__last).
*/ */
template<typename _RandomAccessIterator> template<typename _RandomAccessIterator>
void void
@ -470,13 +473,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Sort a heap using comparison functor. * @brief Sort a heap using comparison functor.
* @param first Start of heap. * @param __first Start of heap.
* @param last End of heap. * @param __last End of heap.
* @param comp Comparison functor to use. * @param __comp Comparison functor to use.
* @ingroup heap_algorithms * @ingroup heap_algorithms
* *
* This operation sorts the valid heap in the range [first,last). * This operation sorts the valid heap in the range [__first,__last).
* Comparisons are made using comp. * Comparisons are made using __comp.
*/ */
template<typename _RandomAccessIterator, typename _Compare> template<typename _RandomAccessIterator, typename _Compare>
void void
@ -499,13 +502,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Search the end of a heap. * @brief Search the end of a heap.
* @param first Start of range. * @param __first Start of range.
* @param last End of range. * @param __last End of range.
* @return An iterator pointing to the first element not in the heap. * @return An iterator pointing to the first element not in the heap.
* @ingroup heap_algorithms * @ingroup heap_algorithms
* *
* This operation returns the last iterator i in [first, last) for which * This operation returns the last iterator i in [__first, __last) for which
* the range [first, i) is a heap. * the range [__first, i) is a heap.
*/ */
template<typename _RandomAccessIterator> template<typename _RandomAccessIterator>
inline _RandomAccessIterator inline _RandomAccessIterator
@ -524,14 +527,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Search the end of a heap using comparison functor. * @brief Search the end of a heap using comparison functor.
* @param first Start of range. * @param __first Start of range.
* @param last End of range. * @param __last End of range.
* @param comp Comparison functor to use. * @param __comp Comparison functor to use.
* @return An iterator pointing to the first element not in the heap. * @return An iterator pointing to the first element not in the heap.
* @ingroup heap_algorithms * @ingroup heap_algorithms
* *
* This operation returns the last iterator i in [first, last) for which * This operation returns the last iterator i in [__first, __last) for which
* the range [first, i) is a heap. Comparisons are made using comp. * the range [__first, i) is a heap. Comparisons are made using __comp.
*/ */
template<typename _RandomAccessIterator, typename _Compare> template<typename _RandomAccessIterator, typename _Compare>
inline _RandomAccessIterator inline _RandomAccessIterator
@ -550,8 +553,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Determines whether a range is a heap. * @brief Determines whether a range is a heap.
* @param first Start of range. * @param __first Start of range.
* @param last End of range. * @param __last End of range.
* @return True if range is a heap, false otherwise. * @return True if range is a heap, false otherwise.
* @ingroup heap_algorithms * @ingroup heap_algorithms
*/ */
@ -562,9 +565,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Determines whether a range is a heap using comparison functor. * @brief Determines whether a range is a heap using comparison functor.
* @param first Start of range. * @param __first Start of range.
* @param last End of range. * @param __last End of range.
* @param comp Comparison functor to use. * @param __comp Comparison functor to use.
* @return True if range is a heap, false otherwise. * @return True if range is a heap, false otherwise.
* @ingroup heap_algorithms * @ingroup heap_algorithms
*/ */

20
libstdc++-v3/include/bits/stl_iterator.h
View File

@ -272,8 +272,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
//@{ //@{
/** /**
* @param x A %reverse_iterator. * @param __x A %reverse_iterator.
* @param y A %reverse_iterator. * @param __y A %reverse_iterator.
* @return A simple bool. * @return A simple bool.
* *
* Reverse iterators forward many operations to their underlying base() * Reverse iterators forward many operations to their underlying base()
@ -408,7 +408,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
back_insert_iterator(_Container& __x) : container(&__x) { } back_insert_iterator(_Container& __x) : container(&__x) { }
/** /**
* @param value An instance of whatever type * @param __value An instance of whatever type
* container_type::const_reference is; presumably a * container_type::const_reference is; presumably a
* reference-to-const T for container<T>. * reference-to-const T for container<T>.
* @return This %iterator, for chained operations. * @return This %iterator, for chained operations.
@ -458,8 +458,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
}; };
/** /**
* @param x A container of arbitrary type. * @param __x A container of arbitrary type.
* @return An instance of back_insert_iterator working on @p x. * @return An instance of back_insert_iterator working on @p __x.
* *
* This wrapper function helps in creating back_insert_iterator instances. * This wrapper function helps in creating back_insert_iterator instances.
* Typing the name of the %iterator requires knowing the precise full * Typing the name of the %iterator requires knowing the precise full
@ -498,7 +498,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
explicit front_insert_iterator(_Container& __x) : container(&__x) { } explicit front_insert_iterator(_Container& __x) : container(&__x) { }
/** /**
* @param value An instance of whatever type * @param __value An instance of whatever type
* container_type::const_reference is; presumably a * container_type::const_reference is; presumably a
* reference-to-const T for container<T>. * reference-to-const T for container<T>.
* @return This %iterator, for chained operations. * @return This %iterator, for chained operations.
@ -548,7 +548,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
}; };
/** /**
* @param x A container of arbitrary type. * @param __x A container of arbitrary type.
* @return An instance of front_insert_iterator working on @p x. * @return An instance of front_insert_iterator working on @p x.
* *
* This wrapper function helps in creating front_insert_iterator instances. * This wrapper function helps in creating front_insert_iterator instances.
@ -597,7 +597,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
: container(&__x), iter(__i) {} : container(&__x), iter(__i) {}
/** /**
* @param value An instance of whatever type * @param __value An instance of whatever type
* container_type::const_reference is; presumably a * container_type::const_reference is; presumably a
* reference-to-const T for container<T>. * reference-to-const T for container<T>.
* @return This %iterator, for chained operations. * @return This %iterator, for chained operations.
@ -662,8 +662,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
}; };
/** /**
* @param x A container of arbitrary type. * @param __x A container of arbitrary type.
* @return An instance of insert_iterator working on @p x. * @return An instance of insert_iterator working on @p __x.
* *
* This wrapper function helps in creating insert_iterator instances. * This wrapper function helps in creating insert_iterator instances.
* Typing the name of the %iterator requires knowing the precise full * Typing the name of the %iterator requires knowing the precise full

15
libstdc++-v3/include/bits/stl_iterator_base_funcs.h
View File

@ -98,12 +98,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief A generalization of pointer arithmetic. * @brief A generalization of pointer arithmetic.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @return The distance between them. * @return The distance between them.
* *
* Returns @c n such that first + n == last. This requires that @p last * Returns @c n such that __first + n == __last. This requires
* must be reachable from @p first. Note that @c n may be negative. * that @p __last must be reachable from @p __first. Note that @c
* n may be negative.
* *
* For random access iterators, this uses their @c + and @c - operations * For random access iterators, this uses their @c + and @c - operations
* and are constant time. For other %iterator classes they are linear time. * and are constant time. For other %iterator classes they are linear time.
@ -156,12 +157,12 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief A generalization of pointer arithmetic. * @brief A generalization of pointer arithmetic.
* @param i An input iterator. * @param __i An input iterator.
* @param n The @a delta by which to change @p i. * @param __n The @a delta by which to change @p __i.
* @return Nothing. * @return Nothing.
* *
* This increments @p i by @p n. For bidirectional and random access * This increments @p i by @p n. For bidirectional and random access
* iterators, @p n may be negative, in which case @p i is decremented. * iterators, @p __n may be negative, in which case @p __i is decremented.
* *
* For random access iterators, this uses their @c + and @c - operations * For random access iterators, this uses their @c + and @c - operations
* and are constant time. For other %iterator classes they are linear time. * and are constant time. For other %iterator classes they are linear time.

209
libstdc++-v3/include/bits/stl_list.h
View File

@ -468,9 +468,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
using _Base::_M_get_Node_allocator; using _Base::_M_get_Node_allocator;
/** /**
* @param x An instance of user data. * @param __args An instance of user data.
* *
* Allocates space for a new node and constructs a copy of @a x in it. * Allocates space for a new node and constructs a copy of
* @a __args in it.
*/ */
#ifndef __GXX_EXPERIMENTAL_CXX0X__ #ifndef __GXX_EXPERIMENTAL_CXX0X__
_Node* _Node*
@ -520,7 +521,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %list with no elements. * @brief Creates a %list with no elements.
* @param a An allocator object. * @param __a An allocator object.
*/ */
explicit explicit
list(const allocator_type& __a) list(const allocator_type& __a)
@ -529,9 +530,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Creates a %list with default constructed elements. * @brief Creates a %list with default constructed elements.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* *
* This constructor fills the %list with @a n default * This constructor fills the %list with @a __n default
* constructed elements. * constructed elements.
*/ */
explicit explicit
@ -541,11 +542,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %list with copies of an exemplar element. * @brief Creates a %list with copies of an exemplar element.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* @param value An element to copy. * @param __value An element to copy.
* @param a An allocator object. * @param __a An allocator object.
* *
* This constructor fills the %list with @a n copies of @a value. * This constructor fills the %list with @a __n copies of @a __value.
*/ */
list(size_type __n, const value_type& __value, list(size_type __n, const value_type& __value,
const allocator_type& __a = allocator_type()) const allocator_type& __a = allocator_type())
@ -554,11 +555,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
/** /**
* @brief Creates a %list with copies of an exemplar element. * @brief Creates a %list with copies of an exemplar element.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* @param value An element to copy. * @param __value An element to copy.
* @param a An allocator object. * @param __a An allocator object.
* *
* This constructor fills the %list with @a n copies of @a value. * This constructor fills the %list with @a __n copies of @a __value.
*/ */
explicit explicit
list(size_type __n, const value_type& __value = value_type(), list(size_type __n, const value_type& __value = value_type(),
@ -569,10 +570,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %List copy constructor. * @brief %List copy constructor.
* @param x A %list of identical element and allocator types. * @param __x A %list of identical element and allocator types.
* *
* The newly-created %list uses a copy of the allocation object used * The newly-created %list uses a copy of the allocation object used
* by @a x. * by @a __x.
*/ */
list(const list& __x) list(const list& __x)
: _Base(__x._M_get_Node_allocator()) : _Base(__x._M_get_Node_allocator())
@ -581,21 +582,21 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %List move constructor. * @brief %List move constructor.
* @param x A %list of identical element and allocator types. * @param __x A %list of identical element and allocator types.
* *
* The newly-created %list contains the exact contents of @a x. * The newly-created %list contains the exact contents of @a __x.
* The contents of @a x are a valid, but unspecified %list. * The contents of @a __x are a valid, but unspecified %list.
*/ */
list(list&& __x) noexcept list(list&& __x) noexcept
: _Base(std::move(__x)) { } : _Base(std::move(__x)) { }
/** /**
* @brief Builds a %list from an initializer_list * @brief Builds a %list from an initializer_list
* @param l An initializer_list of value_type. * @param __l An initializer_list of value_type.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %list consisting of copies of the elements in the * Create a %list consisting of copies of the elements in the
* initializer_list @a l. This is linear in l.size(). * initializer_list @a __l. This is linear in __l.size().
*/ */
list(initializer_list<value_type> __l, list(initializer_list<value_type> __l,
const allocator_type& __a = allocator_type()) const allocator_type& __a = allocator_type())
@ -605,13 +606,13 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %list from a range. * @brief Builds a %list from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %list consisting of copies of the elements from * Create a %list consisting of copies of the elements from
* [@a first,@a last). This is linear in N (where N is * [@a __first,@a __last). This is linear in N (where N is
* distance(@a first,@a last)). * distance(@a __first,@a __last)).
*/ */
template<typename _InputIterator> template<typename _InputIterator>
list(_InputIterator __first, _InputIterator __last, list(_InputIterator __first, _InputIterator __last,
@ -633,9 +634,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %List assignment operator. * @brief %List assignment operator.
* @param x A %list of identical element and allocator types. * @param __x A %list of identical element and allocator types.
* *
* All the elements of @a x are copied, but unlike the copy * All the elements of @a __x are copied, but unlike the copy
* constructor, the allocator object is not copied. * constructor, the allocator object is not copied.
*/ */
list& list&
@ -644,10 +645,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %List move assignment operator. * @brief %List move assignment operator.
* @param x A %list of identical element and allocator types. * @param __x A %list of identical element and allocator types.
* *
* The contents of @a x are moved into this %list (without copying). * The contents of @a __x are moved into this %list (without copying).
* @a x is a valid, but unspecified %list * @a __x is a valid, but unspecified %list
*/ */
list& list&
operator=(list&& __x) operator=(list&& __x)
@ -661,10 +662,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %List initializer list assignment operator. * @brief %List initializer list assignment operator.
* @param l An initializer_list of value_type. * @param __l An initializer_list of value_type.
* *
* Replace the contents of the %list with copies of the elements * Replace the contents of the %list with copies of the elements
* in the initializer_list @a l. This is linear in l.size(). * in the initializer_list @a __l. This is linear in l.size().
*/ */
list& list&
operator=(initializer_list<value_type> __l) operator=(initializer_list<value_type> __l)
@ -676,10 +677,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Assigns a given value to a %list. * @brief Assigns a given value to a %list.
* @param n Number of elements to be assigned. * @param __n Number of elements to be assigned.
* @param val Value to be assigned. * @param __val Value to be assigned.
* *
* This function fills a %list with @a n copies of the given * This function fills a %list with @a __n copies of the given
* value. Note that the assignment completely changes the %list * value. Note that the assignment completely changes the %list
* and that the resulting %list's size is the same as the number * and that the resulting %list's size is the same as the number
* of elements assigned. Old data may be lost. * of elements assigned. Old data may be lost.
@ -690,11 +691,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Assigns a range to a %list. * @brief Assigns a range to a %list.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* This function fills a %list with copies of the elements in the * This function fills a %list with copies of the elements in the
* range [@a first,@a last). * range [@a __first,@a __last).
* *
* Note that the assignment completely changes the %list and * Note that the assignment completely changes the %list and
* that the resulting %list's size is the same as the number of * that the resulting %list's size is the same as the number of
@ -712,10 +713,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Assigns an initializer_list to a %list. * @brief Assigns an initializer_list to a %list.
* @param l An initializer_list of value_type. * @param __l An initializer_list of value_type.
* *
* Replace the contents of the %list with copies of the elements * Replace the contents of the %list with copies of the elements
* in the initializer_list @a l. This is linear in l.size(). * in the initializer_list @a __l. This is linear in __l.size().
*/ */
void void
assign(initializer_list<value_type> __l) assign(initializer_list<value_type> __l)
@ -859,7 +860,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Resizes the %list to the specified number of elements. * @brief Resizes the %list to the specified number of elements.
* @param new_size Number of elements the %list should contain. * @param __new_size Number of elements the %list should contain.
* *
* This function will %resize the %list to the specified number * This function will %resize the %list to the specified number
* of elements. If the number is smaller than the %list's * of elements. If the number is smaller than the %list's
@ -871,8 +872,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Resizes the %list to the specified number of elements. * @brief Resizes the %list to the specified number of elements.
* @param new_size Number of elements the %list should contain. * @param __new_size Number of elements the %list should contain.
* @param x Data with which new elements should be populated. * @param __x Data with which new elements should be populated.
* *
* This function will %resize the %list to the specified number * This function will %resize the %list to the specified number
* of elements. If the number is smaller than the %list's * of elements. If the number is smaller than the %list's
@ -884,8 +885,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
/** /**
* @brief Resizes the %list to the specified number of elements. * @brief Resizes the %list to the specified number of elements.
* @param new_size Number of elements the %list should contain. * @param __new_size Number of elements the %list should contain.
* @param x Data with which new elements should be populated. * @param __x Data with which new elements should be populated.
* *
* This function will %resize the %list to the specified number * This function will %resize the %list to the specified number
* of elements. If the number is smaller than the %list's * of elements. If the number is smaller than the %list's
@ -940,7 +941,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// [23.2.2.3] modifiers // [23.2.2.3] modifiers
/** /**
* @brief Add data to the front of the %list. * @brief Add data to the front of the %list.
* @param x Data to be added. * @param __x Data to be added.
* *
* This is a typical stack operation. The function creates an * This is a typical stack operation. The function creates an
* element at the front of the %list and assigns the given data * element at the front of the %list and assigns the given data
@ -981,7 +982,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Add data to the end of the %list. * @brief Add data to the end of the %list.
* @param x Data to be added. * @param __x Data to be added.
* *
* This is a typical stack operation. The function creates an * This is a typical stack operation. The function creates an
* element at the end of the %list and assigns the given data to * element at the end of the %list and assigns the given data to
@ -1022,8 +1023,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Constructs object in %list before specified iterator. * @brief Constructs object in %list before specified iterator.
* @param position A const_iterator into the %list. * @param __position A const_iterator into the %list.
* @param args Arguments. * @param __args Arguments.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert an object of type T constructed * This function will insert an object of type T constructed
@ -1039,8 +1040,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts given value into %list before specified iterator. * @brief Inserts given value into %list before specified iterator.
* @param position An iterator into the %list. * @param __position An iterator into the %list.
* @param x Data to be inserted. * @param __x Data to be inserted.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert a copy of the given value before * This function will insert a copy of the given value before
@ -1054,8 +1055,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Inserts given rvalue into %list before specified iterator. * @brief Inserts given rvalue into %list before specified iterator.
* @param position An iterator into the %list. * @param __position An iterator into the %list.
* @param x Data to be inserted. * @param __x Data to be inserted.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert a copy of the given rvalue before * This function will insert a copy of the given rvalue before
@ -1070,8 +1071,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts the contents of an initializer_list into %list * @brief Inserts the contents of an initializer_list into %list
* before specified iterator. * before specified iterator.
* @param p An iterator into the %list. * @param __p An iterator into the %list.
* @param l An initializer_list of value_type. * @param __l An initializer_list of value_type.
* *
* This function will insert copies of the data in the * This function will insert copies of the data in the
* initializer_list @a l into the %list before the location * initializer_list @a l into the %list before the location
@ -1087,9 +1088,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts a number of copies of given data into the %list. * @brief Inserts a number of copies of given data into the %list.
* @param position An iterator into the %list. * @param __position An iterator into the %list.
* @param n Number of elements to be inserted. * @param __n Number of elements to be inserted.
* @param x Data to be inserted. * @param __x Data to be inserted.
* *
* This function will insert a specified number of copies of the * This function will insert a specified number of copies of the
* given data before the location specified by @a position. * given data before the location specified by @a position.
@ -1106,9 +1107,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts a range into the %list. * @brief Inserts a range into the %list.
* @param position An iterator into the %list. * @param __position An iterator into the %list.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* This function will insert copies of the data in the range [@a * This function will insert copies of the data in the range [@a
* first,@a last) into the %list before the location specified by * first,@a last) into the %list before the location specified by
@ -1128,7 +1129,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove element at given position. * @brief Remove element at given position.
* @param position Iterator pointing to element to be erased. * @param __position Iterator pointing to element to be erased.
* @return An iterator pointing to the next element (or end()). * @return An iterator pointing to the next element (or end()).
* *
* This function will erase the element at the given position and thus * This function will erase the element at the given position and thus
@ -1146,8 +1147,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove a range of elements. * @brief Remove a range of elements.
* @param first Iterator pointing to the first element to be erased. * @param __first Iterator pointing to the first element to be erased.
* @param last Iterator pointing to one past the last element to be * @param __last Iterator pointing to one past the last element to be
* erased. * erased.
* @return An iterator pointing to the element pointed to by @a last * @return An iterator pointing to the element pointed to by @a last
* prior to erasing (or end()). * prior to erasing (or end()).
@ -1172,7 +1173,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Swaps data with another %list. * @brief Swaps data with another %list.
* @param x A %list of the same element and allocator types. * @param __x A %list of the same element and allocator types.
* *
* This exchanges the elements between two lists in constant * This exchanges the elements between two lists in constant
* time. Note that the global std::swap() function is * time. Note that the global std::swap() function is
@ -1207,14 +1208,14 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// [23.2.2.4] list operations // [23.2.2.4] list operations
/** /**
* @brief Insert contents of another %list. * @brief Insert contents of another %list.
* @param position Iterator referencing the element to insert before. * @param __position Iterator referencing the element to insert before.
* @param x Source list. * @param __x Source list.
* *
* The elements of @a x are inserted in constant time in front of * The elements of @a __x are inserted in constant time in front of
* the element referenced by @a position. @a x becomes an empty * the element referenced by @a __position. @a __x becomes an empty
* list. * list.
* *
* Requires this != @a x. * Requires this != @a __x.
*/ */
void void
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
@ -1239,12 +1240,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Insert element from another %list. * @brief Insert element from another %list.
* @param position Iterator referencing the element to insert before. * @param __position Iterator referencing the element to insert before.
* @param x Source list. * @param __x Source list.
* @param i Iterator referencing the element to move. * @param __i Iterator referencing the element to move.
* *
* Removes the element in list @a x referenced by @a i and * Removes the element in list @a __x referenced by @a __i and
* inserts it into the current list before @a position. * inserts it into the current list before @a __position.
*/ */
void void
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
@ -1272,15 +1273,15 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Insert range from another %list. * @brief Insert range from another %list.
* @param position Iterator referencing the element to insert before. * @param __position Iterator referencing the element to insert before.
* @param x Source list. * @param __x Source list.
* @param first Iterator referencing the start of range in x. * @param __first Iterator referencing the start of range in x.
* @param last Iterator referencing the end of range in x. * @param __last Iterator referencing the end of range in x.
* *
* Removes elements in the range [first,last) and inserts them * Removes elements in the range [__first,__last) and inserts them
* before @a position in constant time. * before @a __position in constant time.
* *
* Undefined if @a position is in [first,last). * Undefined if @a __position is in [__first,__last).
*/ */
void void
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
@ -1308,7 +1309,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove all elements equal to value. * @brief Remove all elements equal to value.
* @param value The value to remove. * @param __value The value to remove.
* *
* Removes every element in the list equal to @a value. * Removes every element in the list equal to @a value.
* Remaining elements stay in list order. Note that this * Remaining elements stay in list order. Note that this
@ -1322,7 +1323,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove all elements satisfying a predicate. * @brief Remove all elements satisfying a predicate.
* @param Predicate Unary predicate function or object. * @tparam _Predicate Unary predicate function or object.
* *
* Removes every element in the list for which the predicate * Removes every element in the list for which the predicate
* returns true. Remaining elements stay in list order. Note * returns true. Remaining elements stay in list order. Note
@ -1350,7 +1351,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove consecutive elements satisfying a predicate. * @brief Remove consecutive elements satisfying a predicate.
* @param BinaryPredicate Binary predicate function or object. * @tparam _BinaryPredicate Binary predicate function or object.
* *
* For each consecutive set of elements [first,last) that * For each consecutive set of elements [first,last) that
* satisfy predicate(first,i) where i is an iterator in * satisfy predicate(first,i) where i is an iterator in
@ -1366,12 +1367,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Merge sorted lists. * @brief Merge sorted lists.
* @param x Sorted list to merge. * @param __x Sorted list to merge.
* *
* Assumes that both @a x and this list are sorted according to * Assumes that both @a __x and this list are sorted according to
* operator<(). Merges elements of @a x into this list in * operator<(). Merges elements of @a __x into this list in
* sorted order, leaving @a x empty when complete. Elements in * sorted order, leaving @a __x empty when complete. Elements in
* this list precede elements in @a x that are equal. * this list precede elements in @a __x that are equal.
*/ */
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
void void
@ -1387,20 +1388,20 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Merge sorted lists according to comparison function. * @brief Merge sorted lists according to comparison function.
* @param x Sorted list to merge. * @param __x Sorted list to merge.
* @param StrictWeakOrdering Comparison function defining * @tparam _StrictWeakOrdering Comparison function defining
* sort order. * sort order.
* *
* Assumes that both @a x and this list are sorted according to * Assumes that both @a __x and this list are sorted according to
* StrictWeakOrdering. Merges elements of @a x into this list * StrictWeakOrdering. Merges elements of @a __x into this list
* in sorted order, leaving @a x empty when complete. Elements * in sorted order, leaving @a __x empty when complete. Elements
* in this list precede elements in @a x that are equivalent * in this list precede elements in @a __x that are equivalent
* according to StrictWeakOrdering(). * according to StrictWeakOrdering().
*/ */
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
template<typename _StrictWeakOrdering> template<typename _StrictWeakOrdering>
void void
merge(list&&, _StrictWeakOrdering); merge(list&& __x, _StrictWeakOrdering __comp);
template<typename _StrictWeakOrdering> template<typename _StrictWeakOrdering>
void void
@ -1409,7 +1410,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
template<typename _StrictWeakOrdering> template<typename _StrictWeakOrdering>
void void
merge(list&, _StrictWeakOrdering); merge(list& __x, _StrictWeakOrdering __comp);
#endif #endif
/** /**
@ -1557,8 +1558,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief List equality comparison. * @brief List equality comparison.
* @param x A %list. * @param __x A %list.
* @param y A %list of the same type as @a x. * @param __y A %list of the same type as @a __x.
* @return True iff the size and elements of the lists are equal. * @return True iff the size and elements of the lists are equal.
* *
* This is an equivalence relation. It is linear in the size of * This is an equivalence relation. It is linear in the size of
@ -1585,9 +1586,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief List ordering relation. * @brief List ordering relation.
* @param x A %list. * @param __x A %list.
* @param y A %list of the same type as @a x. * @param __y A %list of the same type as @a __x.
* @return True iff @a x is lexicographically less than @a y. * @return True iff @a __x is lexicographically less than @a __y.
* *
* This is a total ordering relation. It is linear in the size of the * This is a total ordering relation. It is linear in the size of the
* lists. The elements must be comparable with @c <. * lists. The elements must be comparable with @c <.

154
libstdc++-v3/include/bits/stl_map.h
View File

@ -154,8 +154,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %map with no elements. * @brief Creates a %map with no elements.
* @param comp A comparison object. * @param __comp A comparison object.
* @param a An allocator object. * @param __a An allocator object.
*/ */
explicit explicit
map(const _Compare& __comp, map(const _Compare& __comp,
@ -164,10 +164,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Map copy constructor. * @brief %Map copy constructor.
* @param x A %map of identical element and allocator types. * @param __x A %map of identical element and allocator types.
* *
* The newly-created %map uses a copy of the allocation object * The newly-created %map uses a copy of the allocation object
* used by @a x. * used by @a __x.
*/ */
map(const map& __x) map(const map& __x)
: _M_t(__x._M_t) { } : _M_t(__x._M_t) { }
@ -175,10 +175,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Map move constructor. * @brief %Map move constructor.
* @param x A %map of identical element and allocator types. * @param __x A %map of identical element and allocator types.
* *
* The newly-created %map contains the exact contents of @a x. * The newly-created %map contains the exact contents of @a __x.
* The contents of @a x are a valid, but unspecified %map. * The contents of @a __x are a valid, but unspecified %map.
*/ */
map(map&& __x) map(map&& __x)
noexcept(is_nothrow_copy_constructible<_Compare>::value) noexcept(is_nothrow_copy_constructible<_Compare>::value)
@ -186,30 +186,31 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %map from an initializer_list. * @brief Builds a %map from an initializer_list.
* @param l An initializer_list. * @param __l An initializer_list.
* @param comp A comparison object. * @param __comp A comparison object.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %map consisting of copies of the elements in the * Create a %map consisting of copies of the elements in the
* initializer_list @a l. * initializer_list @a __l.
* This is linear in N if the range is already sorted, and NlogN * This is linear in N if the range is already sorted, and NlogN
* otherwise (where N is @a l.size()). * otherwise (where N is @a __l.size()).
*/ */
map(initializer_list<value_type> __l, map(initializer_list<value_type> __l,
const _Compare& __c = _Compare(), const _Compare& __comp = _Compare(),
const allocator_type& __a = allocator_type()) const allocator_type& __a = allocator_type())
: _M_t(__c, __a) : _M_t(__comp, __a)
{ _M_t._M_insert_unique(__l.begin(), __l.end()); } { _M_t._M_insert_unique(__l.begin(), __l.end()); }
#endif #endif
/** /**
* @brief Builds a %map from a range. * @brief Builds a %map from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* Create a %map consisting of copies of the elements from [first,last). * Create a %map consisting of copies of the elements from
* This is linear in N if the range is already sorted, and NlogN * [__first,__last). This is linear in N if the range is
* otherwise (where N is distance(first,last)). * already sorted, and NlogN otherwise (where N is
* distance(__first,__last)).
*/ */
template<typename _InputIterator> template<typename _InputIterator>
map(_InputIterator __first, _InputIterator __last) map(_InputIterator __first, _InputIterator __last)
@ -218,14 +219,15 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %map from a range. * @brief Builds a %map from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param comp A comparison functor. * @param __comp A comparison functor.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %map consisting of copies of the elements from [first,last). * Create a %map consisting of copies of the elements from
* This is linear in N if the range is already sorted, and NlogN * [__first,__last). This is linear in N if the range is
* otherwise (where N is distance(first,last)). * already sorted, and NlogN otherwise (where N is
* distance(__first,__last)).
*/ */
template<typename _InputIterator> template<typename _InputIterator>
map(_InputIterator __first, _InputIterator __last, map(_InputIterator __first, _InputIterator __last,
@ -245,10 +247,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Map assignment operator. * @brief %Map assignment operator.
* @param x A %map of identical element and allocator types. * @param __x A %map of identical element and allocator types.
* *
* All the elements of @a x are copied, but unlike the copy constructor, * All the elements of @a __x are copied, but unlike the copy
* the allocator object is not copied. * constructor, the allocator object is not copied.
*/ */
map& map&
operator=(const map& __x) operator=(const map& __x)
@ -260,10 +262,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Map move assignment operator. * @brief %Map move assignment operator.
* @param x A %map of identical element and allocator types. * @param __x A %map of identical element and allocator types.
* *
* The contents of @a x are moved into this map (without copying). * The contents of @a __x are moved into this map (without copying).
* @a x is a valid, but unspecified %map. * @a __x is a valid, but unspecified %map.
*/ */
map& map&
operator=(map&& __x) operator=(map&& __x)
@ -277,10 +279,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Map list assignment operator. * @brief %Map list assignment operator.
* @param l An initializer_list. * @param __l An initializer_list.
* *
* This function fills a %map with copies of the elements in the * This function fills a %map with copies of the elements in the
* initializer list @a l. * initializer list @a __l.
* *
* Note that the assignment completely changes the %map and * Note that the assignment completely changes the %map and
* that the resulting %map's size is the same as the number * that the resulting %map's size is the same as the number
@ -432,7 +434,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// [23.3.1.2] element access // [23.3.1.2] element access
/** /**
* @brief Subscript ( @c [] ) access to %map data. * @brief Subscript ( @c [] ) access to %map data.
* @param k The key for which data should be retrieved. * @param __k The key for which data should be retrieved.
* @return A reference to the data of the (key,data) %pair. * @return A reference to the data of the (key,data) %pair.
* *
* Allows for easy lookup with the subscript ( @c [] ) * Allows for easy lookup with the subscript ( @c [] )
@ -474,8 +476,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// DR 464. Suggestion for new member functions in standard containers. // DR 464. Suggestion for new member functions in standard containers.
/** /**
* @brief Access to %map data. * @brief Access to %map data.
* @param k The key for which data should be retrieved. * @param __k The key for which data should be retrieved.
* @return A reference to the data whose key is equivalent to @a k, if * @return A reference to the data whose key is equivalent to @a __k, if
* such a data is present in the %map. * such a data is present in the %map.
* @throw std::out_of_range If no such data is present. * @throw std::out_of_range If no such data is present.
*/ */
@ -501,9 +503,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Attempts to insert a std::pair into the %map. * @brief Attempts to insert a std::pair into the %map.
* @param x Pair to be inserted (see std::make_pair for easy creation * @param __x Pair to be inserted (see std::make_pair for easy
* of pairs). * creation of pairs).
*
* @return A pair, of which the first element is an iterator that * @return A pair, of which the first element is an iterator that
* points to the possibly inserted pair, and the second is * points to the possibly inserted pair, and the second is
* a bool that is true if the pair was actually inserted. * a bool that is true if the pair was actually inserted.
@ -530,8 +532,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Attempts to insert a list of std::pairs into the %map. * @brief Attempts to insert a list of std::pairs into the %map.
* @param list A std::initializer_list<value_type> of pairs to be * @param __list A std::initializer_list<value_type> of pairs to be
* inserted. * inserted.
* *
* Complexity similar to that of the range constructor. * Complexity similar to that of the range constructor.
*/ */
@ -542,12 +544,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Attempts to insert a std::pair into the %map. * @brief Attempts to insert a std::pair into the %map.
* @param position An iterator that serves as a hint as to where the * @param __position An iterator that serves as a hint as to where the
* pair should be inserted. * pair should be inserted.
* @param x Pair to be inserted (see std::make_pair for easy creation * @param __x Pair to be inserted (see std::make_pair for easy creation
* of pairs). * of pairs).
* @return An iterator that points to the element with key of @a x (may * @return An iterator that points to the element with key of
* or may not be the %pair passed in). * @a __x (may or may not be the %pair passed in).
* *
* This function is not concerned about whether the insertion * This function is not concerned about whether the insertion
@ -583,9 +585,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Template function that attempts to insert a range of elements. * @brief Template function that attempts to insert a range of elements.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* inserted. * inserted.
* @param last Iterator pointing to the end of the range. * @param __last Iterator pointing to the end of the range.
* *
* Complexity similar to that of the range constructor. * Complexity similar to that of the range constructor.
*/ */
@ -599,7 +601,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// DR 130. Associative erase should return an iterator. // DR 130. Associative erase should return an iterator.
/** /**
* @brief Erases an element from a %map. * @brief Erases an element from a %map.
* @param position An iterator pointing to the element to be erased. * @param __position An iterator pointing to the element to be erased.
* @return An iterator pointing to the element immediately following * @return An iterator pointing to the element immediately following
* @a position prior to the element being erased. If no such * @a position prior to the element being erased. If no such
* element exists, end() is returned. * element exists, end() is returned.
@ -616,7 +618,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
/** /**
* @brief Erases an element from a %map. * @brief Erases an element from a %map.
* @param position An iterator pointing to the element to be erased. * @param __position An iterator pointing to the element to be erased.
* *
* This function erases an element, pointed to by the given * This function erases an element, pointed to by the given
* iterator, from a %map. Note that this function only erases * iterator, from a %map. Note that this function only erases
@ -631,7 +633,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Erases elements according to the provided key. * @brief Erases elements according to the provided key.
* @param x Key of element to be erased. * @param __x Key of element to be erased.
* @return The number of elements erased. * @return The number of elements erased.
* *
* This function erases all the elements located by the given key from * This function erases all the elements located by the given key from
@ -649,10 +651,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// DR 130. Associative erase should return an iterator. // DR 130. Associative erase should return an iterator.
/** /**
* @brief Erases a [first,last) range of elements from a %map. * @brief Erases a [first,last) range of elements from a %map.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* erased. * erased.
* @param last Iterator pointing to the end of the range to be erased. * @param __last Iterator pointing to the end of the range to
* @return The iterator @a last. * be erased.
* @return The iterator @a __last.
* *
* This function erases a sequence of elements from a %map. * This function erases a sequence of elements from a %map.
* Note that this function only erases the element, and that if * Note that this function only erases the element, and that if
@ -664,10 +667,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
{ return _M_t.erase(__first, __last); } { return _M_t.erase(__first, __last); }
#else #else
/** /**
* @brief Erases a [first,last) range of elements from a %map. * @brief Erases a [__first,__last) range of elements from a %map.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* erased. * erased.
* @param last Iterator pointing to the end of the range to be erased. * @param __last Iterator pointing to the end of the range to
* be erased.
* *
* This function erases a sequence of elements from a %map. * This function erases a sequence of elements from a %map.
* Note that this function only erases the element, and that if * Note that this function only erases the element, and that if
@ -681,7 +685,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Swaps data with another %map. * @brief Swaps data with another %map.
* @param x A %map of the same element and allocator types. * @param __x A %map of the same element and allocator types.
* *
* This exchanges the elements between two maps in constant * This exchanges the elements between two maps in constant
* time. (It is only swapping a pointer, an integer, and an * time. (It is only swapping a pointer, an integer, and an
@ -724,7 +728,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// [23.3.1.3] map operations // [23.3.1.3] map operations
/** /**
* @brief Tries to locate an element in a %map. * @brief Tries to locate an element in a %map.
* @param x Key of (key, value) %pair to be located. * @param __x Key of (key, value) %pair to be located.
* @return Iterator pointing to sought-after element, or end() if not * @return Iterator pointing to sought-after element, or end() if not
* found. * found.
* *
@ -739,7 +743,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Tries to locate an element in a %map. * @brief Tries to locate an element in a %map.
* @param x Key of (key, value) %pair to be located. * @param __x Key of (key, value) %pair to be located.
* @return Read-only (constant) iterator pointing to sought-after * @return Read-only (constant) iterator pointing to sought-after
* element, or end() if not found. * element, or end() if not found.
* *
@ -754,7 +758,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the number of elements with given key. * @brief Finds the number of elements with given key.
* @param x Key of (key, value) pairs to be located. * @param __x Key of (key, value) pairs to be located.
* @return Number of elements with specified key. * @return Number of elements with specified key.
* *
* This function only makes sense for multimaps; for map the result will * This function only makes sense for multimaps; for map the result will
@ -766,7 +770,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the beginning of a subsequence matching given key. * @brief Finds the beginning of a subsequence matching given key.
* @param x Key of (key, value) pair to be located. * @param __x Key of (key, value) pair to be located.
* @return Iterator pointing to first element equal to or greater * @return Iterator pointing to first element equal to or greater
* than key, or end(). * than key, or end().
* *
@ -781,7 +785,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the beginning of a subsequence matching given key. * @brief Finds the beginning of a subsequence matching given key.
* @param x Key of (key, value) pair to be located. * @param __x Key of (key, value) pair to be located.
* @return Read-only (constant) iterator pointing to first element * @return Read-only (constant) iterator pointing to first element
* equal to or greater than key, or end(). * equal to or greater than key, or end().
* *
@ -796,7 +800,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the end of a subsequence matching given key. * @brief Finds the end of a subsequence matching given key.
* @param x Key of (key, value) pair to be located. * @param __x Key of (key, value) pair to be located.
* @return Iterator pointing to the first element * @return Iterator pointing to the first element
* greater than key, or end(). * greater than key, or end().
*/ */
@ -806,7 +810,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the end of a subsequence matching given key. * @brief Finds the end of a subsequence matching given key.
* @param x Key of (key, value) pair to be located. * @param __x Key of (key, value) pair to be located.
* @return Read-only (constant) iterator pointing to first iterator * @return Read-only (constant) iterator pointing to first iterator
* greater than key, or end(). * greater than key, or end().
*/ */
@ -816,7 +820,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds a subsequence matching given key. * @brief Finds a subsequence matching given key.
* @param x Key of (key, value) pairs to be located. * @param __x Key of (key, value) pairs to be located.
* @return Pair of iterators that possibly points to the subsequence * @return Pair of iterators that possibly points to the subsequence
* matching given key. * matching given key.
* *
@ -835,7 +839,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds a subsequence matching given key. * @brief Finds a subsequence matching given key.
* @param x Key of (key, value) pairs to be located. * @param __x Key of (key, value) pairs to be located.
* @return Pair of read-only (constant) iterators that possibly points * @return Pair of read-only (constant) iterators that possibly points
* to the subsequence matching given key. * to the subsequence matching given key.
* *
@ -865,8 +869,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Map equality comparison. * @brief Map equality comparison.
* @param x A %map. * @param __x A %map.
* @param y A %map of the same type as @a x. * @param __y A %map of the same type as @a x.
* @return True iff the size and elements of the maps are equal. * @return True iff the size and elements of the maps are equal.
* *
* This is an equivalence relation. It is linear in the size of the * This is an equivalence relation. It is linear in the size of the
@ -881,8 +885,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Map ordering relation. * @brief Map ordering relation.
* @param x A %map. * @param __x A %map.
* @param y A %map of the same type as @a x. * @param __y A %map of the same type as @a x.
* @return True iff @a x is lexicographically less than @a y. * @return True iff @a x is lexicographically less than @a y.
* *
* This is a total ordering relation. It is linear in the size of the * This is a total ordering relation. It is linear in the size of the

132
libstdc++-v3/include/bits/stl_multimap.h
View File

@ -152,8 +152,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %multimap with no elements. * @brief Creates a %multimap with no elements.
* @param comp A comparison object. * @param __comp A comparison object.
* @param a An allocator object. * @param __a An allocator object.
*/ */
explicit explicit
multimap(const _Compare& __comp, multimap(const _Compare& __comp,
@ -162,10 +162,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Multimap copy constructor. * @brief %Multimap copy constructor.
* @param x A %multimap of identical element and allocator types. * @param __x A %multimap of identical element and allocator types.
* *
* The newly-created %multimap uses a copy of the allocation object * The newly-created %multimap uses a copy of the allocation object
* used by @a x. * used by @a __x.
*/ */
multimap(const multimap& __x) multimap(const multimap& __x)
: _M_t(__x._M_t) { } : _M_t(__x._M_t) { }
@ -173,10 +173,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Multimap move constructor. * @brief %Multimap move constructor.
* @param x A %multimap of identical element and allocator types. * @param __x A %multimap of identical element and allocator types.
* *
* The newly-created %multimap contains the exact contents of @a x. * The newly-created %multimap contains the exact contents of @a __x.
* The contents of @a x are a valid, but unspecified %multimap. * The contents of @a __x are a valid, but unspecified %multimap.
*/ */
multimap(multimap&& __x) multimap(multimap&& __x)
noexcept(is_nothrow_copy_constructible<_Compare>::value) noexcept(is_nothrow_copy_constructible<_Compare>::value)
@ -184,9 +184,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %multimap from an initializer_list. * @brief Builds a %multimap from an initializer_list.
* @param l An initializer_list. * @param __l An initializer_list.
* @param comp A comparison functor. * @param __comp A comparison functor.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %multimap consisting of copies of the elements from * Create a %multimap consisting of copies of the elements from
* the initializer_list. This is linear in N if the list is already * the initializer_list. This is linear in N if the list is already
@ -201,12 +201,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %multimap from a range. * @brief Builds a %multimap from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* Create a %multimap consisting of copies of the elements from * Create a %multimap consisting of copies of the elements from
* [first,last). This is linear in N if the range is already sorted, * [__first,__last). This is linear in N if the range is already sorted,
* and NlogN otherwise (where N is distance(first,last)). * and NlogN otherwise (where N is distance(__first,__last)).
*/ */
template<typename _InputIterator> template<typename _InputIterator>
multimap(_InputIterator __first, _InputIterator __last) multimap(_InputIterator __first, _InputIterator __last)
@ -215,14 +215,14 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %multimap from a range. * @brief Builds a %multimap from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param comp A comparison functor. * @param __comp A comparison functor.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %multimap consisting of copies of the elements from * Create a %multimap consisting of copies of the elements from
* [first,last). This is linear in N if the range is already sorted, * [__first,__last). This is linear in N if the range is already sorted,
* and NlogN otherwise (where N is distance(first,last)). * and NlogN otherwise (where N is distance(__first,__last)).
*/ */
template<typename _InputIterator> template<typename _InputIterator>
multimap(_InputIterator __first, _InputIterator __last, multimap(_InputIterator __first, _InputIterator __last,
@ -242,10 +242,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Multimap assignment operator. * @brief %Multimap assignment operator.
* @param x A %multimap of identical element and allocator types. * @param __x A %multimap of identical element and allocator types.
* *
* All the elements of @a x are copied, but unlike the copy constructor, * All the elements of @a __x are copied, but unlike the copy
* the allocator object is not copied. * constructor, the allocator object is not copied.
*/ */
multimap& multimap&
operator=(const multimap& __x) operator=(const multimap& __x)
@ -257,10 +257,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Multimap move assignment operator. * @brief %Multimap move assignment operator.
* @param x A %multimap of identical element and allocator types. * @param __x A %multimap of identical element and allocator types.
* *
* The contents of @a x are moved into this multimap (without copying). * The contents of @a __x are moved into this multimap (without copying).
* @a x is a valid, but unspecified multimap. * @a __x is a valid, but unspecified multimap.
*/ */
multimap& multimap&
operator=(multimap&& __x) operator=(multimap&& __x)
@ -274,10 +274,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Multimap list assignment operator. * @brief %Multimap list assignment operator.
* @param l An initializer_list. * @param __l An initializer_list.
* *
* This function fills a %multimap with copies of the elements * This function fills a %multimap with copies of the elements
* in the initializer list @a l. * in the initializer list @a __l.
* *
* Note that the assignment completely changes the %multimap and * Note that the assignment completely changes the %multimap and
* that the resulting %multimap's size is the same as the number * that the resulting %multimap's size is the same as the number
@ -427,7 +427,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// modifiers // modifiers
/** /**
* @brief Inserts a std::pair into the %multimap. * @brief Inserts a std::pair into the %multimap.
* @param x Pair to be inserted (see std::make_pair for easy creation * @param __x Pair to be inserted (see std::make_pair for easy creation
* of pairs). * of pairs).
* @return An iterator that points to the inserted (key,value) pair. * @return An iterator that points to the inserted (key,value) pair.
* *
@ -452,10 +452,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts a std::pair into the %multimap. * @brief Inserts a std::pair into the %multimap.
* @param position An iterator that serves as a hint as to where the * @param __position An iterator that serves as a hint as to where the
* pair should be inserted. * pair should be inserted.
* @param x Pair to be inserted (see std::make_pair for easy creation * @param __x Pair to be inserted (see std::make_pair for easy creation
* of pairs). * of pairs).
* @return An iterator that points to the inserted (key,value) pair. * @return An iterator that points to the inserted (key,value) pair.
* *
* This function inserts a (key, value) pair into the %multimap. * This function inserts a (key, value) pair into the %multimap.
@ -491,9 +491,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief A template function that attempts to insert a range * @brief A template function that attempts to insert a range
* of elements. * of elements.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* inserted. * inserted.
* @param last Iterator pointing to the end of the range. * @param __last Iterator pointing to the end of the range.
* *
* Complexity similar to that of the range constructor. * Complexity similar to that of the range constructor.
*/ */
@ -505,8 +505,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Attempts to insert a list of std::pairs into the %multimap. * @brief Attempts to insert a list of std::pairs into the %multimap.
* @param list A std::initializer_list<value_type> of pairs to be * @param __l A std::initializer_list<value_type> of pairs to be
* inserted. * inserted.
* *
* Complexity similar to that of the range constructor. * Complexity similar to that of the range constructor.
*/ */
@ -520,7 +520,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// DR 130. Associative erase should return an iterator. // DR 130. Associative erase should return an iterator.
/** /**
* @brief Erases an element from a %multimap. * @brief Erases an element from a %multimap.
* @param position An iterator pointing to the element to be erased. * @param __position An iterator pointing to the element to be erased.
* @return An iterator pointing to the element immediately following * @return An iterator pointing to the element immediately following
* @a position prior to the element being erased. If no such * @a position prior to the element being erased. If no such
* element exists, end() is returned. * element exists, end() is returned.
@ -537,7 +537,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
/** /**
* @brief Erases an element from a %multimap. * @brief Erases an element from a %multimap.
* @param position An iterator pointing to the element to be erased. * @param __position An iterator pointing to the element to be erased.
* *
* This function erases an element, pointed to by the given iterator, * This function erases an element, pointed to by the given iterator,
* from a %multimap. Note that this function only erases the element, * from a %multimap. Note that this function only erases the element,
@ -552,7 +552,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Erases elements according to the provided key. * @brief Erases elements according to the provided key.
* @param x Key of element to be erased. * @param __x Key of element to be erased.
* @return The number of elements erased. * @return The number of elements erased.
* *
* This function erases all elements located by the given key from a * This function erases all elements located by the given key from a
@ -570,10 +570,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// DR 130. Associative erase should return an iterator. // DR 130. Associative erase should return an iterator.
/** /**
* @brief Erases a [first,last) range of elements from a %multimap. * @brief Erases a [first,last) range of elements from a %multimap.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* erased. * erased.
* @param last Iterator pointing to the end of the range to be erased. * @param __last Iterator pointing to the end of the range to be
* @return The iterator @a last. * erased .
* @return The iterator @a __last.
* *
* This function erases a sequence of elements from a %multimap. * This function erases a sequence of elements from a %multimap.
* Note that this function only erases the elements, and that if * Note that this function only erases the elements, and that if
@ -589,9 +590,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// DR 130. Associative erase should return an iterator. // DR 130. Associative erase should return an iterator.
/** /**
* @brief Erases a [first,last) range of elements from a %multimap. * @brief Erases a [first,last) range of elements from a %multimap.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* erased. * erased.
* @param last Iterator pointing to the end of the range to be erased. * @param __last Iterator pointing to the end of the range to
* be erased.
* *
* This function erases a sequence of elements from a %multimap. * This function erases a sequence of elements from a %multimap.
* Note that this function only erases the elements, and that if * Note that this function only erases the elements, and that if
@ -606,7 +608,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Swaps data with another %multimap. * @brief Swaps data with another %multimap.
* @param x A %multimap of the same element and allocator types. * @param __x A %multimap of the same element and allocator types.
* *
* This exchanges the elements between two multimaps in constant time. * This exchanges the elements between two multimaps in constant time.
* (It is only swapping a pointer, an integer, and an instance of * (It is only swapping a pointer, an integer, and an instance of
@ -649,7 +651,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// multimap operations // multimap operations
/** /**
* @brief Tries to locate an element in a %multimap. * @brief Tries to locate an element in a %multimap.
* @param x Key of (key, value) pair to be located. * @param __x Key of (key, value) pair to be located.
* @return Iterator pointing to sought-after element, * @return Iterator pointing to sought-after element,
* or end() if not found. * or end() if not found.
* *
@ -664,7 +666,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Tries to locate an element in a %multimap. * @brief Tries to locate an element in a %multimap.
* @param x Key of (key, value) pair to be located. * @param __x Key of (key, value) pair to be located.
* @return Read-only (constant) iterator pointing to sought-after * @return Read-only (constant) iterator pointing to sought-after
* element, or end() if not found. * element, or end() if not found.
* *
@ -679,7 +681,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the number of elements with given key. * @brief Finds the number of elements with given key.
* @param x Key of (key, value) pairs to be located. * @param __x Key of (key, value) pairs to be located.
* @return Number of elements with specified key. * @return Number of elements with specified key.
*/ */
size_type size_type
@ -688,7 +690,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the beginning of a subsequence matching given key. * @brief Finds the beginning of a subsequence matching given key.
* @param x Key of (key, value) pair to be located. * @param __x Key of (key, value) pair to be located.
* @return Iterator pointing to first element equal to or greater * @return Iterator pointing to first element equal to or greater
* than key, or end(). * than key, or end().
* *
@ -703,14 +705,14 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the beginning of a subsequence matching given key. * @brief Finds the beginning of a subsequence matching given key.
* @param x Key of (key, value) pair to be located. * @param __x Key of (key, value) pair to be located.
* @return Read-only (constant) iterator pointing to first element * @return Read-only (constant) iterator pointing to first element
* equal to or greater than key, or end(). * equal to or greater than key, or end().
* *
* This function returns the first element of a subsequence of elements * This function returns the first element of a subsequence of
* that matches the given key. If unsuccessful the iterator will point * elements that matches the given key. If unsuccessful the
* to the next greatest element or, if no such greater element exists, to * iterator will point to the next greatest element or, if no
* end(). * such greater element exists, to end().
*/ */
const_iterator const_iterator
lower_bound(const key_type& __x) const lower_bound(const key_type& __x) const
@ -718,7 +720,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the end of a subsequence matching given key. * @brief Finds the end of a subsequence matching given key.
* @param x Key of (key, value) pair to be located. * @param __x Key of (key, value) pair to be located.
* @return Iterator pointing to the first element * @return Iterator pointing to the first element
* greater than key, or end(). * greater than key, or end().
*/ */
@ -728,7 +730,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the end of a subsequence matching given key. * @brief Finds the end of a subsequence matching given key.
* @param x Key of (key, value) pair to be located. * @param __x Key of (key, value) pair to be located.
* @return Read-only (constant) iterator pointing to first iterator * @return Read-only (constant) iterator pointing to first iterator
* greater than key, or end(). * greater than key, or end().
*/ */
@ -738,7 +740,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds a subsequence matching given key. * @brief Finds a subsequence matching given key.
* @param x Key of (key, value) pairs to be located. * @param __x Key of (key, value) pairs to be located.
* @return Pair of iterators that possibly points to the subsequence * @return Pair of iterators that possibly points to the subsequence
* matching given key. * matching given key.
* *
@ -755,7 +757,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds a subsequence matching given key. * @brief Finds a subsequence matching given key.
* @param x Key of (key, value) pairs to be located. * @param __x Key of (key, value) pairs to be located.
* @return Pair of read-only (constant) iterators that possibly points * @return Pair of read-only (constant) iterators that possibly points
* to the subsequence matching given key. * to the subsequence matching given key.
* *
@ -783,8 +785,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Multimap equality comparison. * @brief Multimap equality comparison.
* @param x A %multimap. * @param __x A %multimap.
* @param y A %multimap of the same type as @a x. * @param __y A %multimap of the same type as @a __x.
* @return True iff the size and elements of the maps are equal. * @return True iff the size and elements of the maps are equal.
* *
* This is an equivalence relation. It is linear in the size of the * This is an equivalence relation. It is linear in the size of the
@ -799,8 +801,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Multimap ordering relation. * @brief Multimap ordering relation.
* @param x A %multimap. * @param __x A %multimap.
* @param y A %multimap of the same type as @a x. * @param __y A %multimap of the same type as @a __x.
* @return True iff @a x is lexicographically less than @a y. * @return True iff @a x is lexicographically less than @a y.
* *
* This is a total ordering relation. It is linear in the size of the * This is a total ordering relation. It is linear in the size of the

109
libstdc++-v3/include/bits/stl_multiset.h
View File

@ -133,8 +133,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %multiset with no elements. * @brief Creates a %multiset with no elements.
* @param comp Comparator to use. * @param __comp Comparator to use.
* @param a An allocator object. * @param __a An allocator object.
*/ */
explicit explicit
multiset(const _Compare& __comp, multiset(const _Compare& __comp,
@ -143,12 +143,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %multiset from a range. * @brief Builds a %multiset from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* Create a %multiset consisting of copies of the elements from * Create a %multiset consisting of copies of the elements from
* [first,last). This is linear in N if the range is already sorted, * [first,last). This is linear in N if the range is already sorted,
* and NlogN otherwise (where N is distance(first,last)). * and NlogN otherwise (where N is distance(__first,__last)).
*/ */
template<typename _InputIterator> template<typename _InputIterator>
multiset(_InputIterator __first, _InputIterator __last) multiset(_InputIterator __first, _InputIterator __last)
@ -157,14 +157,14 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %multiset from a range. * @brief Builds a %multiset from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param comp A comparison functor. * @param __comp A comparison functor.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %multiset consisting of copies of the elements from * Create a %multiset consisting of copies of the elements from
* [first,last). This is linear in N if the range is already sorted, * [__first,__last). This is linear in N if the range is already sorted,
* and NlogN otherwise (where N is distance(first,last)). * and NlogN otherwise (where N is distance(__first,__last)).
*/ */
template<typename _InputIterator> template<typename _InputIterator>
multiset(_InputIterator __first, _InputIterator __last, multiset(_InputIterator __first, _InputIterator __last,
@ -175,10 +175,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Multiset copy constructor. * @brief %Multiset copy constructor.
* @param x A %multiset of identical element and allocator types. * @param __x A %multiset of identical element and allocator types.
* *
* The newly-created %multiset uses a copy of the allocation object used * The newly-created %multiset uses a copy of the allocation object used
* by @a x. * by @a __x.
*/ */
multiset(const multiset& __x) multiset(const multiset& __x)
: _M_t(__x._M_t) { } : _M_t(__x._M_t) { }
@ -186,10 +186,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Multiset move constructor. * @brief %Multiset move constructor.
* @param x A %multiset of identical element and allocator types. * @param __x A %multiset of identical element and allocator types.
* *
* The newly-created %multiset contains the exact contents of @a x. * The newly-created %multiset contains the exact contents of @a __x.
* The contents of @a x are a valid, but unspecified %multiset. * The contents of @a __x are a valid, but unspecified %multiset.
*/ */
multiset(multiset&& __x) multiset(multiset&& __x)
noexcept(is_nothrow_copy_constructible<_Compare>::value) noexcept(is_nothrow_copy_constructible<_Compare>::value)
@ -197,13 +197,13 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %multiset from an initializer_list. * @brief Builds a %multiset from an initializer_list.
* @param l An initializer_list. * @param __l An initializer_list.
* @param comp A comparison functor. * @param __comp A comparison functor.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %multiset consisting of copies of the elements from * Create a %multiset consisting of copies of the elements from
* the list. This is linear in N if the list is already sorted, * the list. This is linear in N if the list is already sorted,
* and NlogN otherwise (where N is @a l.size()). * and NlogN otherwise (where N is @a __l.size()).
*/ */
multiset(initializer_list<value_type> __l, multiset(initializer_list<value_type> __l,
const _Compare& __comp = _Compare(), const _Compare& __comp = _Compare(),
@ -214,10 +214,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Multiset assignment operator. * @brief %Multiset assignment operator.
* @param x A %multiset of identical element and allocator types. * @param __x A %multiset of identical element and allocator types.
* *
* All the elements of @a x are copied, but unlike the copy constructor, * All the elements of @a __x are copied, but unlike the copy
* the allocator object is not copied. * constructor, the allocator object is not copied.
*/ */
multiset& multiset&
operator=(const multiset& __x) operator=(const multiset& __x)
@ -229,10 +229,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Multiset move assignment operator. * @brief %Multiset move assignment operator.
* @param x A %multiset of identical element and allocator types. * @param __x A %multiset of identical element and allocator types.
* *
* The contents of @a x are moved into this %multiset (without copying). * The contents of @a __x are moved into this %multiset
* @a x is a valid, but unspecified %multiset. * (without copying). @a __x is a valid, but unspecified
* %multiset.
*/ */
multiset& multiset&
operator=(multiset&& __x) operator=(multiset&& __x)
@ -246,10 +247,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Multiset list assignment operator. * @brief %Multiset list assignment operator.
* @param l An initializer_list. * @param __l An initializer_list.
* *
* This function fills a %multiset with copies of the elements in the * This function fills a %multiset with copies of the elements in the
* initializer list @a l. * initializer list @a __l.
* *
* Note that the assignment completely changes the %multiset and * Note that the assignment completely changes the %multiset and
* that the resulting %multiset's size is the same as the number * that the resulting %multiset's size is the same as the number
@ -370,7 +371,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Swaps data with another %multiset. * @brief Swaps data with another %multiset.
* @param x A %multiset of the same element and allocator types. * @param __x A %multiset of the same element and allocator types.
* *
* This exchanges the elements between two multisets in constant time. * This exchanges the elements between two multisets in constant time.
* (It is only swapping a pointer, an integer, and an instance of the @c * (It is only swapping a pointer, an integer, and an instance of the @c
@ -386,7 +387,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// insert/erase // insert/erase
/** /**
* @brief Inserts an element into the %multiset. * @brief Inserts an element into the %multiset.
* @param x Element to be inserted. * @param __x Element to be inserted.
* @return An iterator that points to the inserted element. * @return An iterator that points to the inserted element.
* *
* This function inserts an element into the %multiset. Contrary * This function inserts an element into the %multiset. Contrary
@ -407,9 +408,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts an element into the %multiset. * @brief Inserts an element into the %multiset.
* @param position An iterator that serves as a hint as to where the * @param __position An iterator that serves as a hint as to where the
* element should be inserted. * element should be inserted.
* @param x Element to be inserted. * @param __x Element to be inserted.
* @return An iterator that points to the inserted element. * @return An iterator that points to the inserted element.
* *
* This function inserts an element into the %multiset. Contrary * This function inserts an element into the %multiset. Contrary
@ -437,9 +438,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief A template function that tries to insert a range of elements. * @brief A template function that tries to insert a range of elements.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* inserted. * inserted.
* @param last Iterator pointing to the end of the range. * @param __last Iterator pointing to the end of the range.
* *
* Complexity similar to that of the range constructor. * Complexity similar to that of the range constructor.
*/ */
@ -451,8 +452,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Attempts to insert a list of elements into the %multiset. * @brief Attempts to insert a list of elements into the %multiset.
* @param list A std::initializer_list<value_type> of elements * @param __l A std::initializer_list<value_type> of elements
* to be inserted. * to be inserted.
* *
* Complexity similar to that of the range constructor. * Complexity similar to that of the range constructor.
*/ */
@ -466,7 +467,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// DR 130. Associative erase should return an iterator. // DR 130. Associative erase should return an iterator.
/** /**
* @brief Erases an element from a %multiset. * @brief Erases an element from a %multiset.
* @param position An iterator pointing to the element to be erased. * @param __position An iterator pointing to the element to be erased.
* @return An iterator pointing to the element immediately following * @return An iterator pointing to the element immediately following
* @a position prior to the element being erased. If no such * @a position prior to the element being erased. If no such
* element exists, end() is returned. * element exists, end() is returned.
@ -483,7 +484,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
/** /**
* @brief Erases an element from a %multiset. * @brief Erases an element from a %multiset.
* @param position An iterator pointing to the element to be erased. * @param __position An iterator pointing to the element to be erased.
* *
* This function erases an element, pointed to by the given iterator, * This function erases an element, pointed to by the given iterator,
* from a %multiset. Note that this function only erases the element, * from a %multiset. Note that this function only erases the element,
@ -498,7 +499,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Erases elements according to the provided key. * @brief Erases elements according to the provided key.
* @param x Key of element to be erased. * @param __x Key of element to be erased.
* @return The number of elements erased. * @return The number of elements erased.
* *
* This function erases all elements located by the given key from a * This function erases all elements located by the given key from a
@ -516,9 +517,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// DR 130. Associative erase should return an iterator. // DR 130. Associative erase should return an iterator.
/** /**
* @brief Erases a [first,last) range of elements from a %multiset. * @brief Erases a [first,last) range of elements from a %multiset.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* erased. * erased.
* @param last Iterator pointing to the end of the range to be erased. * @param __last Iterator pointing to the end of the range to
* be erased.
* @return The iterator @a last. * @return The iterator @a last.
* *
* This function erases a sequence of elements from a %multiset. * This function erases a sequence of elements from a %multiset.
@ -562,7 +564,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the number of elements with given key. * @brief Finds the number of elements with given key.
* @param x Key of elements to be located. * @param __x Key of elements to be located.
* @return Number of elements with specified key. * @return Number of elements with specified key.
*/ */
size_type size_type
@ -574,7 +576,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Tries to locate an element in a %set. * @brief Tries to locate an element in a %set.
* @param x Element to be located. * @param __x Element to be located.
* @return Iterator pointing to sought-after element, or end() if not * @return Iterator pointing to sought-after element, or end() if not
* found. * found.
* *
@ -595,7 +597,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Finds the beginning of a subsequence matching given key. * @brief Finds the beginning of a subsequence matching given key.
* @param x Key to be located. * @param __x Key to be located.
* @return Iterator pointing to first element equal to or greater * @return Iterator pointing to first element equal to or greater
* than key, or end(). * than key, or end().
* *
@ -616,7 +618,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Finds the end of a subsequence matching given key. * @brief Finds the end of a subsequence matching given key.
* @param x Key to be located. * @param __x Key to be located.
* @return Iterator pointing to the first element * @return Iterator pointing to the first element
* greater than key, or end(). * greater than key, or end().
*/ */
@ -632,7 +634,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Finds a subsequence matching given key. * @brief Finds a subsequence matching given key.
* @param x Key to be located. * @param __x Key to be located.
* @return Pair of iterators that possibly points to the subsequence * @return Pair of iterators that possibly points to the subsequence
* matching given key. * matching given key.
* *
@ -652,6 +654,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
std::pair<const_iterator, const_iterator> std::pair<const_iterator, const_iterator>
equal_range(const key_type& __x) const equal_range(const key_type& __x) const
{ return _M_t.equal_range(__x); } { return _M_t.equal_range(__x); }
//@}
template<typename _K1, typename _C1, typename _A1> template<typename _K1, typename _C1, typename _A1>
friend bool friend bool
@ -666,8 +669,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Multiset equality comparison. * @brief Multiset equality comparison.
* @param x A %multiset. * @param __x A %multiset.
* @param y A %multiset of the same type as @a x. * @param __y A %multiset of the same type as @a __x.
* @return True iff the size and elements of the multisets are equal. * @return True iff the size and elements of the multisets are equal.
* *
* This is an equivalence relation. It is linear in the size of the * This is an equivalence relation. It is linear in the size of the
@ -683,9 +686,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Multiset ordering relation. * @brief Multiset ordering relation.
* @param x A %multiset. * @param __x A %multiset.
* @param y A %multiset of the same type as @a x. * @param __y A %multiset of the same type as @a __x.
* @return True iff @a x is lexicographically less than @a y. * @return True iff @a __x is lexicographically less than @a __y.
* *
* This is a total ordering relation. It is linear in the size of the * This is a total ordering relation. It is linear in the size of the
* maps. The elements must be comparable with @c <. * maps. The elements must be comparable with @c <.

68
libstdc++-v3/include/bits/stl_numeric.h
View File

@ -73,9 +73,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* For each element in the range @p [first,last) assigns @p value and * For each element in the range @p [first,last) assigns @p value and
* increments @p value as if by @p ++value. * increments @p value as if by @p ++value.
* *
* @param first Start of range. * @param __first Start of range.
* @param last End of range. * @param __last End of range.
* @param value Starting value. * @param __value Starting value.
* @return Nothing. * @return Nothing.
*/ */
template<typename _ForwardIterator, typename _Tp> template<typename _ForwardIterator, typename _Tp>
@ -111,9 +111,9 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
* Accumulates the values in the range [first,last) using operator+(). The * Accumulates the values in the range [first,last) using operator+(). The
* initial value is @a init. The values are processed in order. * initial value is @a init. The values are processed in order.
* *
* @param first Start of range. * @param __first Start of range.
* @param last End of range. * @param __last End of range.
* @param init Starting value to add other values to. * @param __init Starting value to add other values to.
* @return The final sum. * @return The final sum.
*/ */
template<typename _InputIterator, typename _Tp> template<typename _InputIterator, typename _Tp>
@ -136,10 +136,10 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
* object @a binary_op. The initial value is @a init. The values are * object @a binary_op. The initial value is @a init. The values are
* processed in order. * processed in order.
* *
* @param first Start of range. * @param __first Start of range.
* @param last End of range. * @param __last End of range.
* @param init Starting value to add other values to. * @param __init Starting value to add other values to.
* @param binary_op Function object to accumulate with. * @param __binary_op Function object to accumulate with.
* @return The final sum. * @return The final sum.
*/ */
template<typename _InputIterator, typename _Tp, typename _BinaryOperation> template<typename _InputIterator, typename _Tp, typename _BinaryOperation>
@ -164,10 +164,10 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
* value using operator+(). The values in the ranges are processed in * value using operator+(). The values in the ranges are processed in
* order. * order.
* *
* @param first1 Start of range 1. * @param __first1 Start of range 1.
* @param last1 End of range 1. * @param __last1 End of range 1.
* @param first2 Start of range 2. * @param __first2 Start of range 2.
* @param init Starting value to add other values to. * @param __init Starting value to add other values to.
* @return The final inner product. * @return The final inner product.
*/ */
template<typename _InputIterator1, typename _InputIterator2, typename _Tp> template<typename _InputIterator1, typename _InputIterator2, typename _Tp>
@ -193,12 +193,12 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
* the accumulated value using @a binary_op1. The values in the ranges are * the accumulated value using @a binary_op1. The values in the ranges are
* processed in order. * processed in order.
* *
* @param first1 Start of range 1. * @param __first1 Start of range 1.
* @param last1 End of range 1. * @param __last1 End of range 1.
* @param first2 Start of range 2. * @param __first2 Start of range 2.
* @param init Starting value to add other values to. * @param __init Starting value to add other values to.
* @param binary_op1 Function object to accumulate with. * @param __binary_op1 Function object to accumulate with.
* @param binary_op2 Function object to apply to pairs of input values. * @param __binary_op2 Function object to apply to pairs of input values.
* @return The final inner product. * @return The final inner product.
*/ */
template<typename _InputIterator1, typename _InputIterator2, typename _Tp, template<typename _InputIterator1, typename _InputIterator2, typename _Tp,
@ -228,9 +228,9 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
* first value of the input, the second value in result is the sum of the * first value of the input, the second value in result is the sum of the
* first and second input values, and so on. * first and second input values, and so on.
* *
* @param first Start of input range. * @param __first Start of input range.
* @param last End of input range. * @param __last End of input range.
* @param result Output to write sums to. * @param __result Output to write sums to.
* @return Iterator pointing just beyond the values written to result. * @return Iterator pointing just beyond the values written to result.
*/ */
template<typename _InputIterator, typename _OutputIterator> template<typename _InputIterator, typename _OutputIterator>
@ -267,9 +267,9 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
* first value of the input, the second value in result is the sum of the * first value of the input, the second value in result is the sum of the
* first and second input values, and so on. * first and second input values, and so on.
* *
* @param first Start of input range. * @param __first Start of input range.
* @param last End of input range. * @param __last End of input range.
* @param result Output to write sums to. * @param __result Output to write sums to.
* @return Iterator pointing just beyond the values written to result. * @return Iterator pointing just beyond the values written to result.
*/ */
template<typename _InputIterator, typename _OutputIterator, template<typename _InputIterator, typename _OutputIterator,
@ -304,9 +304,9 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
* Computes the difference between adjacent values in the range * Computes the difference between adjacent values in the range
* [first,last) using operator-() and writes the result to @a result. * [first,last) using operator-() and writes the result to @a result.
* *
* @param first Start of input range. * @param __first Start of input range.
* @param last End of input range. * @param __last End of input range.
* @param result Output to write sums to. * @param __result Output to write sums to.
* @return Iterator pointing just beyond the values written to result. * @return Iterator pointing just beyond the values written to result.
* *
* _GLIBCXX_RESOLVE_LIB_DEFECTS * _GLIBCXX_RESOLVE_LIB_DEFECTS
@ -342,12 +342,12 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO
* @brief Return differences between adjacent values. * @brief Return differences between adjacent values.
* *
* Computes the difference between adjacent values in the range * Computes the difference between adjacent values in the range
* [first,last) using the function object @a binary_op and writes the * [__first,__last) using the function object @a __binary_op and writes the
* result to @a result. * result to @a __result.
* *
* @param first Start of input range. * @param __first Start of input range.
* @param last End of input range. * @param __last End of input range.
* @param result Output to write sums to. * @param __result Output to write sums to.
* @return Iterator pointing just beyond the values written to result. * @return Iterator pointing just beyond the values written to result.
* *
* _GLIBCXX_RESOLVE_LIB_DEFECTS * _GLIBCXX_RESOLVE_LIB_DEFECTS

4
libstdc++-v3/include/bits/stl_pair.h
View File

@ -262,8 +262,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief A convenience wrapper for creating a pair from two objects. * @brief A convenience wrapper for creating a pair from two objects.
* @param x The first object. * @param __x The first object.
* @param y The second object. * @param __y The second object.
* @return A newly-constructed pair<> object of the appropriate type. * @return A newly-constructed pair<> object of the appropriate type.
* *
* The standard requires that the objects be passed by reference-to-const, * The standard requires that the objects be passed by reference-to-const,

28
libstdc++-v3/include/bits/stl_queue.h
View File

@ -200,7 +200,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Add data to the end of the %queue. * @brief Add data to the end of the %queue.
* @param x Data to be added. * @param __x Data to be added.
* *
* This is a typical %queue operation. The function creates an * This is a typical %queue operation. The function creates an
* element at the end of the %queue and assigns the given data * element at the end of the %queue and assigns the given data
@ -253,8 +253,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Queue equality comparison. * @brief Queue equality comparison.
* @param x A %queue. * @param __x A %queue.
* @param y A %queue of the same type as @a x. * @param __y A %queue of the same type as @a __x.
* @return True iff the size and elements of the queues are equal. * @return True iff the size and elements of the queues are equal.
* *
* This is an equivalence relation. Complexity and semantics depend on the * This is an equivalence relation. Complexity and semantics depend on the
@ -269,9 +269,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Queue ordering relation. * @brief Queue ordering relation.
* @param x A %queue. * @param __x A %queue.
* @param y A %queue of the same type as @a x. * @param __y A %queue of the same type as @a x.
* @return True iff @a x is lexicographically less than @a y. * @return True iff @a __x is lexicographically less than @a __y.
* *
* This is an total ordering relation. Complexity and semantics * This is an total ordering relation. Complexity and semantics
* depend on the underlying sequence type, but the expected rules * depend on the underlying sequence type, but the expected rules
@ -407,14 +407,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Builds a %queue from a range. * @brief Builds a %queue from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param x A comparison functor describing a strict weak ordering. * @param __x A comparison functor describing a strict weak ordering.
* @param s An initial sequence with which to start. * @param __s An initial sequence with which to start.
* *
* Begins by copying @a s, inserting a copy of the elements * Begins by copying @a __s, inserting a copy of the elements
* from @a [first,last) into the copy of @a s, then ordering * from @a [first,last) into the copy of @a __s, then ordering
* the copy according to @a x. * the copy according to @a __x.
* *
* For more information on function objects, see the * For more information on function objects, see the
* documentation on @link functors functor base * documentation on @link functors functor base
@ -480,7 +480,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Add data to the %queue. * @brief Add data to the %queue.
* @param x Data to be added. * @param __x Data to be added.
* *
* This is a typical %queue operation. * This is a typical %queue operation.
* The time complexity of the operation depends on the underlying * The time complexity of the operation depends on the underlying

24
libstdc++-v3/include/bits/stl_relops.h
View File

@ -77,9 +77,9 @@ namespace std _GLIBCXX_VISIBILITY(default)
/** /**
* @brief Defines @c != for arbitrary types, in terms of @c ==. * @brief Defines @c != for arbitrary types, in terms of @c ==.
* @param x A thing. * @param __x A thing.
* @param y Another thing. * @param __y Another thing.
* @return x != y * @return __x != __y
* *
* This function uses @c == to determine its result. * This function uses @c == to determine its result.
*/ */
@ -90,9 +90,9 @@ namespace std _GLIBCXX_VISIBILITY(default)
/** /**
* @brief Defines @c > for arbitrary types, in terms of @c <. * @brief Defines @c > for arbitrary types, in terms of @c <.
* @param x A thing. * @param __x A thing.
* @param y Another thing. * @param __y Another thing.
* @return x > y * @return __x > __y
* *
* This function uses @c < to determine its result. * This function uses @c < to determine its result.
*/ */
@ -103,9 +103,9 @@ namespace std _GLIBCXX_VISIBILITY(default)
/** /**
* @brief Defines @c <= for arbitrary types, in terms of @c <. * @brief Defines @c <= for arbitrary types, in terms of @c <.
* @param x A thing. * @param __x A thing.
* @param y Another thing. * @param __y Another thing.
* @return x <= y * @return __x <= __y
* *
* This function uses @c < to determine its result. * This function uses @c < to determine its result.
*/ */
@ -116,9 +116,9 @@ namespace std _GLIBCXX_VISIBILITY(default)
/** /**
* @brief Defines @c >= for arbitrary types, in terms of @c <. * @brief Defines @c >= for arbitrary types, in terms of @c <.
* @param x A thing. * @param __x A thing.
* @param y Another thing. * @param __y Another thing.
* @return x >= y * @return __x >= __y
* *
* This function uses @c < to determine its result. * This function uses @c < to determine its result.
*/ */

141
libstdc++-v3/include/bits/stl_set.h
View File

@ -76,9 +76,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
* *
* Sets support bidirectional iterators. * Sets support bidirectional iterators.
* *
* @param Key Type of key objects. * @tparam _Key Type of key objects.
* @param Compare Comparison function object type, defaults to less<Key>. * @tparam _Compare Comparison function object type, defaults to less<Key>.
* @param Alloc Allocator type, defaults to allocator<Key>. * @tparam _Alloc Allocator type, defaults to allocator<Key>.
* *
* The private tree data is declared exactly the same way for set and * The private tree data is declared exactly the same way for set and
* multiset; the distinction is made entirely in how the tree functions are * multiset; the distinction is made entirely in how the tree functions are
@ -140,8 +140,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %set with no elements. * @brief Creates a %set with no elements.
* @param comp Comparator to use. * @param __comp Comparator to use.
* @param a An allocator object. * @param __a An allocator object.
*/ */
explicit explicit
set(const _Compare& __comp, set(const _Compare& __comp,
@ -150,12 +150,13 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %set from a range. * @brief Builds a %set from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* Create a %set consisting of copies of the elements from [first,last). * Create a %set consisting of copies of the elements from
* This is linear in N if the range is already sorted, and NlogN * [__first,__last). This is linear in N if the range is
* otherwise (where N is distance(first,last)). * already sorted, and NlogN otherwise (where N is
* distance(__first,__last)).
*/ */
template<typename _InputIterator> template<typename _InputIterator>
set(_InputIterator __first, _InputIterator __last) set(_InputIterator __first, _InputIterator __last)
@ -164,14 +165,15 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %set from a range. * @brief Builds a %set from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param comp A comparison functor. * @param __comp A comparison functor.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %set consisting of copies of the elements from [first,last). * Create a %set consisting of copies of the elements from
* This is linear in N if the range is already sorted, and NlogN * [__first,__last). This is linear in N if the range is
* otherwise (where N is distance(first,last)). * already sorted, and NlogN otherwise (where N is
* distance(__first,__last)).
*/ */
template<typename _InputIterator> template<typename _InputIterator>
set(_InputIterator __first, _InputIterator __last, set(_InputIterator __first, _InputIterator __last,
@ -182,10 +184,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Set copy constructor. * @brief %Set copy constructor.
* @param x A %set of identical element and allocator types. * @param __x A %set of identical element and allocator types.
* *
* The newly-created %set uses a copy of the allocation object used * The newly-created %set uses a copy of the allocation object used
* by @a x. * by @a __x.
*/ */
set(const set& __x) set(const set& __x)
: _M_t(__x._M_t) { } : _M_t(__x._M_t) { }
@ -193,7 +195,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Set move constructor * @brief %Set move constructor
* @param x A %set of identical element and allocator types. * @param __x A %set of identical element and allocator types.
* *
* The newly-created %set contains the exact contents of @a x. * The newly-created %set contains the exact contents of @a x.
* The contents of @a x are a valid, but unspecified %set. * The contents of @a x are a valid, but unspecified %set.
@ -204,13 +206,13 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %set from an initializer_list. * @brief Builds a %set from an initializer_list.
* @param l An initializer_list. * @param __l An initializer_list.
* @param comp A comparison functor. * @param __comp A comparison functor.
* @param a An allocator object. * @param __a An allocator object.
* *
* Create a %set consisting of copies of the elements in the list. * Create a %set consisting of copies of the elements in the list.
* This is linear in N if the list is already sorted, and NlogN * This is linear in N if the list is already sorted, and NlogN
* otherwise (where N is @a l.size()). * otherwise (where N is @a __l.size()).
*/ */
set(initializer_list<value_type> __l, set(initializer_list<value_type> __l,
const _Compare& __comp = _Compare(), const _Compare& __comp = _Compare(),
@ -221,10 +223,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Set assignment operator. * @brief %Set assignment operator.
* @param x A %set of identical element and allocator types. * @param __x A %set of identical element and allocator types.
* *
* All the elements of @a x are copied, but unlike the copy constructor, * All the elements of @a __x are copied, but unlike the copy
* the allocator object is not copied. * constructor, the allocator object is not copied.
*/ */
set& set&
operator=(const set& __x) operator=(const set& __x)
@ -236,10 +238,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Set move assignment operator. * @brief %Set move assignment operator.
* @param x A %set of identical element and allocator types. * @param __x A %set of identical element and allocator types.
* *
* The contents of @a x are moved into this %set (without copying). * The contents of @a __x are moved into this %set (without copying).
* @a x is a valid, but unspecified %set. * @a __x is a valid, but unspecified %set.
*/ */
set& set&
operator=(set&& __x) operator=(set&& __x)
@ -253,10 +255,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Set list assignment operator. * @brief %Set list assignment operator.
* @param l An initializer_list. * @param __l An initializer_list.
* *
* This function fills a %set with copies of the elements in the * This function fills a %set with copies of the elements in the
* initializer list @a l. * initializer list @a __l.
* *
* Note that the assignment completely changes the %set and * Note that the assignment completely changes the %set and
* that the resulting %set's size is the same as the number * that the resulting %set's size is the same as the number
@ -377,14 +379,14 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Swaps data with another %set. * @brief Swaps data with another %set.
* @param x A %set of the same element and allocator types. * @param __x A %set of the same element and allocator types.
* *
* This exchanges the elements between two sets in constant time. * This exchanges the elements between two sets in constant
* (It is only swapping a pointer, an integer, and an instance of * time. (It is only swapping a pointer, an integer, and an
* the @c Compare type (which itself is often stateless and empty), so it * instance of the @c Compare type (which itself is often
* should be quite fast.) * stateless and empty), so it should be quite fast.) Note
* Note that the global std::swap() function is specialized such that * that the global std::swap() function is specialized such
* std::swap(s1,s2) will feed to this function. * that std::swap(s1,s2) will feed to this function.
*/ */
void void
swap(set& __x) swap(set& __x)
@ -393,7 +395,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// insert/erase // insert/erase
/** /**
* @brief Attempts to insert an element into the %set. * @brief Attempts to insert an element into the %set.
* @param x Element to be inserted. * @param __x Element to be inserted.
* @return A pair, of which the first element is an iterator that points * @return A pair, of which the first element is an iterator that points
* to the possibly inserted element, and the second is a bool * to the possibly inserted element, and the second is a bool
* that is true if the element was actually inserted. * that is true if the element was actually inserted.
@ -424,11 +426,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Attempts to insert an element into the %set. * @brief Attempts to insert an element into the %set.
* @param position An iterator that serves as a hint as to where the * @param __position An iterator that serves as a hint as to where the
* element should be inserted. * element should be inserted.
* @param x Element to be inserted. * @param __x Element to be inserted.
* @return An iterator that points to the element with key of @a x (may * @return An iterator that points to the element with key of
* or may not be the element passed in). * @a __x (may or may not be the element passed in).
* *
* This function is not concerned about whether the insertion took place, * This function is not concerned about whether the insertion took place,
* and thus does not return a boolean like the single-argument insert() * and thus does not return a boolean like the single-argument insert()
@ -454,9 +456,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief A template function that attempts to insert a range * @brief A template function that attempts to insert a range
* of elements. * of elements.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* inserted. * inserted.
* @param last Iterator pointing to the end of the range. * @param __last Iterator pointing to the end of the range.
* *
* Complexity similar to that of the range constructor. * Complexity similar to that of the range constructor.
*/ */
@ -468,8 +470,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Attempts to insert a list of elements into the %set. * @brief Attempts to insert a list of elements into the %set.
* @param list A std::initializer_list<value_type> of elements * @param __l A std::initializer_list<value_type> of elements
* to be inserted. * to be inserted.
* *
* Complexity similar to that of the range constructor. * Complexity similar to that of the range constructor.
*/ */
@ -483,9 +485,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// DR 130. Associative erase should return an iterator. // DR 130. Associative erase should return an iterator.
/** /**
* @brief Erases an element from a %set. * @brief Erases an element from a %set.
* @param position An iterator pointing to the element to be erased. * @param __position An iterator pointing to the element to be erased.
* @return An iterator pointing to the element immediately following * @return An iterator pointing to the element immediately following
* @a position prior to the element being erased. If no such * @a __position prior to the element being erased. If no such
* element exists, end() is returned. * element exists, end() is returned.
* *
* This function erases an element, pointed to by the given iterator, * This function erases an element, pointed to by the given iterator,
@ -515,7 +517,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Erases elements according to the provided key. * @brief Erases elements according to the provided key.
* @param x Key of element to be erased. * @param __x Key of element to be erased.
* @return The number of elements erased. * @return The number of elements erased.
* *
* This function erases all the elements located by the given key from * This function erases all the elements located by the given key from
@ -532,11 +534,13 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// _GLIBCXX_RESOLVE_LIB_DEFECTS // _GLIBCXX_RESOLVE_LIB_DEFECTS
// DR 130. Associative erase should return an iterator. // DR 130. Associative erase should return an iterator.
/** /**
* @brief Erases a [first,last) range of elements from a %set. * @brief Erases a [__first,__last) range of elements from a %set.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* erased. * erased.
* @param last Iterator pointing to the end of the range to be erased.
* @return The iterator @a last. * @param __last Iterator pointing to the end of the range to
* be erased.
* @return The iterator @a __last.
* *
* This function erases a sequence of elements from a %set. * This function erases a sequence of elements from a %set.
* Note that this function only erases the element, and that if * Note that this function only erases the element, and that if
@ -549,9 +553,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
/** /**
* @brief Erases a [first,last) range of elements from a %set. * @brief Erases a [first,last) range of elements from a %set.
* @param first Iterator pointing to the start of the range to be * @param __first Iterator pointing to the start of the range to be
* erased. * erased.
* @param last Iterator pointing to the end of the range to be erased. * @param __last Iterator pointing to the end of the range to
* be erased.
* *
* This function erases a sequence of elements from a %set. * This function erases a sequence of elements from a %set.
* Note that this function only erases the element, and that if * Note that this function only erases the element, and that if
@ -577,7 +582,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the number of elements. * @brief Finds the number of elements.
* @param x Element to located. * @param __x Element to located.
* @return Number of elements with specified key. * @return Number of elements with specified key.
* *
* This function only makes sense for multisets; for set the result will * This function only makes sense for multisets; for set the result will
@ -592,7 +597,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Tries to locate an element in a %set. * @brief Tries to locate an element in a %set.
* @param x Element to be located. * @param __x Element to be located.
* @return Iterator pointing to sought-after element, or end() if not * @return Iterator pointing to sought-after element, or end() if not
* found. * found.
* *
@ -613,7 +618,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Finds the beginning of a subsequence matching given key. * @brief Finds the beginning of a subsequence matching given key.
* @param x Key to be located. * @param __x Key to be located.
* @return Iterator pointing to first element equal to or greater * @return Iterator pointing to first element equal to or greater
* than key, or end(). * than key, or end().
* *
@ -634,7 +639,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Finds the end of a subsequence matching given key. * @brief Finds the end of a subsequence matching given key.
* @param x Key to be located. * @param __x Key to be located.
* @return Iterator pointing to the first element * @return Iterator pointing to the first element
* greater than key, or end(). * greater than key, or end().
*/ */
@ -650,7 +655,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Finds a subsequence matching given key. * @brief Finds a subsequence matching given key.
* @param x Key to be located. * @param __x Key to be located.
* @return Pair of iterators that possibly points to the subsequence * @return Pair of iterators that possibly points to the subsequence
* matching given key. * matching given key.
* *
@ -684,8 +689,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Set equality comparison. * @brief Set equality comparison.
* @param x A %set. * @param __x A %set.
* @param y A %set of the same type as @a x. * @param __y A %set of the same type as @a x.
* @return True iff the size and elements of the sets are equal. * @return True iff the size and elements of the sets are equal.
* *
* This is an equivalence relation. It is linear in the size of the sets. * This is an equivalence relation. It is linear in the size of the sets.
@ -700,9 +705,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Set ordering relation. * @brief Set ordering relation.
* @param x A %set. * @param __x A %set.
* @param y A %set of the same type as @a x. * @param __y A %set of the same type as @a x.
* @return True iff @a x is lexicographically less than @a y. * @return True iff @a __x is lexicographically less than @a __y.
* *
* This is a total ordering relation. It is linear in the size of the * This is a total ordering relation. It is linear in the size of the
* maps. The elements must be comparable with @c <. * maps. The elements must be comparable with @c <.

12
libstdc++-v3/include/bits/stl_stack.h
View File

@ -174,7 +174,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Add data to the top of the %stack. * @brief Add data to the top of the %stack.
* @param x Data to be added. * @param __x Data to be added.
* *
* This is a typical %stack operation. The function creates an * This is a typical %stack operation. The function creates an
* element at the top of the %stack and assigns the given data * element at the top of the %stack and assigns the given data
@ -227,8 +227,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Stack equality comparison. * @brief Stack equality comparison.
* @param x A %stack. * @param __x A %stack.
* @param y A %stack of the same type as @a x. * @param __y A %stack of the same type as @a __x.
* @return True iff the size and elements of the stacks are equal. * @return True iff the size and elements of the stacks are equal.
* *
* This is an equivalence relation. Complexity and semantics * This is an equivalence relation. Complexity and semantics
@ -244,9 +244,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Stack ordering relation. * @brief Stack ordering relation.
* @param x A %stack. * @param __x A %stack.
* @param y A %stack of the same type as @a x. * @param __y A %stack of the same type as @a x.
* @return True iff @a x is lexicographically less than @a y. * @return True iff @a x is lexicographically less than @a __y.
* *
* This is an total ordering relation. Complexity and semantics * This is an total ordering relation. Complexity and semantics
* depend on the underlying sequence type, but the expected rules * depend on the underlying sequence type, but the expected rules

10
libstdc++-v3/include/bits/stl_tempbuf.h
View File

@ -67,15 +67,15 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Allocates a temporary buffer. * @brief Allocates a temporary buffer.
* @param len The number of objects of type Tp. * @param __len The number of objects of type Tp.
* @return See full description. * @return See full description.
* *
* Reinventing the wheel, but this time with prettier spokes! * Reinventing the wheel, but this time with prettier spokes!
* *
* This function tries to obtain storage for @c len adjacent Tp * This function tries to obtain storage for @c __len adjacent Tp
* objects. The objects themselves are not constructed, of course. * objects. The objects themselves are not constructed, of course.
* A pair<> is returned containing <em>the buffer s address and * A pair<> is returned containing <em>the buffer s address and
* capacity (in the units of sizeof(Tp)), or a pair of 0 values if * capacity (in the units of sizeof(_Tp)), or a pair of 0 values if
* no storage can be obtained.</em> Note that the capacity obtained * no storage can be obtained.</em> Note that the capacity obtained
* may be less than that requested if the memory is unavailable; * may be less than that requested if the memory is unavailable;
* you should compare len with the .second return value. * you should compare len with the .second return value.
@ -104,10 +104,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief The companion to get_temporary_buffer(). * @brief The companion to get_temporary_buffer().
* @param p A buffer previously allocated by get_temporary_buffer. * @param __p A buffer previously allocated by get_temporary_buffer.
* @return None. * @return None.
* *
* Frees the memory pointed to by p. * Frees the memory pointed to by __p.
*/ */
template<typename _Tp> template<typename _Tp>
inline void inline void

28
libstdc++-v3/include/bits/stl_uninitialized.h
View File

@ -97,10 +97,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Copies the range [first,last) into result. * @brief Copies the range [first,last) into result.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param result An output iterator. * @param __result An output iterator.
* @return result + (first - last) * @return __result + (__first - __last)
* *
* Like copy(), but does not require an initialized output range. * Like copy(), but does not require an initialized output range.
*/ */
@ -154,9 +154,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Copies the value x into the range [first,last). * @brief Copies the value x into the range [first,last).
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param x The source value. * @param __x The source value.
* @return Nothing. * @return Nothing.
* *
* Like fill(), but does not require an initialized output range. * Like fill(), but does not require an initialized output range.
@ -208,9 +208,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Copies the value x into the range [first,first+n). * @brief Copies the value x into the range [first,first+n).
* @param first An input iterator. * @param __first An input iterator.
* @param n The number of copies to make. * @param __n The number of copies to make.
* @param x The source value. * @param __x The source value.
* @return Nothing. * @return Nothing.
* *
* Like fill_n(), but does not require an initialized output range. * Like fill_n(), but does not require an initialized output range.
@ -637,10 +637,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Copies the range [first,first+n) into result. * @brief Copies the range [first,first+n) into result.
* @param first An input iterator. * @param __first An input iterator.
* @param n The number of elements to copy. * @param __n The number of elements to copy.
* @param result An output iterator. * @param __result An output iterator.
* @return result + n * @return __result + __n
* *
* Like copy_n(), but does not require an initialized output range. * Like copy_n(), but does not require an initialized output range.
*/ */

162
libstdc++-v3/include/bits/stl_vector.h
View File

@ -245,7 +245,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %vector with no elements. * @brief Creates a %vector with no elements.
* @param a An allocator object. * @param __a An allocator object.
*/ */
explicit explicit
vector(const allocator_type& __a) vector(const allocator_type& __a)
@ -254,9 +254,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Creates a %vector with default constructed elements. * @brief Creates a %vector with default constructed elements.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* *
* This constructor fills the %vector with @a n default * This constructor fills the %vector with @a __n default
* constructed elements. * constructed elements.
*/ */
explicit explicit
@ -266,11 +266,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Creates a %vector with copies of an exemplar element. * @brief Creates a %vector with copies of an exemplar element.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* @param value An element to copy. * @param __value An element to copy.
* @param a An allocator. * @param __a An allocator.
* *
* This constructor fills the %vector with @a n copies of @a value. * This constructor fills the %vector with @a __n copies of @a __value.
*/ */
vector(size_type __n, const value_type& __value, vector(size_type __n, const value_type& __value,
const allocator_type& __a = allocator_type()) const allocator_type& __a = allocator_type())
@ -279,11 +279,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
/** /**
* @brief Creates a %vector with copies of an exemplar element. * @brief Creates a %vector with copies of an exemplar element.
* @param n The number of elements to initially create. * @param __n The number of elements to initially create.
* @param value An element to copy. * @param __value An element to copy.
* @param a An allocator. * @param __a An allocator.
* *
* This constructor fills the %vector with @a n copies of @a value. * This constructor fills the %vector with @a __n copies of @a __value.
*/ */
explicit explicit
vector(size_type __n, const value_type& __value = value_type(), vector(size_type __n, const value_type& __value = value_type(),
@ -294,12 +294,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Vector copy constructor. * @brief %Vector copy constructor.
* @param x A %vector of identical element and allocator types. * @param __x A %vector of identical element and allocator types.
* *
* The newly-created %vector uses a copy of the allocation * The newly-created %vector uses a copy of the allocation
* object used by @a x. All the elements of @a x are copied, * object used by @a __x. All the elements of @a __x are copied,
* but any extra memory in * but any extra memory in
* @a x (for fast expansion) will not be copied. * @a __x (for fast expansion) will not be copied.
*/ */
vector(const vector& __x) vector(const vector& __x)
: _Base(__x.size(), : _Base(__x.size(),
@ -313,10 +313,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Vector move constructor. * @brief %Vector move constructor.
* @param x A %vector of identical element and allocator types. * @param __x A %vector of identical element and allocator types.
* *
* The newly-created %vector contains the exact contents of @a x. * The newly-created %vector contains the exact contents of @a __x.
* The contents of @a x are a valid, but unspecified %vector. * The contents of @a __x are a valid, but unspecified %vector.
*/ */
vector(vector&& __x) noexcept vector(vector&& __x) noexcept
: _Base(std::move(__x)) { } : _Base(std::move(__x)) { }
@ -346,14 +346,14 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %vector from an initializer list. * @brief Builds a %vector from an initializer list.
* @param l An initializer_list. * @param __l An initializer_list.
* @param a An allocator. * @param __a An allocator.
* *
* Create a %vector consisting of copies of the elements in the * Create a %vector consisting of copies of the elements in the
* initializer_list @a l. * initializer_list @a __l.
* *
* This will call the element type's copy constructor N times * This will call the element type's copy constructor N times
* (where N is @a l.size()) and do no memory reallocation. * (where N is @a __l.size()) and do no memory reallocation.
*/ */
vector(initializer_list<value_type> __l, vector(initializer_list<value_type> __l,
const allocator_type& __a = allocator_type()) const allocator_type& __a = allocator_type())
@ -366,9 +366,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Builds a %vector from a range. * @brief Builds a %vector from a range.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* @param a An allocator. * @param __a An allocator.
* *
* Create a %vector consisting of copies of the elements from * Create a %vector consisting of copies of the elements from
* [first,last). * [first,last).
@ -402,10 +402,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Vector assignment operator. * @brief %Vector assignment operator.
* @param x A %vector of identical element and allocator types. * @param __x A %vector of identical element and allocator types.
* *
* All the elements of @a x are copied, but any extra memory in * All the elements of @a __x are copied, but any extra memory in
* @a x (for fast expansion) will not be copied. Unlike the * @a __x (for fast expansion) will not be copied. Unlike the
* copy constructor, the allocator object is not copied. * copy constructor, the allocator object is not copied.
*/ */
vector& vector&
@ -414,10 +414,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief %Vector move assignment operator. * @brief %Vector move assignment operator.
* @param x A %vector of identical element and allocator types. * @param __x A %vector of identical element and allocator types.
* *
* The contents of @a x are moved into this %vector (without copying). * The contents of @a __x are moved into this %vector (without copying).
* @a x is a valid, but unspecified %vector. * @a __x is a valid, but unspecified %vector.
*/ */
vector& vector&
operator=(vector&& __x) noexcept(_Alloc_traits::_S_nothrow_move()) operator=(vector&& __x) noexcept(_Alloc_traits::_S_nothrow_move())
@ -451,10 +451,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief %Vector list assignment operator. * @brief %Vector list assignment operator.
* @param l An initializer_list. * @param __l An initializer_list.
* *
* This function fills a %vector with copies of the elements in the * This function fills a %vector with copies of the elements in the
* initializer list @a l. * initializer list @a __l.
* *
* Note that the assignment completely changes the %vector and * Note that the assignment completely changes the %vector and
* that the resulting %vector's size is the same as the number * that the resulting %vector's size is the same as the number
@ -470,10 +470,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Assigns a given value to a %vector. * @brief Assigns a given value to a %vector.
* @param n Number of elements to be assigned. * @param __n Number of elements to be assigned.
* @param val Value to be assigned. * @param __val Value to be assigned.
* *
* This function fills a %vector with @a n copies of the given * This function fills a %vector with @a __n copies of the given
* value. Note that the assignment completely changes the * value. Note that the assignment completely changes the
* %vector and that the resulting %vector's size is the same as * %vector and that the resulting %vector's size is the same as
* the number of elements assigned. Old data may be lost. * the number of elements assigned. Old data may be lost.
@ -484,11 +484,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Assigns a range to a %vector. * @brief Assigns a range to a %vector.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* This function fills a %vector with copies of the elements in the * This function fills a %vector with copies of the elements in the
* range [first,last). * range [__first,__last).
* *
* Note that the assignment completely changes the %vector and * Note that the assignment completely changes the %vector and
* that the resulting %vector's size is the same as the number * that the resulting %vector's size is the same as the number
@ -506,10 +506,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Assigns an initializer list to a %vector. * @brief Assigns an initializer list to a %vector.
* @param l An initializer_list. * @param __l An initializer_list.
* *
* This function fills a %vector with copies of the elements in the * This function fills a %vector with copies of the elements in the
* initializer list @a l. * initializer list @a __l.
* *
* Note that the assignment completely changes the %vector and * Note that the assignment completely changes the %vector and
* that the resulting %vector's size is the same as the number * that the resulting %vector's size is the same as the number
@ -648,7 +648,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Resizes the %vector to the specified number of elements. * @brief Resizes the %vector to the specified number of elements.
* @param new_size Number of elements the %vector should contain. * @param __new_size Number of elements the %vector should contain.
* *
* This function will %resize the %vector to the specified * This function will %resize the %vector to the specified
* number of elements. If the number is smaller than the * number of elements. If the number is smaller than the
@ -666,8 +666,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Resizes the %vector to the specified number of elements. * @brief Resizes the %vector to the specified number of elements.
* @param new_size Number of elements the %vector should contain. * @param __new_size Number of elements the %vector should contain.
* @param x Data with which new elements should be populated. * @param __x Data with which new elements should be populated.
* *
* This function will %resize the %vector to the specified * This function will %resize the %vector to the specified
* number of elements. If the number is smaller than the * number of elements. If the number is smaller than the
@ -686,8 +686,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#else #else
/** /**
* @brief Resizes the %vector to the specified number of elements. * @brief Resizes the %vector to the specified number of elements.
* @param new_size Number of elements the %vector should contain. * @param __new_size Number of elements the %vector should contain.
* @param x Data with which new elements should be populated. * @param __x Data with which new elements should be populated.
* *
* This function will %resize the %vector to the specified * This function will %resize the %vector to the specified
* number of elements. If the number is smaller than the * number of elements. If the number is smaller than the
@ -732,7 +732,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Attempt to preallocate enough memory for specified number of * @brief Attempt to preallocate enough memory for specified number of
* elements. * elements.
* @param n Number of elements required. * @param __n Number of elements required.
* @throw std::length_error If @a n exceeds @c max_size(). * @throw std::length_error If @a n exceeds @c max_size().
* *
* This function attempts to reserve enough memory for the * This function attempts to reserve enough memory for the
@ -752,7 +752,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// element access // element access
/** /**
* @brief Subscript access to the data contained in the %vector. * @brief Subscript access to the data contained in the %vector.
* @param n The index of the element for which data should be * @param __n The index of the element for which data should be
* accessed. * accessed.
* @return Read/write reference to data. * @return Read/write reference to data.
* *
@ -767,7 +767,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Subscript access to the data contained in the %vector. * @brief Subscript access to the data contained in the %vector.
* @param n The index of the element for which data should be * @param __n The index of the element for which data should be
* accessed. * accessed.
* @return Read-only (constant) reference to data. * @return Read-only (constant) reference to data.
* *
@ -792,10 +792,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
public: public:
/** /**
* @brief Provides access to the data contained in the %vector. * @brief Provides access to the data contained in the %vector.
* @param n The index of the element for which data should be * @param __n The index of the element for which data should be
* accessed. * accessed.
* @return Read/write reference to data. * @return Read/write reference to data.
* @throw std::out_of_range If @a n is an invalid index. * @throw std::out_of_range If @a __n is an invalid index.
* *
* This function provides for safer data access. The parameter * This function provides for safer data access. The parameter
* is first checked that it is in the range of the vector. The * is first checked that it is in the range of the vector. The
@ -810,10 +810,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Provides access to the data contained in the %vector. * @brief Provides access to the data contained in the %vector.
* @param n The index of the element for which data should be * @param __n The index of the element for which data should be
* accessed. * accessed.
* @return Read-only (constant) reference to data. * @return Read-only (constant) reference to data.
* @throw std::out_of_range If @a n is an invalid index. * @throw std::out_of_range If @a __n is an invalid index.
* *
* This function provides for safer data access. The parameter * This function provides for safer data access. The parameter
* is first checked that it is in the range of the vector. The * is first checked that it is in the range of the vector. The
@ -884,7 +884,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
// [23.2.4.3] modifiers // [23.2.4.3] modifiers
/** /**
* @brief Add data to the end of the %vector. * @brief Add data to the end of the %vector.
* @param x Data to be added. * @param __x Data to be added.
* *
* This is a typical stack operation. The function creates an * This is a typical stack operation. The function creates an
* element at the end of the %vector and assigns the given data * element at the end of the %vector and assigns the given data
@ -938,8 +938,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Inserts an object in %vector before specified iterator. * @brief Inserts an object in %vector before specified iterator.
* @param position An iterator into the %vector. * @param __position An iterator into the %vector.
* @param args Arguments. * @param __args Arguments.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert an object of type T constructed * This function will insert an object of type T constructed
@ -955,8 +955,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts given value into %vector before specified iterator. * @brief Inserts given value into %vector before specified iterator.
* @param position An iterator into the %vector. * @param __position An iterator into the %vector.
* @param x Data to be inserted. * @param __x Data to be inserted.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert a copy of the given value before * This function will insert a copy of the given value before
@ -970,8 +970,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Inserts given rvalue into %vector before specified iterator. * @brief Inserts given rvalue into %vector before specified iterator.
* @param position An iterator into the %vector. * @param __position An iterator into the %vector.
* @param x Data to be inserted. * @param __x Data to be inserted.
* @return An iterator that points to the inserted data. * @return An iterator that points to the inserted data.
* *
* This function will insert a copy of the given rvalue before * This function will insert a copy of the given rvalue before
@ -985,8 +985,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts an initializer_list into the %vector. * @brief Inserts an initializer_list into the %vector.
* @param position An iterator into the %vector. * @param __position An iterator into the %vector.
* @param l An initializer_list. * @param __l An initializer_list.
* *
* This function will insert copies of the data in the * This function will insert copies of the data in the
* initializer_list @a l into the %vector before the location * initializer_list @a l into the %vector before the location
@ -1003,9 +1003,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts a number of copies of given data into the %vector. * @brief Inserts a number of copies of given data into the %vector.
* @param position An iterator into the %vector. * @param __position An iterator into the %vector.
* @param n Number of elements to be inserted. * @param __n Number of elements to be inserted.
* @param x Data to be inserted. * @param __x Data to be inserted.
* *
* This function will insert a specified number of copies of * This function will insert a specified number of copies of
* the given data before the location specified by @a position. * the given data before the location specified by @a position.
@ -1020,12 +1020,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Inserts a range into the %vector. * @brief Inserts a range into the %vector.
* @param position An iterator into the %vector. * @param __position An iterator into the %vector.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __last An input iterator.
* *
* This function will insert copies of the data in the range * This function will insert copies of the data in the range
* [first,last) into the %vector before the location specified * [__first,__last) into the %vector before the location specified
* by @a pos. * by @a pos.
* *
* Note that this kind of operation could be expensive for a * Note that this kind of operation could be expensive for a
@ -1044,7 +1044,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove element at given position. * @brief Remove element at given position.
* @param position Iterator pointing to element to be erased. * @param __position Iterator pointing to element to be erased.
* @return An iterator pointing to the next element (or end()). * @return An iterator pointing to the next element (or end()).
* *
* This function will erase the element at the given position and thus * This function will erase the element at the given position and thus
@ -1062,14 +1062,14 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Remove a range of elements. * @brief Remove a range of elements.
* @param first Iterator pointing to the first element to be erased. * @param __first Iterator pointing to the first element to be erased.
* @param last Iterator pointing to one past the last element to be * @param __last Iterator pointing to one past the last element to be
* erased. * erased.
* @return An iterator pointing to the element pointed to by @a last * @return An iterator pointing to the element pointed to by @a __last
* prior to erasing (or end()). * prior to erasing (or end()).
* *
* This function will erase the elements in the range [first,last) and * This function will erase the elements in the range
* shorten the %vector accordingly. * [__first,__last) and shorten the %vector accordingly.
* *
* Note This operation could be expensive and if it is * Note This operation could be expensive and if it is
* frequently used the user should consider using std::list. * frequently used the user should consider using std::list.
@ -1083,7 +1083,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Swaps data with another %vector. * @brief Swaps data with another %vector.
* @param x A %vector of the same element and allocator types. * @param __x A %vector of the same element and allocator types.
* *
* This exchanges the elements between two vectors in constant time. * This exchanges the elements between two vectors in constant time.
* (Three pointers, so it should be quite fast.) * (Three pointers, so it should be quite fast.)
@ -1339,8 +1339,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Vector equality comparison. * @brief Vector equality comparison.
* @param x A %vector. * @param __x A %vector.
* @param y A %vector of the same type as @a x. * @param __y A %vector of the same type as @a __x.
* @return True iff the size and elements of the vectors are equal. * @return True iff the size and elements of the vectors are equal.
* *
* This is an equivalence relation. It is linear in the size of the * This is an equivalence relation. It is linear in the size of the
@ -1355,9 +1355,9 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Vector ordering relation. * @brief Vector ordering relation.
* @param x A %vector. * @param __x A %vector.
* @param y A %vector of the same type as @a x. * @param __y A %vector of the same type as @a __x.
* @return True iff @a x is lexicographically less than @a y. * @return True iff @a __x is lexicographically less than @a __y.
* *
* This is a total ordering relation. It is linear in the size of the * This is a total ordering relation. It is linear in the size of the
* vectors. The elements must be comparable with @c <. * vectors. The elements must be comparable with @c <.

10
libstdc++-v3/include/bits/stream_iterator.h
View File

@ -145,9 +145,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* the only type written by this iterator and there must be an * the only type written by this iterator and there must be an
* operator<<(Tp) defined. * operator<<(Tp) defined.
* *
* @param Tp The type to write to the ostream. * @tparam _Tp The type to write to the ostream.
* @param CharT The ostream char_type. * @tparam _CharT The ostream char_type.
* @param Traits The ostream char_traits. * @tparam _Traits The ostream char_traits.
*/ */
template<typename _Tp, typename _CharT = char, template<typename _Tp, typename _CharT = char,
typename _Traits = char_traits<_CharT> > typename _Traits = char_traits<_CharT> >
@ -177,8 +177,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* written to the stream. The delimiter is not copied, and thus must * written to the stream. The delimiter is not copied, and thus must
* not be destroyed while this iterator is in use. * not be destroyed while this iterator is in use.
* *
* @param s Underlying ostream to write to. * @param __s Underlying ostream to write to.
* @param c CharT delimiter string to insert. * @param __c CharT delimiter string to insert.
*/ */
ostream_iterator(ostream_type& __s, const _CharT* __c) ostream_iterator(ostream_type& __s, const _CharT* __c)
: _M_stream(&__s), _M_string(__c) { } : _M_stream(&__s), _M_string(__c) { }

2
libstdc++-v3/include/debug/safe_local_iterator.tcc
View File

@ -22,7 +22,7 @@
// see the files COPYING3 and COPYING.RUNTIME respectively. If not, see // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
// <http://www.gnu.org/licenses/>. // <http://www.gnu.org/licenses/>.
/** @file debug/safe_locale_iterator.tcc /** @file debug/safe_local_iterator.tcc
* This file is a GNU debug extension to the Standard C++ Library. * This file is a GNU debug extension to the Standard C++ Library.
*/ */

10
libstdc++-v3/include/debug/safe_sequence.h
View File

@ -104,7 +104,7 @@ namespace __gnu_debug
* may only be used by deriving from it and passing the name of the * may only be used by deriving from it and passing the name of the
* derived class as its template parameter via the curiously * derived class as its template parameter via the curiously
* recurring template pattern. The derived class must have @c * recurring template pattern. The derived class must have @c
* iterator and @const_iterator types that are instantiations of * iterator and @c const_iterator types that are instantiations of
* class template _Safe_iterator for this sequence. Iterators will * class template _Safe_iterator for this sequence. Iterators will
* then be tracked automatically. * then be tracked automatically.
*/ */
@ -113,16 +113,16 @@ namespace __gnu_debug
{ {
public: public:
/** Invalidates all iterators @c x that reference this sequence, /** Invalidates all iterators @c x that reference this sequence,
are not singular, and for which @c pred(x) returns @c are not singular, and for which @c __pred(x) returns @c
true. @c pred will be invoked with the normal iterators nested true. @c __pred will be invoked with the normal iterators nested
in the safe ones. */ in the safe ones. */
template<typename _Predicate> template<typename _Predicate>
void void
_M_invalidate_if(_Predicate __pred); _M_invalidate_if(_Predicate __pred);
/** Transfers all iterators @c x that reference @c from sequence, /** Transfers all iterators @c x that reference @c from sequence,
are not singular, and for which @c pred(x) returns @c are not singular, and for which @c __pred(x) returns @c
true. @c pred will be invoked with the normal iterators nested true. @c __pred will be invoked with the normal iterators nested
in the safe ones. */ in the safe ones. */
template<typename _Predicate> template<typename _Predicate>
void void

2
libstdc++-v3/include/debug/safe_unordered_base.h
View File

@ -55,7 +55,7 @@ namespace __gnu_debug
{ } { }
/** Initialize the iterator to reference the container pointed to /** Initialize the iterator to reference the container pointed to
* by @p__seq. @p __constant is true when we are initializing a * by @p __seq. @p __constant is true when we are initializing a
* constant local iterator, and false if it is a mutable local iterator. * constant local iterator, and false if it is a mutable local iterator.
* Note that @p __seq may be NULL, in which case the iterator will be * Note that @p __seq may be NULL, in which case the iterator will be
* singular. Otherwise, the iterator will reference @p __seq and * singular. Otherwise, the iterator will reference @p __seq and

12
libstdc++-v3/include/debug/safe_unordered_container.h
View File

@ -48,9 +48,9 @@ namespace __gnu_debug
* template may only be used by deriving from it and passing the name * template may only be used by deriving from it and passing the name
* of the derived class as its template parameter via the curiously * of the derived class as its template parameter via the curiously
* recurring template pattern. The derived class must have @c * recurring template pattern. The derived class must have @c
* iterator and @const_iterator types that are instantiations of * iterator and @c const_iterator types that are instantiations of
* class template _Safe_iterator for this container and @c local_iterator * class template _Safe_iterator for this container and @c local_iterator
* and @const_local_iterator types that are instantiations of class * and @c const_local_iterator types that are instantiations of class
* template _Safe_local_iterator for this container. Iterators will * template _Safe_local_iterator for this container. Iterators will
* then be tracked automatically. * then be tracked automatically.
*/ */
@ -59,16 +59,16 @@ namespace __gnu_debug
{ {
public: public:
/** Invalidates all iterators @c x that reference this container, /** Invalidates all iterators @c x that reference this container,
are not singular, and for which @c pred(x) returns @c are not singular, and for which @c __pred(x) returns @c
true. @c pred will be invoked with the normal iterators nested true. @c __pred will be invoked with the normal iterators nested
in the safe ones. */ in the safe ones. */
template<typename _Predicate> template<typename _Predicate>
void void
_M_invalidate_if(_Predicate __pred); _M_invalidate_if(_Predicate __pred);
/** Invalidates all local iterators @c x that reference this container, /** Invalidates all local iterators @c x that reference this container,
are not singular, and for which @c pred(x) returns @c are not singular, and for which @c __pred(x) returns @c
true. @c pred will be invoked with the normal ilocal iterators true. @c __pred will be invoked with the normal ilocal iterators
nested in the safe ones. */ nested in the safe ones. */
template<typename _Predicate> template<typename _Predicate>
void void

28
libstdc++-v3/include/ext/algorithm
View File

@ -105,9 +105,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Copies the range [first,first+count) into [result,result+count). * @brief Copies the range [first,first+count) into [result,result+count).
* @param first An input iterator. * @param __first An input iterator.
* @param count The number of elements to copy. * @param __count The number of elements to copy.
* @param result An output iterator. * @param __result An output iterator.
* @return A std::pair composed of first+count and result+count. * @return A std::pair composed of first+count and result+count.
* *
* This is an SGI extension. * This is an SGI extension.
@ -185,10 +185,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief @c memcmp on steroids. * @brief @c memcmp on steroids.
* @param first1 An input iterator. * @param __first1 An input iterator.
* @param last1 An input iterator. * @param __last1 An input iterator.
* @param first2 An input iterator. * @param __first2 An input iterator.
* @param last2 An input iterator. * @param __last2 An input iterator.
* @return An int, as with @c memcmp. * @return An int, as with @c memcmp.
* *
* The return value will be less than zero if the first range is * The return value will be less than zero if the first range is
@ -533,9 +533,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Find the median of three values. * @brief Find the median of three values.
* @param a A value. * @param __a A value.
* @param b A value. * @param __b A value.
* @param c A value. * @param __c A value.
* @return One of @p a, @p b or @p c. * @return One of @p a, @p b or @p c.
* *
* If @c {l,m,n} is some convolution of @p {a,b,c} such that @c l<=m<=n * If @c {l,m,n} is some convolution of @p {a,b,c} such that @c l<=m<=n
@ -566,10 +566,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Find the median of three values using a predicate for comparison. * @brief Find the median of three values using a predicate for comparison.
* @param a A value. * @param __a A value.
* @param b A value. * @param __b A value.
* @param c A value. * @param __c A value.
* @param comp A binary predicate. * @param __comp A binary predicate.
* @return One of @p a, @p b or @p c. * @return One of @p a, @p b or @p c.
* *
* If @c {l,m,n} is some convolution of @p {a,b,c} such that @p comp(l,m) * If @c {l,m,n} is some convolution of @p {a,b,c} such that @p comp(l,m)

9
libstdc++-v3/include/ext/bitmap_allocator.h
View File

@ -59,7 +59,6 @@ namespace __gnu_cxx _GLIBCXX_VISIBILITY(default)
* It is to be used only for built-in types or PODs. Notable * It is to be used only for built-in types or PODs. Notable
* differences are: * differences are:
* *
* @detail
* 1. Not all accessor functions are present. * 1. Not all accessor functions are present.
* 2. Used ONLY for PODs. * 2. Used ONLY for PODs.
* 3. No Allocator template argument. Uses ::operator new() to get * 3. No Allocator template argument. Uses ::operator new() to get
@ -560,7 +559,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* @param __addr The pointer to the memory block to be * @param __addr The pointer to the memory block to be
* validated. * validated.
* *
* @detail Validates the memory block passed to this function and * Validates the memory block passed to this function and
* appropriately performs the action of managing the free list of * appropriately performs the action of managing the free list of
* blocks by adding this block to the free list or deleting this * blocks by adding this block to the free list or deleting this
* or larger blocks from the free list. * or larger blocks from the free list.
@ -757,7 +756,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* @throw std::bad_alloc. If memory can not be allocated. * @throw std::bad_alloc. If memory can not be allocated.
* *
* @detail Complexity: O(1), but internally depends upon the * Complexity: O(1), but internally depends upon the
* complexity of the function free_list::_M_get. The part where * complexity of the function free_list::_M_get. The part where
* the bitmap headers are written has complexity: O(X),where X * the bitmap headers are written has complexity: O(X),where X
* is the number of blocks of size sizeof(value_type) within * is the number of blocks of size sizeof(value_type) within
@ -813,7 +812,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* @throw std::bad_alloc. If memory can not be allocated. * @throw std::bad_alloc. If memory can not be allocated.
* *
* @detail Complexity: Worst case complexity is O(N), but that * Complexity: Worst case complexity is O(N), but that
* is hardly ever hit. If and when this particular case is * is hardly ever hit. If and when this particular case is
* encountered, the next few cases are guaranteed to have a * encountered, the next few cases are guaranteed to have a
* worst case complexity of O(1)! That's why this function * worst case complexity of O(1)! That's why this function
@ -906,7 +905,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** @brief Deallocates memory that belongs to a single object of /** @brief Deallocates memory that belongs to a single object of
* size sizeof(_Tp). * size sizeof(_Tp).
* *
* @detail Complexity: O(lg(N)), but the worst case is not hit * Complexity: O(lg(N)), but the worst case is not hit
* often! This is because containers usually deallocate memory * often! This is because containers usually deallocate memory
* close to each other and this case is handled in O(1) time by * close to each other and this case is handled in O(1) time by
* the deallocate function. * the deallocate function.

2
libstdc++-v3/include/ext/functional
View File

@ -104,7 +104,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* @c binary_compose is constructed from three functors, @c f, @c g1, * @c binary_compose is constructed from three functors, @c f, @c g1,
* and @c g2. Its @c operator() returns @c f(g1(x),g2(x)). The function * and @c g2. Its @c operator() returns @c f(g1(x),g2(x)). The function
* @compose2 takes f, g1, and g2, and constructs the @c binary_compose * compose2 takes f, g1, and g2, and constructs the @c binary_compose
* instance for you. For example, if @c f returns an int, then * instance for you. For example, if @c f returns an int, then
* \code * \code
* int answer = (compose2(f,g1,g2))(x); * int answer = (compose2(f,g1,g2))(x);

8
libstdc++-v3/include/ext/memory
View File

@ -110,10 +110,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Copies the range [first,last) into result. * @brief Copies the range [first,last) into result.
* @param first An input iterator. * @param __first An input iterator.
* @param last An input iterator. * @param __count Length
* @param result An output iterator. * @param __result An output iterator.
* @return result + (first - last) * @return __result + (__first + __count)
* @ingroup SGIextensions * @ingroup SGIextensions
* *
* Like copy(), but does not require an initialized output range. * Like copy(), but does not require an initialized output range.

2
libstdc++-v3/include/ext/pb_ds/assoc_container.hpp
View File

@ -708,7 +708,7 @@ namespace __gnu_pbds
* @tparam _ATraits Element access traits. * @tparam _ATraits Element access traits.
* @tparam Tag Instantiating data structure type, * @tparam Tag Instantiating data structure type,
* see container_tag. * see container_tag.
* @tparam Node_Update Updates nodes, * @tparam Node_Update Updates trie nodes,
* restores invariants when invalidated. * restores invariants when invalidated.
* XXX See design::tree-based-containers::node invariants. * XXX See design::tree-based-containers::node invariants.
* @tparam _Alloc Allocator type. * @tparam _Alloc Allocator type.

15
libstdc++-v3/include/ext/stdio_filebuf.h
View File

@ -66,9 +66,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
stdio_filebuf() : std::basic_filebuf<_CharT, _Traits>() {} stdio_filebuf() : std::basic_filebuf<_CharT, _Traits>() {}
/** /**
* @param fd An open file descriptor. * @param __fd An open file descriptor.
* @param mode Same meaning as in a standard filebuf. * @param __mode Same meaning as in a standard filebuf.
* @param size Optimal or preferred size of internal buffer, in chars. * @param __size Optimal or preferred size of internal buffer,
* in chars.
* *
* This constructor associates a file stream buffer with an open * This constructor associates a file stream buffer with an open
* POSIX file descriptor. The file descriptor will be automatically * POSIX file descriptor. The file descriptor will be automatically
@ -78,10 +79,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
size_t __size = static_cast<size_t>(BUFSIZ)); size_t __size = static_cast<size_t>(BUFSIZ));
/** /**
* @param f An open @c FILE*. * @param __f An open @c FILE*.
* @param mode Same meaning as in a standard filebuf. * @param __mode Same meaning as in a standard filebuf.
* @param size Optimal or preferred size of internal buffer, in chars. * @param __size Optimal or preferred size of internal buffer,
* Defaults to system's @c BUFSIZ. * in chars. Defaults to system's @c BUFSIZ.
* *
* This constructor associates a file stream buffer with an open * This constructor associates a file stream buffer with an open
* C @c FILE*. The @c FILE* will not be automatically closed when the * C @c FILE*. The @c FILE* will not be automatically closed when the

12
libstdc++-v3/include/ext/vstring.h
View File

@ -141,7 +141,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// NB: per LWG issue 42, semantics different from IS: // NB: per LWG issue 42, semantics different from IS:
/** /**
* @brief Construct string with copy of value of @a str. * @brief Construct string with copy of value of @a __str.
* @param __str Source string. * @param __str Source string.
*/ */
__versa_string(const __versa_string& __str) __versa_string(const __versa_string& __str)
@ -153,7 +153,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* @param __str Source string. * @param __str Source string.
* *
* The newly-constructed %string contains the exact contents of * The newly-constructed %string contains the exact contents of
* @a str. The contents of @a str are a valid, but unspecified * @a __str. The contents of @a __str are a valid, but unspecified
* string. * string.
*/ */
__versa_string(__versa_string&& __str) noexcept __versa_string(__versa_string&& __str) noexcept
@ -2022,14 +2022,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Compare substring against a character array. * @brief Compare substring against a character array.
* @param __pos1 Index of first character of substring. * @param __pos Index of first character of substring.
* @param __n1 Number of characters in substring. * @param __n1 Number of characters in substring.
* @param __s character array to compare against. * @param __s character array to compare against.
* @param __n2 Number of characters of s. * @param __n2 Number of characters of s.
* @return Integer < 0, 0, or > 0. * @return Integer < 0, 0, or > 0.
* *
* Form the substring of this string from the @a __n1 * Form the substring of this string from the @a __n1
* characters starting at @a __pos1. Form a string from the * characters starting at @a __pos. Form a string from the
* first @a __n2 characters of @a __s. Returns an integer < 0 * first @a __n2 characters of @a __s. Returns an integer < 0
* if this substring is ordered before the string from @a __s, * if this substring is ordered before the string from @a __s,
* 0 if their values are equivalent, or > 0 if this substring * 0 if their values are equivalent, or > 0 if this substring
@ -2037,11 +2037,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* effective length rlen of the strings to compare as the * effective length rlen of the strings to compare as the
* smallest of the length of the substring and @a __n2. The * smallest of the length of the substring and @a __n2. The
* function then compares the two strings by calling * function then compares the two strings by calling
* traits::compare(substring.data(),s,rlen). If the result of * traits::compare(substring.data(),__s,rlen). If the result of
* the comparison is nonzero returns it, otherwise the shorter * the comparison is nonzero returns it, otherwise the shorter
* one is ordered first. * one is ordered first.
* *
* NB: s must have at least n2 characters, <em>\\0</em> has no special * NB: __s must have at least n2 characters, <em>\\0</em> has no special
* meaning. * meaning.
*/ */
int int

2
libstdc++-v3/include/parallel/base.h
View File

@ -365,7 +365,7 @@ namespace __gnu_parallel
typedef _PseudoSequenceIterator<_Tp, uint64_t> iterator; typedef _PseudoSequenceIterator<_Tp, uint64_t> iterator;
/** @brief Constructor. /** @brief Constructor.
* @param _M_val Element of the sequence. * @param __val Element of the sequence.
* @param __count Number of (virtual) copies. * @param __count Number of (virtual) copies.
*/ */
_PseudoSequence(const _Tp& __val, _DifferenceType __count) _PseudoSequence(const _Tp& __val, _DifferenceType __count)

6
libstdc++-v3/include/parallel/for_each_selectors.h
View File

@ -228,8 +228,8 @@ namespace __gnu_parallel
_It2 __begin2_iterator; _It2 __begin2_iterator;
/** @brief Constructor. /** @brief Constructor.
* @param b1 Begin iterator of first sequence. * @param __b1 Begin iterator of first sequence.
* @param b2 Begin iterator of second sequence. */ * @param __b2 Begin iterator of second sequence. */
explicit explicit
__inner_product_selector(_It __b1, _It2 __b2) __inner_product_selector(_It __b1, _It2 __b2)
: __begin1_iterator(__b1), __begin2_iterator(__b2) { } : __begin1_iterator(__b1), __begin2_iterator(__b2) { }
@ -291,7 +291,7 @@ namespace __gnu_parallel
* @param __i iterator referencing object. */ * @param __i iterator referencing object. */
template<typename _It> template<typename _It>
void void
operator()(_It) { } operator()(_It __i) { }
}; };
/** @brief Reduction function doing nothing. */ /** @brief Reduction function doing nothing. */

28
libstdc++-v3/include/parallel/multiway_merge.h
View File

@ -641,10 +641,7 @@ namespace __gnu_parallel
/** @brief Multi-way merging procedure for a high branching factor, /** @brief Multi-way merging procedure for a high branching factor,
* requiring sentinels to exist. * requiring sentinels to exist.
* *
* @param __stable The value must the same as for the used LoserTrees. * @tparam UnguardedLoserTree _Loser Tree variant to use for the unguarded
* @param UnguardedLoserTree _Loser Tree variant to use for the unguarded
* merging.
* @param GuardedLoserTree _Loser Tree variant to use for the guarded
* merging. * merging.
* *
* @param __seqs_begin Begin iterator of iterator pair input sequence. * @param __seqs_begin Begin iterator of iterator pair input sequence.
@ -911,7 +908,6 @@ namespace __gnu_parallel
* @param __comp Comparator. * @param __comp Comparator.
* @param __length Maximum length to merge, possibly larger than the * @param __length Maximum length to merge, possibly larger than the
* number of elements available. * number of elements available.
* @param __stable Stable merging incurs a performance penalty.
* @param __sentinel The sequences have __a __sentinel element. * @param __sentinel The sequences have __a __sentinel element.
* @return End iterator of output sequence. */ * @return End iterator of output sequence. */
template<bool __stable, template<bool __stable,
@ -1206,7 +1202,9 @@ namespace __gnu_parallel
* *
* Must not be called if the number of sequences is 1. * Must not be called if the number of sequences is 1.
* *
* @param _Splitter functor to split input (either __exact or sampling based) * @tparam _Splitter functor to split input (either __exact or sampling based)
* @tparam __stable Stable merging incurs a performance penalty.
* @tparam __sentinel Ignored.
* *
* @param __seqs_begin Begin iterator of iterator pair input sequence. * @param __seqs_begin Begin iterator of iterator pair input sequence.
* @param __seqs_end End iterator of iterator pair input sequence. * @param __seqs_end End iterator of iterator pair input sequence.
@ -1214,8 +1212,6 @@ namespace __gnu_parallel
* @param __comp Comparator. * @param __comp Comparator.
* @param __length Maximum length to merge, possibly larger than the * @param __length Maximum length to merge, possibly larger than the
* number of elements available. * number of elements available.
* @param __stable Stable merging incurs a performance penalty.
* @param __sentinel Ignored.
* @return End iterator of output sequence. * @return End iterator of output sequence.
*/ */
template<bool __stable, template<bool __stable,
@ -1396,11 +1392,11 @@ namespace __gnu_parallel
* @post return __value - __target = min(__length, number of elements in all * @post return __value - __target = min(__length, number of elements in all
* sequences). * sequences).
* *
* @param _RAIterPairIterator iterator over sequence * @tparam _RAIterPairIterator iterator over sequence
* of pairs of iterators * of pairs of iterators
* @param _RAIterOut iterator over target sequence * @tparam _RAIterOut iterator over target sequence
* @param _DifferenceTp difference type for the sequence * @tparam _DifferenceTp difference type for the sequence
* @param _Compare strict weak ordering type to compare elements * @tparam _Compare strict weak ordering type to compare elements
* in sequences * in sequences
* *
* @param __seqs_begin __begin of sequence __sequence * @param __seqs_begin __begin of sequence __sequence
@ -1760,11 +1756,11 @@ namespace __gnu_parallel
* *
* @see stable_multiway_merge_sentinels * @see stable_multiway_merge_sentinels
* *
* @param _RAIterPairIterator iterator over sequence * @tparam _RAIterPairIterator iterator over sequence
* of pairs of iterators * of pairs of iterators
* @param _RAIterOut iterator over target sequence * @tparam _RAIterOut iterator over target sequence
* @param _DifferenceTp difference type for the sequence * @tparam _DifferenceTp difference type for the sequence
* @param _Compare strict weak ordering type to compare elements * @tparam _Compare strict weak ordering type to compare elements
* in sequences * in sequences
* *
* @param __seqs_begin __begin of sequence __sequence * @param __seqs_begin __begin of sequence __sequence

1
libstdc++-v3/include/parallel/multiway_mergesort.h
View File

@ -387,7 +387,6 @@ namespace __gnu_parallel
* @param __begin Begin iterator of sequence. * @param __begin Begin iterator of sequence.
* @param __end End iterator of sequence. * @param __end End iterator of sequence.
* @param __comp Comparator. * @param __comp Comparator.
* @param __n Length of sequence.
* @param __num_threads Number of threads to use. * @param __num_threads Number of threads to use.
*/ */
template<bool __stable, bool __exact, typename _RAIter, template<bool __stable, bool __exact, typename _RAIter,

1
libstdc++-v3/include/parallel/partial_sum.h
View File

@ -80,7 +80,6 @@ namespace __gnu_parallel
* @param __result Begin iterator of output sequence. * @param __result Begin iterator of output sequence.
* @param __bin_op Associative binary function. * @param __bin_op Associative binary function.
* @param __n Length of sequence. * @param __n Length of sequence.
* @param __num_threads Number of threads to use.
* @return End iterator of output sequence. * @return End iterator of output sequence.
*/ */
template<typename _IIter, template<typename _IIter,

2
libstdc++-v3/include/parallel/queue.h
View File

@ -64,7 +64,7 @@ namespace __gnu_parallel
public: public:
/** @brief Constructor. Not to be called concurrent, of course. /** @brief Constructor. Not to be called concurrent, of course.
* @param _M_max_size Maximal number of elements to be contained. */ * @param __max_size Maximal number of elements to be contained. */
_RestrictedBoundedConcurrentQueue(_SequenceIndex __max_size) _RestrictedBoundedConcurrentQueue(_SequenceIndex __max_size)
{ {
_M_max_size = __max_size; _M_max_size = __max_size;

2
libstdc++-v3/include/parallel/random_number.h
View File

@ -104,7 +104,7 @@ namespace __gnu_parallel
} }
/** @brief Generate a number of random bits, run-time parameter. /** @brief Generate a number of random bits, run-time parameter.
* @param bits Number of bits to generate. */ * @param __bits Number of bits to generate. */
unsigned long unsigned long
__genrand_bits(int __bits) __genrand_bits(int __bits)
{ {

2
libstdc++-v3/include/parallel/search.h
View File

@ -44,7 +44,7 @@ namespace __gnu_parallel
* @brief Precalculate __advances for Knuth-Morris-Pratt algorithm. * @brief Precalculate __advances for Knuth-Morris-Pratt algorithm.
* @param __elements Begin iterator of sequence to search for. * @param __elements Begin iterator of sequence to search for.
* @param __length Length of sequence to search for. * @param __length Length of sequence to search for.
* @param __advances Returned __offsets. * @param __off Returned __offsets.
*/ */
template<typename _RAIter, typename _DifferenceTp> template<typename _RAIter, typename _DifferenceTp>
void void

9
libstdc++-v3/include/parallel/sort.h
View File

@ -67,6 +67,7 @@ namespace __gnu_parallel
* @param __begin Begin iterator of input sequence. * @param __begin Begin iterator of input sequence.
* @param __end End iterator of input sequence. * @param __end End iterator of input sequence.
* @param __comp Comparator. * @param __comp Comparator.
* @tparam __stable Sort stable.
* @callgraph * @callgraph
*/ */
template<bool __stable, typename _RAIter, typename _Compare> template<bool __stable, typename _RAIter, typename _Compare>
@ -90,6 +91,7 @@ namespace __gnu_parallel
* @param __begin Begin iterator of input sequence. * @param __begin Begin iterator of input sequence.
* @param __end End iterator of input sequence. * @param __end End iterator of input sequence.
* @param __comp Comparator. * @param __comp Comparator.
* @tparam __stable Sort stable.
* @callgraph * @callgraph
*/ */
template<bool __stable, typename _RAIter, typename _Compare> template<bool __stable, typename _RAIter, typename _Compare>
@ -110,6 +112,7 @@ namespace __gnu_parallel
* @param __begin Begin iterator of input sequence. * @param __begin Begin iterator of input sequence.
* @param __end End iterator of input sequence. * @param __end End iterator of input sequence.
* @param __comp Comparator. * @param __comp Comparator.
* @tparam __stable Sort stable.
* @callgraph * @callgraph
*/ */
template<bool __stable, typename _RAIter, typename _Compare> template<bool __stable, typename _RAIter, typename _Compare>
@ -129,6 +132,7 @@ namespace __gnu_parallel
* @param __begin Begin iterator of input sequence. * @param __begin Begin iterator of input sequence.
* @param __end End iterator of input sequence. * @param __end End iterator of input sequence.
* @param __comp Comparator. * @param __comp Comparator.
* @tparam __stable Sort stable.
* @callgraph * @callgraph
*/ */
template<bool __stable, typename _RAIter, typename _Compare> template<bool __stable, typename _RAIter, typename _Compare>
@ -149,7 +153,7 @@ namespace __gnu_parallel
* @param __begin Begin iterator of input sequence. * @param __begin Begin iterator of input sequence.
* @param __end End iterator of input sequence. * @param __end End iterator of input sequence.
* @param __comp Comparator. * @param __comp Comparator.
* @param __stable Sort __stable. * @tparam __stable Sort stable.
* @callgraph * @callgraph
*/ */
template<bool __stable, typename _RAIter, typename _Compare> template<bool __stable, typename _RAIter, typename _Compare>
@ -171,6 +175,7 @@ namespace __gnu_parallel
* @param __begin Begin iterator of input sequence. * @param __begin Begin iterator of input sequence.
* @param __end End iterator of input sequence. * @param __end End iterator of input sequence.
* @param __comp Comparator. * @param __comp Comparator.
* @tparam __stable Sort stable.
* @callgraph * @callgraph
*/ */
template<bool __stable, typename _RAIter, typename _Compare> template<bool __stable, typename _RAIter, typename _Compare>
@ -190,7 +195,7 @@ namespace __gnu_parallel
* @param __begin Begin iterator of input sequence. * @param __begin Begin iterator of input sequence.
* @param __end End iterator of input sequence. * @param __end End iterator of input sequence.
* @param __comp Comparator. * @param __comp Comparator.
* @param __stable Sort __stable. * @tparam __stable Sort stable.
* @callgraph * @callgraph
*/ */
template<bool __stable, typename _RAIter, typename _Compare> template<bool __stable, typename _RAIter, typename _Compare>

49
libstdc++-v3/include/std/bitset
View File

@ -831,10 +831,10 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Use a subset of a string. * @brief Use a subset of a string.
* @param s A string of @a 0 and @a 1 characters. * @param __s A string of @a 0 and @a 1 characters.
* @param position Index of the first character in @a s to use; * @param __position Index of the first character in @a __s to use;
* defaults to zero. * defaults to zero.
* @throw std::out_of_range If @a pos is bigger the size of @a s. * @throw std::out_of_range If @a pos is bigger the size of @a __s.
* @throw std::invalid_argument If a character appears in the string * @throw std::invalid_argument If a character appears in the string
* which is neither @a 0 nor @a 1. * which is neither @a 0 nor @a 1.
*/ */
@ -854,10 +854,11 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Use a subset of a string. * @brief Use a subset of a string.
* @param s A string of @a 0 and @a 1 characters. * @param __s A string of @a 0 and @a 1 characters.
* @param position Index of the first character in @a s to use. * @param __position Index of the first character in @a __s to use.
* @param n The number of characters to copy. * @param __n The number of characters to copy.
* @throw std::out_of_range If @a pos is bigger the size of @a s. * @throw std::out_of_range If @a __position is bigger the size
* of @a __s.
* @throw std::invalid_argument If a character appears in the string * @throw std::invalid_argument If a character appears in the string
* which is neither @a 0 nor @a 1. * which is neither @a 0 nor @a 1.
*/ */
@ -889,12 +890,12 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Construct from a character %array. * @brief Construct from a character %array.
* @param str An %array of characters @a zero and @a one. * @param __str An %array of characters @a zero and @a one.
* @param n The number of characters to use. * @param __n The number of characters to use.
* @param zero The character corresponding to the value 0. * @param __zero The character corresponding to the value 0.
* @param one The character corresponding to the value 1. * @param __one The character corresponding to the value 1.
* @throw std::invalid_argument If a character appears in the string * @throw std::invalid_argument If a character appears in the string
* which is neither @a zero nor @a one. * which is neither @a __zero nor @a __one.
*/ */
template<typename _CharT> template<typename _CharT>
explicit explicit
@ -919,7 +920,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Operations on bitsets. * @brief Operations on bitsets.
* @param rhs A same-sized bitset. * @param __rhs A same-sized bitset.
* *
* These should be self-explanatory. * These should be self-explanatory.
*/ */
@ -948,7 +949,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Operations on bitsets. * @brief Operations on bitsets.
* @param position The number of places to shift. * @param __position The number of places to shift.
* *
* These should be self-explanatory. * These should be self-explanatory.
*/ */
@ -1036,8 +1037,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Sets a given bit to a particular value. * @brief Sets a given bit to a particular value.
* @param position The index of the bit. * @param __position The index of the bit.
* @param val Either true or false, defaults to true. * @param __val Either true or false, defaults to true.
* @throw std::out_of_range If @a pos is bigger the size of the %set. * @throw std::out_of_range If @a pos is bigger the size of the %set.
*/ */
bitset<_Nb>& bitset<_Nb>&
@ -1060,7 +1061,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Sets a given bit to false. * @brief Sets a given bit to false.
* @param position The index of the bit. * @param __position The index of the bit.
* @throw std::out_of_range If @a pos is bigger the size of the %set. * @throw std::out_of_range If @a pos is bigger the size of the %set.
* *
* Same as writing @c set(pos,false). * Same as writing @c set(pos,false).
@ -1086,7 +1087,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Toggles a given bit to its opposite value. * @brief Toggles a given bit to its opposite value.
* @param position The index of the bit. * @param __position The index of the bit.
* @throw std::out_of_range If @a pos is bigger the size of the %set. * @throw std::out_of_range If @a pos is bigger the size of the %set.
*/ */
bitset<_Nb>& bitset<_Nb>&
@ -1105,7 +1106,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Array-indexing support. * @brief Array-indexing support.
* @param position Index into the %bitset. * @param __position Index into the %bitset.
* @return A bool for a <em>const %bitset</em>. For non-const * @return A bool for a <em>const %bitset</em>. For non-const
* bitsets, an instance of the reference proxy class. * bitsets, an instance of the reference proxy class.
* @note These operators do no range checking and throw no exceptions, * @note These operators do no range checking and throw no exceptions,
@ -1271,7 +1272,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Tests the value of a bit. * @brief Tests the value of a bit.
* @param position The index of a bit. * @param __position The index of a bit.
* @return The value at @a pos. * @return The value at @a pos.
* @throw std::out_of_range If @a pos is bigger the size of the %set. * @throw std::out_of_range If @a pos is bigger the size of the %set.
*/ */
@ -1333,7 +1334,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
/** /**
* @brief Finds the index of the next "on" bit after prev. * @brief Finds the index of the next "on" bit after prev.
* @return The index of the next bit set, or size() if not found. * @return The index of the next bit set, or size() if not found.
* @param prev Where to start searching. * @param __prev Where to start searching.
* @ingroup SGIextensions * @ingroup SGIextensions
* @sa _Find_first * @sa _Find_first
*/ */
@ -1381,8 +1382,8 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER
//@{ //@{
/** /**
* @brief Global bitwise operations on bitsets. * @brief Global bitwise operations on bitsets.
* @param x A bitset. * @param __x A bitset.
* @param y A bitset of the same size as @a x. * @param __y A bitset of the same size as @a __x.
* @return A new bitset. * @return A new bitset.
* *
* These should be self-explanatory. * These should be self-explanatory.

84
libstdc++-v3/include/std/fstream
View File

@ -226,12 +226,12 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Opens an external file. * @brief Opens an external file.
* @param s The name of the file. * @param __s The name of the file.
* @param mode The open mode flags. * @param __mode The open mode flags.
* @return @c this on success, NULL on failure * @return @c this on success, NULL on failure
* *
* If a file is already open, this function immediately fails. * If a file is already open, this function immediately fails.
* Otherwise it tries to open the file named @a s using the flags * Otherwise it tries to open the file named @a __s using the flags
* given in @a mode. * given in @a mode.
* *
* Table 92, adapted here, gives the relation between openmode * Table 92, adapted here, gives the relation between openmode
@ -269,8 +269,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Opens an external file. * @brief Opens an external file.
* @param s The name of the file. * @param __s The name of the file.
* @param mode The open mode flags. * @param __mode The open mode flags.
* @return @c this on success, NULL on failure * @return @c this on success, NULL on failure
*/ */
__filebuf_type* __filebuf_type*
@ -332,12 +332,12 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Manipulates the buffer. * @brief Manipulates the buffer.
* @param s Pointer to a buffer area. * @param __s Pointer to a buffer area.
* @param n Size of @a s. * @param __n Size of @a __s.
* @return @c this * @return @c this
* *
* If no file has been opened, and both @a s and @a n are zero, then * If no file has been opened, and both @a __s and @a __n are zero, then
* the stream becomes unbuffered. Otherwise, @c s is used as a * the stream becomes unbuffered. Otherwise, @c __s is used as a
* buffer; see * buffer; see
* http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch25s02.html * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch25s02.html
* for more. * for more.
@ -448,10 +448,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Create an input file stream. * @brief Create an input file stream.
* @param s Null terminated string specifying the filename. * @param __s Null terminated string specifying the filename.
* @param mode Open file in specified mode (see std::ios_base). * @param __mode Open file in specified mode (see std::ios_base).
* *
* @c ios_base::in is automatically included in @a mode. * @c ios_base::in is automatically included in @a __mode.
* *
* Tip: When using std::string to hold the filename, you must use * Tip: When using std::string to hold the filename, you must use
* .c_str() before passing it to this constructor. * .c_str() before passing it to this constructor.
@ -467,10 +467,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Create an input file stream. * @brief Create an input file stream.
* @param s std::string specifying the filename. * @param __s std::string specifying the filename.
* @param mode Open file in specified mode (see std::ios_base). * @param __mode Open file in specified mode (see std::ios_base).
* *
* @c ios_base::in is automatically included in @a mode. * @c ios_base::in is automatically included in @a __mode.
*/ */
explicit explicit
basic_ifstream(const std::string& __s, basic_ifstream(const std::string& __s,
@ -518,10 +518,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Opens an external file. * @brief Opens an external file.
* @param s The name of the file. * @param __s The name of the file.
* @param mode The open mode flags. * @param __mode The open mode flags.
* *
* Calls @c std::basic_filebuf::open(s,mode|in). If that function * Calls @c std::basic_filebuf::open(s,__mode|in). If that function
* fails, @c failbit is set in the stream's error state. * fails, @c failbit is set in the stream's error state.
* *
* Tip: When using std::string to hold the filename, you must use * Tip: When using std::string to hold the filename, you must use
@ -541,10 +541,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Opens an external file. * @brief Opens an external file.
* @param s The name of the file. * @param __s The name of the file.
* @param mode The open mode flags. * @param __mode The open mode flags.
* *
* Calls @c std::basic_filebuf::open(s,mode|in). If that function * Calls @c std::basic_filebuf::open(__s,__mode|in). If that function
* fails, @c failbit is set in the stream's error state. * fails, @c failbit is set in the stream's error state.
*/ */
void void
@ -616,11 +616,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Create an output file stream. * @brief Create an output file stream.
* @param s Null terminated string specifying the filename. * @param __s Null terminated string specifying the filename.
* @param mode Open file in specified mode (see std::ios_base). * @param __mode Open file in specified mode (see std::ios_base).
* *
* @c ios_base::out|ios_base::trunc is automatically included in * @c ios_base::out|ios_base::trunc is automatically included in
* @a mode. * @a __mode.
* *
* Tip: When using std::string to hold the filename, you must use * Tip: When using std::string to hold the filename, you must use
* .c_str() before passing it to this constructor. * .c_str() before passing it to this constructor.
@ -637,11 +637,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Create an output file stream. * @brief Create an output file stream.
* @param s std::string specifying the filename. * @param __s std::string specifying the filename.
* @param mode Open file in specified mode (see std::ios_base). * @param __mode Open file in specified mode (see std::ios_base).
* *
* @c ios_base::out|ios_base::trunc is automatically included in * @c ios_base::out|ios_base::trunc is automatically included in
* @a mode. * @a __mode.
*/ */
explicit explicit
basic_ofstream(const std::string& __s, basic_ofstream(const std::string& __s,
@ -689,10 +689,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Opens an external file. * @brief Opens an external file.
* @param s The name of the file. * @param __s The name of the file.
* @param mode The open mode flags. * @param __mode The open mode flags.
* *
* Calls @c std::basic_filebuf::open(s,mode|out|trunc). If that * Calls @c std::basic_filebuf::open(__s,__mode|out|trunc). If that
* function fails, @c failbit is set in the stream's error state. * function fails, @c failbit is set in the stream's error state.
* *
* Tip: When using std::string to hold the filename, you must use * Tip: When using std::string to hold the filename, you must use
@ -713,8 +713,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Opens an external file. * @brief Opens an external file.
* @param s The name of the file. * @param __s The name of the file.
* @param mode The open mode flags. * @param __mode The open mode flags.
* *
* Calls @c std::basic_filebuf::open(s,mode|out|trunc). If that * Calls @c std::basic_filebuf::open(s,mode|out|trunc). If that
* function fails, @c failbit is set in the stream's error state. * function fails, @c failbit is set in the stream's error state.
@ -791,8 +791,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Create an input/output file stream. * @brief Create an input/output file stream.
* @param s Null terminated string specifying the filename. * @param __s Null terminated string specifying the filename.
* @param mode Open file in specified mode (see std::ios_base). * @param __mode Open file in specified mode (see std::ios_base).
* *
* Tip: When using std::string to hold the filename, you must use * Tip: When using std::string to hold the filename, you must use
* .c_str() before passing it to this constructor. * .c_str() before passing it to this constructor.
@ -809,8 +809,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Create an input/output file stream. * @brief Create an input/output file stream.
* @param s Null terminated string specifying the filename. * @param __s Null terminated string specifying the filename.
* @param mode Open file in specified mode (see std::ios_base). * @param __mode Open file in specified mode (see std::ios_base).
*/ */
explicit explicit
basic_fstream(const std::string& __s, basic_fstream(const std::string& __s,
@ -858,10 +858,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Opens an external file. * @brief Opens an external file.
* @param s The name of the file. * @param __s The name of the file.
* @param mode The open mode flags. * @param __mode The open mode flags.
* *
* Calls @c std::basic_filebuf::open(s,mode). If that * Calls @c std::basic_filebuf::open(__s,__mode). If that
* function fails, @c failbit is set in the stream's error state. * function fails, @c failbit is set in the stream's error state.
* *
* Tip: When using std::string to hold the filename, you must use * Tip: When using std::string to hold the filename, you must use
@ -882,10 +882,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Opens an external file. * @brief Opens an external file.
* @param s The name of the file. * @param __s The name of the file.
* @param mode The open mode flags. * @param __mode The open mode flags.
* *
* Calls @c std::basic_filebuf::open(s,mode). If that * Calls @c std::basic_filebuf::open(__s,__mode). If that
* function fails, @c failbit is set in the stream's error state. * function fails, @c failbit is set in the stream's error state.
*/ */
void void

44
libstdc++-v3/include/std/functional
View File

@ -1996,19 +1996,19 @@ _GLIBCXX_HAS_NESTED_TYPE(result_type)
/** /**
* @brief %Function copy constructor. * @brief %Function copy constructor.
* @param x A %function object with identical call signature. * @param __x A %function object with identical call signature.
* @post @c (bool)*this == (bool)x * @post @c bool(*this) == bool(__x)
* *
* The newly-created %function contains a copy of the target of @a * The newly-created %function contains a copy of the target of @a
* x (if it has one). * __x (if it has one).
*/ */
function(const function& __x); function(const function& __x);
/** /**
* @brief %Function move constructor. * @brief %Function move constructor.
* @param x A %function object rvalue with identical call signature. * @param __x A %function object rvalue with identical call signature.
* *
* The newly-created %function contains the target of @a x * The newly-created %function contains the target of @a __x
* (if it has one). * (if it has one).
*/ */
function(function&& __x) : _Function_base() function(function&& __x) : _Function_base()
@ -2021,17 +2021,17 @@ _GLIBCXX_HAS_NESTED_TYPE(result_type)
/** /**
* @brief Builds a %function that targets a copy of the incoming * @brief Builds a %function that targets a copy of the incoming
* function object. * function object.
* @param f A %function object that is callable with parameters of * @param __f A %function object that is callable with parameters of
* type @c T1, @c T2, ..., @c TN and returns a value convertible * type @c T1, @c T2, ..., @c TN and returns a value convertible
* to @c Res. * to @c Res.
* *
* The newly-created %function object will target a copy of @a * The newly-created %function object will target a copy of
* f. If @a f is @c reference_wrapper<F>, then this function * @a __f. If @a __f is @c reference_wrapper<F>, then this function
* object will contain a reference to the function object @c * object will contain a reference to the function object @c
* f.get(). If @a f is a NULL function pointer or NULL * __f.get(). If @a __f is a NULL function pointer or NULL
* pointer-to-member, the newly-created object will be empty. * pointer-to-member, the newly-created object will be empty.
* *
* If @a f is a non-NULL function pointer or an object of type @c * If @a __f is a non-NULL function pointer or an object of type @c
* reference_wrapper<F>, this function will not throw. * reference_wrapper<F>, this function will not throw.
*/ */
template<typename _Functor> template<typename _Functor>
@ -2042,14 +2042,14 @@ _GLIBCXX_HAS_NESTED_TYPE(result_type)
/** /**
* @brief %Function assignment operator. * @brief %Function assignment operator.
* @param x A %function with identical call signature. * @param __x A %function with identical call signature.
* @post @c (bool)*this == (bool)x * @post @c (bool)*this == (bool)x
* @returns @c *this * @returns @c *this
* *
* The target of @a x is copied to @c *this. If @a x has no * The target of @a __x is copied to @c *this. If @a __x has no
* target, then @c *this will be empty. * target, then @c *this will be empty.
* *
* If @a x targets a function pointer or a reference to a function * If @a __x targets a function pointer or a reference to a function
* object, then this operation will not throw an %exception. * object, then this operation will not throw an %exception.
*/ */
function& function&
@ -2061,13 +2061,13 @@ _GLIBCXX_HAS_NESTED_TYPE(result_type)
/** /**
* @brief %Function move-assignment operator. * @brief %Function move-assignment operator.
* @param x A %function rvalue with identical call signature. * @param __x A %function rvalue with identical call signature.
* @returns @c *this * @returns @c *this
* *
* The target of @a x is moved to @c *this. If @a x has no * The target of @a __x is moved to @c *this. If @a __x has no
* target, then @c *this will be empty. * target, then @c *this will be empty.
* *
* If @a x targets a function pointer or a reference to a function * If @a __x targets a function pointer or a reference to a function
* object, then this operation will not throw an %exception. * object, then this operation will not throw an %exception.
*/ */
function& function&
@ -2098,18 +2098,18 @@ _GLIBCXX_HAS_NESTED_TYPE(result_type)
/** /**
* @brief %Function assignment to a new target. * @brief %Function assignment to a new target.
* @param f A %function object that is callable with parameters of * @param __f A %function object that is callable with parameters of
* type @c T1, @c T2, ..., @c TN and returns a value convertible * type @c T1, @c T2, ..., @c TN and returns a value convertible
* to @c Res. * to @c Res.
* @return @c *this * @return @c *this
* *
* This %function object wrapper will target a copy of @a * This %function object wrapper will target a copy of @a
* f. If @a f is @c reference_wrapper<F>, then this function * __f. If @a __f is @c reference_wrapper<F>, then this function
* object will contain a reference to the function object @c * object will contain a reference to the function object @c
* f.get(). If @a f is a NULL function pointer or NULL * __f.get(). If @a __f is a NULL function pointer or NULL
* pointer-to-member, @c this object will be empty. * pointer-to-member, @c this object will be empty.
* *
* If @a f is a non-NULL function pointer or an object of type @c * If @a __f is a non-NULL function pointer or an object of type @c
* reference_wrapper<F>, this function will not throw. * reference_wrapper<F>, this function will not throw.
*/ */
template<typename _Functor> template<typename _Functor>
@ -2133,9 +2133,9 @@ _GLIBCXX_HAS_NESTED_TYPE(result_type)
/** /**
* @brief Swap the targets of two %function objects. * @brief Swap the targets of two %function objects.
* @param f A %function with identical call signature. * @param __x A %function with identical call signature.
* *
* Swap the targets of @c this function object and @a f. This * Swap the targets of @c this function object and @a __f. This
* function will not throw an %exception. * function will not throw an %exception.
*/ */
void swap(function& __x) void swap(function& __x)

40
libstdc++-v3/include/std/iomanip
View File

@ -56,10 +56,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Manipulator for @c setf. * @brief Manipulator for @c setf.
* @param mask A format flags mask. * @param __mask A format flags mask.
* *
* Sent to a stream object, this manipulator resets the specified flags, * Sent to a stream object, this manipulator resets the specified flags,
* via @e stream.setf(0,mask). * via @e stream.setf(0,__mask).
*/ */
inline _Resetiosflags inline _Resetiosflags
resetiosflags(ios_base::fmtflags __mask) resetiosflags(ios_base::fmtflags __mask)
@ -86,10 +86,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Manipulator for @c setf. * @brief Manipulator for @c setf.
* @param mask A format flags mask. * @param __mask A format flags mask.
* *
* Sent to a stream object, this manipulator sets the format flags * Sent to a stream object, this manipulator sets the format flags
* to @a mask. * to @a __mask.
*/ */
inline _Setiosflags inline _Setiosflags
setiosflags(ios_base::fmtflags __mask) setiosflags(ios_base::fmtflags __mask)
@ -116,11 +116,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Manipulator for @c setf. * @brief Manipulator for @c setf.
* @param base A numeric base. * @param __base A numeric base.
* *
* Sent to a stream object, this manipulator changes the * Sent to a stream object, this manipulator changes the
* @c ios_base::basefield flags to @c oct, @c dec, or @c hex when @a base * @c ios_base::basefield flags to @c oct, @c dec, or @c hex when @a base
* is 8, 10, or 16, accordingly, and to 0 if @a base is any other value. * is 8, 10, or 16, accordingly, and to 0 if @a __base is any other value.
*/ */
inline _Setbase inline _Setbase
setbase(int __base) setbase(int __base)
@ -154,9 +154,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Manipulator for @c fill. * @brief Manipulator for @c fill.
* @param c The new fill character. * @param __c The new fill character.
* *
* Sent to a stream object, this manipulator calls @c fill(c) for that * Sent to a stream object, this manipulator calls @c fill(__c) for that
* object. * object.
*/ */
template<typename _CharT> template<typename _CharT>
@ -185,9 +185,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Manipulator for @c precision. * @brief Manipulator for @c precision.
* @param n The new precision. * @param __n The new precision.
* *
* Sent to a stream object, this manipulator calls @c precision(n) for * Sent to a stream object, this manipulator calls @c precision(__n) for
* that object. * that object.
*/ */
inline _Setprecision inline _Setprecision
@ -215,9 +215,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Manipulator for @c width. * @brief Manipulator for @c width.
* @param n The new width. * @param __n The new width.
* *
* Sent to a stream object, this manipulator calls @c width(n) for * Sent to a stream object, this manipulator calls @c width(__n) for
* that object. * that object.
*/ */
inline _Setw inline _Setw
@ -247,11 +247,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Extended manipulator for extracting money. * @brief Extended manipulator for extracting money.
* @param mon Either long double or a specialization of @c basic_string. * @param __mon Either long double or a specialization of @c basic_string.
* @param intl A bool indicating whether international format * @param __intl A bool indicating whether international format
* is to be used. * is to be used.
* *
* Sent to a stream object, this manipulator extracts @a mon. * Sent to a stream object, this manipulator extracts @a __mon.
*/ */
template<typename _MoneyT> template<typename _MoneyT>
inline _Get_money<_MoneyT> inline _Get_money<_MoneyT>
@ -283,11 +283,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Extended manipulator for inserting money. * @brief Extended manipulator for inserting money.
* @param mon Either long double or a specialization of @c basic_string. * @param __mon Either long double or a specialization of @c basic_string.
* @param intl A bool indicating whether international format * @param __intl A bool indicating whether international format
* is to be used. * is to be used.
* *
* Sent to a stream object, this manipulator inserts @a mon. * Sent to a stream object, this manipulator inserts @a __mon.
*/ */
template<typename _MoneyT> template<typename _MoneyT>
inline _Put_money<_MoneyT> inline _Put_money<_MoneyT>

128
libstdc++-v3/include/std/istream
View File

@ -159,7 +159,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
//@{ //@{
/** /**
* @brief Basic arithmetic extractors * @brief Basic arithmetic extractors
* @param A variable of builtin type. * @param __n, __f, __p: A variable of builtin type.
* @return @c *this if successful * @return @c *this if successful
* *
* These functions use the stream's current locale (specifically, the * These functions use the stream's current locale (specifically, the
@ -219,13 +219,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Extracting into another streambuf. * @brief Extracting into another streambuf.
* @param sb A pointer to a streambuf * @param __sb A pointer to a streambuf
* *
* This function behaves like one of the basic arithmetic extractors, * This function behaves like one of the basic arithmetic extractors,
* in that it also constructs a sentry object and has the same error * in that it also constructs a sentry object and has the same error
* handling behavior. * handling behavior.
* *
* If @a sb is NULL, the stream will set failbit in its error state. * If @a __sb is NULL, the stream will set failbit in its error state.
* *
* Characters are extracted from this stream and inserted into the * Characters are extracted from this stream and inserted into the
* @a sb streambuf until one of the following occurs: * @a sb streambuf until one of the following occurs:
@ -284,10 +284,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Simple extraction. * @brief Simple extraction.
* @param c The character in which to store data. * @param __c The character in which to store data.
* @return *this * @return *this
* *
* Tries to extract a character and store it in @a c. If none are * Tries to extract a character and store it in @a __c. If none are
* available, sets failbit and returns traits::eof(). * available, sets failbit and returns traits::eof().
* *
* @note This function is not overloaded on signed char and * @note This function is not overloaded on signed char and
@ -298,17 +298,17 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Simple multiple-character extraction. * @brief Simple multiple-character extraction.
* @param s Pointer to an array. * @param __s Pointer to an array.
* @param n Maximum number of characters to store in @a s. * @param __n Maximum number of characters to store in @a __s.
* @param delim A "stop" character. * @param __delim A "stop" character.
* @return *this * @return *this
* *
* Characters are extracted and stored into @a s until one of the * Characters are extracted and stored into @a __s until one of the
* following happens: * following happens:
* *
* - @c n-1 characters are stored * - @c __n-1 characters are stored
* - the input sequence reaches EOF * - the input sequence reaches EOF
* - the next character equals @a delim, in which case the character * - the next character equals @a __delim, in which case the character
* is not extracted * is not extracted
* *
* If no characters are stored, failbit is set in the stream's error * If no characters are stored, failbit is set in the stream's error
@ -325,11 +325,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Simple multiple-character extraction. * @brief Simple multiple-character extraction.
* @param s Pointer to an array. * @param __s Pointer to an array.
* @param n Maximum number of characters to store in @a s. * @param __n Maximum number of characters to store in @a s.
* @return *this * @return *this
* *
* Returns @c get(s,n,widen(&apos;\\n&apos;)). * Returns @c get(__s,__n,widen(&apos;\\n&apos;)).
*/ */
__istream_type& __istream_type&
get(char_type* __s, streamsize __n) get(char_type* __s, streamsize __n)
@ -337,17 +337,17 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Extraction into another streambuf. * @brief Extraction into another streambuf.
* @param sb A streambuf in which to store data. * @param __sb A streambuf in which to store data.
* @param delim A "stop" character. * @param __delim A "stop" character.
* @return *this * @return *this
* *
* Characters are extracted and inserted into @a sb until one of the * Characters are extracted and inserted into @a __sb until one of the
* following happens: * following happens:
* *
* - the input sequence reaches EOF * - the input sequence reaches EOF
* - insertion into the output buffer fails (in this case, the * - insertion into the output buffer fails (in this case, the
* character that would have been inserted is not extracted) * character that would have been inserted is not extracted)
* - the next character equals @a delim (in this case, the character * - the next character equals @a __delim (in this case, the character
* is not extracted) * is not extracted)
* - an exception occurs (and in this case is caught) * - an exception occurs (and in this case is caught)
* *
@ -359,10 +359,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Extraction into another streambuf. * @brief Extraction into another streambuf.
* @param sb A streambuf in which to store data. * @param __sb A streambuf in which to store data.
* @return *this * @return *this
* *
* Returns @c get(sb,widen(&apos;\\n&apos;)). * Returns @c get(__sb,widen(&apos;\\n&apos;)).
*/ */
__istream_type& __istream_type&
get(__streambuf_type& __sb) get(__streambuf_type& __sb)
@ -370,21 +370,21 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief String extraction. * @brief String extraction.
* @param s A character array in which to store the data. * @param __s A character array in which to store the data.
* @param n Maximum number of characters to extract. * @param __n Maximum number of characters to extract.
* @param delim A "stop" character. * @param __delim A "stop" character.
* @return *this * @return *this
* *
* Extracts and stores characters into @a s until one of the * Extracts and stores characters into @a __s until one of the
* following happens. Note that these criteria are required to be * following happens. Note that these criteria are required to be
* tested in the order listed here, to allow an input line to exactly * tested in the order listed here, to allow an input line to exactly
* fill the @a s array without setting failbit. * fill the @a __s array without setting failbit.
* *
* -# the input sequence reaches end-of-file, in which case eofbit * -# the input sequence reaches end-of-file, in which case eofbit
* is set in the stream error state * is set in the stream error state
* -# the next character equals @c delim, in which case the character * -# the next character equals @c __delim, in which case the character
* is extracted (and therefore counted in @c gcount()) but not stored * is extracted (and therefore counted in @c gcount()) but not stored
* -# @c n-1 characters are stored, in which case failbit is set * -# @c __n-1 characters are stored, in which case failbit is set
* in the stream error state * in the stream error state
* *
* If no characters are extracted, failbit is set. (An empty line of * If no characters are extracted, failbit is set. (An empty line of
@ -398,11 +398,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief String extraction. * @brief String extraction.
* @param s A character array in which to store the data. * @param __s A character array in which to store the data.
* @param n Maximum number of characters to extract. * @param __n Maximum number of characters to extract.
* @return *this * @return *this
* *
* Returns @c getline(s,n,widen(&apos;\\n&apos;)). * Returns @c getline(__s,__n,widen(&apos;\\n&apos;)).
*/ */
__istream_type& __istream_type&
getline(char_type* __s, streamsize __n) getline(char_type* __s, streamsize __n)
@ -410,18 +410,18 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Discarding characters * @brief Discarding characters
* @param n Number of characters to discard. * @param __n Number of characters to discard.
* @param delim A "stop" character. * @param __delim A "stop" character.
* @return *this * @return *this
* *
* Extracts characters and throws them away until one of the * Extracts characters and throws them away until one of the
* following happens: * following happens:
* - if @a n @c != @c std::numeric_limits<int>::max(), @a n * - if @a __n @c != @c std::numeric_limits<int>::max(), @a __n
* characters are extracted * characters are extracted
* - the input sequence reaches end-of-file * - the input sequence reaches end-of-file
* - the next character equals @a delim (in this case, the character * - the next character equals @a __delim (in this case, the character
* is extracted); note that this condition will never occur if * is extracted); note that this condition will never occur if
* @a delim equals @c traits::eof(). * @a __delim equals @c traits::eof().
* *
* NB: Provide three overloads, instead of the single function * NB: Provide three overloads, instead of the single function
* (with defaults) mandated by the Standard: this leads to a * (with defaults) mandated by the Standard: this leads to a
@ -429,14 +429,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* the Standard. * the Standard.
*/ */
__istream_type& __istream_type&
ignore(); ignore(streamsize __n, int_type __delim);
__istream_type& __istream_type&
ignore(streamsize __n); ignore(streamsize __n);
__istream_type& __istream_type&
ignore(streamsize __n, int_type __delim); ignore();
/** /**
* @brief Looking ahead in the stream * @brief Looking ahead in the stream
* @return The next character, or eof(). * @return The next character, or eof().
@ -450,13 +450,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Extraction without delimiters. * @brief Extraction without delimiters.
* @param s A character array. * @param __s A character array.
* @param n Maximum number of characters to store. * @param __n Maximum number of characters to store.
* @return *this * @return *this
* *
* If the stream state is @c good(), extracts characters and stores * If the stream state is @c good(), extracts characters and stores
* them into @a s until one of the following happens: * them into @a __s until one of the following happens:
* - @a n characters are stored * - @a __n characters are stored
* - the input sequence reaches end-of-file, in which case the error * - the input sequence reaches end-of-file, in which case the error
* state is set to @c failbit|eofbit. * state is set to @c failbit|eofbit.
* *
@ -468,11 +468,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Extraction until the buffer is exhausted, but no more. * @brief Extraction until the buffer is exhausted, but no more.
* @param s A character array. * @param __s A character array.
* @param n Maximum number of characters to store. * @param __n Maximum number of characters to store.
* @return The number of characters extracted. * @return The number of characters extracted.
* *
* Extracts characters and stores them into @a s depending on the * Extracts characters and stores them into @a __s depending on the
* number of characters remaining in the streambuf's buffer, * number of characters remaining in the streambuf's buffer,
* @c rdbuf()->in_avail(), called @c A here: * @c rdbuf()->in_avail(), called @c A here:
* - if @c A @c == @c -1, sets eofbit and extracts no characters * - if @c A @c == @c -1, sets eofbit and extracts no characters
@ -487,7 +487,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Unextracting a single character. * @brief Unextracting a single character.
* @param c The character to push back into the input stream. * @param __c The character to push back into the input stream.
* @return *this * @return *this
* *
* If @c rdbuf() is not null, calls @c rdbuf()->sputbackc(c). * If @c rdbuf() is not null, calls @c rdbuf()->sputbackc(c).
@ -553,10 +553,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Changing the current read position. * @brief Changing the current read position.
* @param pos A file position object. * @param __pos A file position object.
* @return *this * @return *this
* *
* If @c fail() is not true, calls @c rdbuf()->pubseekpos(pos). If * If @c fail() is not true, calls @c rdbuf()->pubseekpos(__pos). If
* that function fails, sets failbit. * that function fails, sets failbit.
* *
* @note This function first clears eofbit. It does not count the * @note This function first clears eofbit. It does not count the
@ -568,11 +568,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Changing the current read position. * @brief Changing the current read position.
* @param off A file offset object. * @param __off A file offset object.
* @param dir The direction in which to seek. * @param __dir The direction in which to seek.
* @return *this * @return *this
* *
* If @c fail() is not true, calls @c rdbuf()->pubseekoff(off,dir). * If @c fail() is not true, calls @c rdbuf()->pubseekoff(__off,__dir).
* If that function fails, sets failbit. * If that function fails, sets failbit.
* *
* @note This function first clears eofbit. It does not count the * @note This function first clears eofbit. It does not count the
@ -650,10 +650,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief The constructor performs all the work. * @brief The constructor performs all the work.
* @param is The input stream to guard. * @param __is The input stream to guard.
* @param noskipws Whether to consume whitespace or not. * @param __noskipws Whether to consume whitespace or not.
* *
* If the stream state is good (@a is.good() is true), then the * If the stream state is good (@a __is.good() is true), then the
* following actions are performed, otherwise the sentry state * following actions are performed, otherwise the sentry state
* is false (<em>not okay</em>) and failbit is set in the * is false (<em>not okay</em>) and failbit is set in the
* stream state. * stream state.
@ -662,7 +662,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* -# if the stream is tied to an output stream, @c is.tie()->flush() * -# if the stream is tied to an output stream, @c is.tie()->flush()
* is called to synchronize the output sequence * is called to synchronize the output sequence
* -# if @a noskipws is false, and @c ios_base::skipws is set in * -# if @a __noskipws is false, and @c ios_base::skipws is set in
* @c is.flags(), the sentry extracts and discards whitespace * @c is.flags(), the sentry extracts and discards whitespace
* characters from the stream. The currently imbued locale is * characters from the stream. The currently imbued locale is
* used to determine whether each character is whitespace. * used to determine whether each character is whitespace.
@ -691,14 +691,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
//@{ //@{
/** /**
* @brief Character extractors * @brief Character extractors
* @param in An input stream. * @param __in An input stream.
* @param c A character reference. * @param __c A character reference.
* @return in * @return in
* *
* Behaves like one of the formatted arithmetic extractors described in * Behaves like one of the formatted arithmetic extractors described in
* std::basic_istream. After constructing a sentry object with good * std::basic_istream. After constructing a sentry object with good
* status, this function extracts a character (if one is available) and * status, this function extracts a character (if one is available) and
* stores it in @a c. Otherwise, sets failbit in the input stream. * stores it in @a __c. Otherwise, sets failbit in the input stream.
*/ */
template<typename _CharT, typename _Traits> template<typename _CharT, typename _Traits>
basic_istream<_CharT, _Traits>& basic_istream<_CharT, _Traits>&
@ -718,14 +718,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
//@{ //@{
/** /**
* @brief Character string extractors * @brief Character string extractors
* @param in An input stream. * @param __in An input stream.
* @param s A pointer to a character array. * @param __s A pointer to a character array.
* @return in * @return __in
* *
* Behaves like one of the formatted arithmetic extractors described in * Behaves like one of the formatted arithmetic extractors described in
* std::basic_istream. After constructing a sentry object with good * std::basic_istream. After constructing a sentry object with good
* status, this function extracts up to @c n characters and stores them * status, this function extracts up to @c n characters and stores them
* into the array starting at @a s. @c n is defined as: * into the array starting at @a __s. @c n is defined as:
* *
* - if @c width() is greater than zero, @c n is width() otherwise * - if @c width() is greater than zero, @c n is width() otherwise
* - @c n is <em>the number of elements of the largest array of * * - @c n is <em>the number of elements of the largest array of *
@ -839,8 +839,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// [27.7.1.6] Rvalue stream extraction // [27.7.1.6] Rvalue stream extraction
/** /**
* @brief Generic extractor for rvalue stream * @brief Generic extractor for rvalue stream
* @param is An input stream. * @param __is An input stream.
* @param x A reference to the extraction target. * @param __x A reference to the extraction target.
* @return is * @return is
* *
* This is just a forwarding function to allow extraction from * This is just a forwarding function to allow extraction from

52
libstdc++-v3/include/std/ostream
View File

@ -157,7 +157,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
//@{ //@{
/** /**
* @brief Basic arithmetic inserters * @brief Basic arithmetic inserters
* @param A variable of builtin type. * @param __n, __f, __p A variable of builtin type.
* @return @c *this if successful * @return @c *this if successful
* *
* These functions use the stream's current locale (specifically, the * These functions use the stream's current locale (specifically, the
@ -229,21 +229,21 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Extracting from another streambuf. * @brief Extracting from another streambuf.
* @param sb A pointer to a streambuf * @param __sb A pointer to a streambuf
* *
* This function behaves like one of the basic arithmetic extractors, * This function behaves like one of the basic arithmetic extractors,
* in that it also constructs a sentry object and has the same error * in that it also constructs a sentry object and has the same error
* handling behavior. * handling behavior.
* *
* If @a sb is NULL, the stream will set failbit in its error state. * If @a __sb is NULL, the stream will set failbit in its error state.
* *
* Characters are extracted from @a sb and inserted into @c *this * Characters are extracted from @a __sb and inserted into @c *this
* until one of the following occurs: * until one of the following occurs:
* *
* - the input stream reaches end-of-file, * - the input stream reaches end-of-file,
* - insertion into the output sequence fails (in this case, the * - insertion into the output sequence fails (in this case, the
* character that would have been inserted is not extracted), or * character that would have been inserted is not extracted), or
* - an exception occurs while getting a character from @a sb, which * - an exception occurs while getting a character from @a __sb, which
* sets failbit in the error state * sets failbit in the error state
* *
* If the function inserts no characters, failbit is set. * If the function inserts no characters, failbit is set.
@ -273,7 +273,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
//@{ //@{
/** /**
* @brief Simple insertion. * @brief Simple insertion.
* @param c The character to insert. * @param __c The character to insert.
* @return *this * @return *this
* *
* Tries to insert @a c. * Tries to insert @a c.
@ -295,14 +295,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Character string insertion. * @brief Character string insertion.
* @param s The array to insert. * @param __s The array to insert.
* @param n Maximum number of characters to insert. * @param __n Maximum number of characters to insert.
* @return *this * @return *this
* *
* Characters are copied from @a s and inserted into the stream until * Characters are copied from @a __s and inserted into the stream until
* one of the following happens: * one of the following happens:
* *
* - @a n characters are inserted * - @a __n characters are inserted
* - inserting into the output sequence fails (in this case, badbit * - inserting into the output sequence fails (in this case, badbit
* will be set in the stream's error state) * will be set in the stream's error state)
* *
@ -338,7 +338,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Changing the current write position. * @brief Changing the current write position.
* @param pos A file position object. * @param __pos A file position object.
* @return *this * @return *this
* *
* If @c fail() is not true, calls @c rdbuf()->pubseekpos(pos). If * If @c fail() is not true, calls @c rdbuf()->pubseekpos(pos). If
@ -349,8 +349,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Changing the current write position. * @brief Changing the current write position.
* @param off A file offset object. * @param __off A file offset object.
* @param dir The direction in which to seek. * @param __dir The direction in which to seek.
* @return *this * @return *this
* *
* If @c fail() is not true, calls @c rdbuf()->pubseekoff(off,dir). * If @c fail() is not true, calls @c rdbuf()->pubseekoff(off,dir).
@ -385,9 +385,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
public: public:
/** /**
* @brief The constructor performs preparatory work. * @brief The constructor performs preparatory work.
* @param os The output stream to guard. * @param __os The output stream to guard.
* *
* If the stream state is good (@a os.good() is true), then if the * If the stream state is good (@a __os.good() is true), then if the
* stream is tied to another output stream, @c is.tie()->flush() * stream is tied to another output stream, @c is.tie()->flush()
* is called to synchronize the output sequences. * is called to synchronize the output sequences.
* *
@ -433,17 +433,17 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
//@{ //@{
/** /**
* @brief Character inserters * @brief Character inserters
* @param out An output stream. * @param __out An output stream.
* @param c A character. * @param __c A character.
* @return out * @return out
* *
* Behaves like one of the formatted arithmetic inserters described in * Behaves like one of the formatted arithmetic inserters described in
* std::basic_ostream. After constructing a sentry object with good * std::basic_ostream. After constructing a sentry object with good
* status, this function inserts a single character and any required * status, this function inserts a single character and any required
* padding (as determined by [22.2.2.2.2]). @c out.width(0) is then * padding (as determined by [22.2.2.2.2]). @c __out.width(0) is then
* called. * called.
* *
* If @a c is of type @c char and the character type of the stream is not * If @a __c is of type @c char and the character type of the stream is not
* @c char, the character is widened before insertion. * @c char, the character is widened before insertion.
*/ */
template<typename _CharT, typename _Traits> template<typename _CharT, typename _Traits>
@ -477,16 +477,16 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
//@{ //@{
/** /**
* @brief String inserters * @brief String inserters
* @param out An output stream. * @param __out An output stream.
* @param s A character string. * @param __s A character string.
* @return out * @return out
* @pre @a s must be a non-NULL pointer * @pre @a s must be a non-NULL pointer
* *
* Behaves like one of the formatted arithmetic inserters described in * Behaves like one of the formatted arithmetic inserters described in
* std::basic_ostream. After constructing a sentry object with good * std::basic_ostream. After constructing a sentry object with good
* status, this function inserts @c traits::length(s) characters starting * status, this function inserts @c traits::length(__s) characters starting
* at @a s, widened if necessary, followed by any required padding (as * at @a __s, widened if necessary, followed by any required padding (as
* determined by [22.2.2.2.2]). @c out.width(0) is then called. * determined by [22.2.2.2.2]). @c __out.width(0) is then called.
*/ */
template<typename _CharT, typename _Traits> template<typename _CharT, typename _Traits>
inline basic_ostream<_CharT, _Traits>& inline basic_ostream<_CharT, _Traits>&
@ -568,8 +568,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// [27.7.2.9] Rvalue stream insertion // [27.7.2.9] Rvalue stream insertion
/** /**
* @brief Generic inserter for rvalue stream * @brief Generic inserter for rvalue stream
* @param os An input stream. * @param __os An input stream.
* @param x A reference to the object being inserted. * @param __x A reference to the object being inserted.
* @return os * @return os
* *
* This is just a forwarding function to allow insertion to * This is just a forwarding function to allow insertion to

139
libstdc++-v3/include/std/scoped_allocator
View File

@ -93,72 +93,84 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _OuterAlloc, typename... _InnerAllocs> template<typename _OuterAlloc, typename... _InnerAllocs>
class scoped_allocator_adaptor; class scoped_allocator_adaptor;
template<typename...> struct __inner_type_impl; template<typename...>
struct __inner_type_impl;
template<typename _Outer> template<typename _Outer>
struct __inner_type_impl<_Outer> struct __inner_type_impl<_Outer>
{ {
typedef scoped_allocator_adaptor<_Outer> __type; typedef scoped_allocator_adaptor<_Outer> __type;
__inner_type_impl() = default; __inner_type_impl() = default;
__inner_type_impl(const __inner_type_impl&) = default; __inner_type_impl(const __inner_type_impl&) = default;
__inner_type_impl(__inner_type_impl&&) = default; __inner_type_impl(__inner_type_impl&&) = default;
template<typename _Alloc>
__inner_type_impl(const __inner_type_impl<_Alloc>& __other)
{ }
template<typename _Alloc>
__inner_type_impl(__inner_type_impl<_Alloc>&& __other)
{ }
__type&
_M_get(__type* __p) noexcept { return *__p; }
template<typename _Alloc> const __type&
__inner_type_impl(const __inner_type_impl<_Alloc>& __other) _M_get(const __type* __p) const noexcept { return *__p; }
{ }
tuple<>
_M_tie() const noexcept { return tuple<>(); }
bool
operator==(const __inner_type_impl&) const noexcept
{ return true; }
};
template<typename _Alloc> template<typename _Outer, typename _InnerHead, typename... _InnerTail>
__inner_type_impl(__inner_type_impl<_Alloc>&& __other) struct __inner_type_impl<_Outer, _InnerHead, _InnerTail...>
{ } {
typedef scoped_allocator_adaptor<_InnerHead, _InnerTail...> __type;
__inner_type_impl() = default;
__inner_type_impl(const __inner_type_impl&) = default;
__inner_type_impl(__inner_type_impl&&) = default;
template<typename... _Allocs>
__inner_type_impl(const __inner_type_impl<_Allocs...>& __other)
: _M_inner(__other._M_inner) { }
template<typename... _Allocs>
__inner_type_impl(__inner_type_impl<_Allocs...>&& __other)
: _M_inner(std::move(__other._M_inner)) { }
__type& _M_get(__type* __p) noexcept { return *__p; } template<typename... _Args>
const __type& _M_get(const __type* __p) const noexcept { return *__p; } explicit
__inner_type_impl(_Args&&... __args)
: _M_inner(std::forward<_Args>(__args)...) { }
tuple<> _M_tie() const noexcept { return tuple<>(); } __type&
_M_get(void*) noexcept { return _M_inner; }
bool operator==(const __inner_type_impl&) const noexcept
{ return true; } const __type&
}; _M_get(const void*) const noexcept { return _M_inner; }
template<typename _Outer, typename _InnerHead, typename... _InnerTail> tuple<const _InnerHead&, const _InnerTail&...>
struct __inner_type_impl<_Outer, _InnerHead, _InnerTail...> _M_tie() const noexcept
{ { return _M_inner._M_tie(); }
typedef scoped_allocator_adaptor<_InnerHead, _InnerTail...> __type;
bool
__inner_type_impl() = default; operator==(const __inner_type_impl& __other) const noexcept
__inner_type_impl(const __inner_type_impl&) = default; { return _M_inner == __other._M_inner; }
__inner_type_impl(__inner_type_impl&&) = default;
private:
template<typename... _Allocs> template<typename...> friend class __inner_type_impl;
__inner_type_impl(const __inner_type_impl<_Allocs...>& __other) template<typename, typename...> friend class scoped_allocator_adaptor;
: _M_inner(__other._M_inner) { }
__type _M_inner;
template<typename... _Allocs> };
__inner_type_impl(__inner_type_impl<_Allocs...>&& __other)
: _M_inner(std::move(__other._M_inner)) { }
template<typename... _Args>
explicit
__inner_type_impl(_Args&&... __args)
: _M_inner(std::forward<_Args>(__args)...) { }
__type& _M_get(void*) noexcept { return _M_inner; }
const __type& _M_get(const void*) const noexcept { return _M_inner; }
tuple<const _InnerHead&, const _InnerTail&...> _M_tie() const noexcept
{ return _M_inner._M_tie(); }
bool operator==(const __inner_type_impl& __other) const noexcept
{ return _M_inner == __other._M_inner; }
private:
template<typename...> friend class __inner_type_impl;
template<typename, typename...> friend class scoped_allocator_adaptor;
__type _M_inner;
};
/// Primary class template.
template<typename _OuterAlloc, typename... _InnerAllocs> template<typename _OuterAlloc, typename... _InnerAllocs>
class scoped_allocator_adaptor class scoped_allocator_adaptor
: public _OuterAlloc : public _OuterAlloc
@ -180,7 +192,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
template<typename _Tp, typename... _Args> template<typename _Tp, typename... _Args>
void _M_construct(__uses_alloc0, _Tp* __p, _Args&&... __args) void
_M_construct(__uses_alloc0, _Tp* __p, _Args&&... __args)
{ {
auto& __outer = __outermost(*this); auto& __outer = __outermost(*this);
typedef typename std::decay<decltype(__outer)>::type __outer_type; typedef typename std::decay<decltype(__outer)>::type __outer_type;
@ -192,7 +205,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
typedef __uses_alloc2<typename __inner_type::__type> __uses_alloc2_; typedef __uses_alloc2<typename __inner_type::__type> __uses_alloc2_;
template<typename _Tp, typename... _Args> template<typename _Tp, typename... _Args>
void _M_construct(__uses_alloc1_, _Tp* __p, _Args&&... __args) void
_M_construct(__uses_alloc1_, _Tp* __p, _Args&&... __args)
{ {
auto& __outer = __outermost(*this); auto& __outer = __outermost(*this);
typedef typename std::decay<decltype(__outer)>::type __outer_type; typedef typename std::decay<decltype(__outer)>::type __outer_type;
@ -202,7 +216,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
} }
template<typename _Tp, typename... _Args> template<typename _Tp, typename... _Args>
void _M_construct(__uses_alloc2_, _Tp* __p, _Args&&... __args) void
_M_construct(__uses_alloc2_, _Tp* __p, _Args&&... __args)
{ {
auto& __outer = __outermost(*this); auto& __outer = __outermost(*this);
typedef typename std::decay<decltype(__outer)>::type __outer_type; typedef typename std::decay<decltype(__outer)>::type __outer_type;

51
libstdc++-v3/include/std/sstream
View File

@ -85,7 +85,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// Constructors: // Constructors:
/** /**
* @brief Starts with an empty string buffer. * @brief Starts with an empty string buffer.
* @param mode Whether the buffer can read, or write, or both. * @param __mode Whether the buffer can read, or write, or both.
* *
* The default constructor initializes the parent class using its * The default constructor initializes the parent class using its
* own default ctor. * own default ctor.
@ -97,8 +97,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Starts with an existing string buffer. * @brief Starts with an existing string buffer.
* @param str A string to copy as a starting buffer. * @param __str A string to copy as a starting buffer.
* @param mode Whether the buffer can read, or write, or both. * @param __mode Whether the buffer can read, or write, or both.
* *
* This constructor initializes the parent class using its * This constructor initializes the parent class using its
* own default ctor. * own default ctor.
@ -137,7 +137,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Setting a new buffer. * @brief Setting a new buffer.
* @param s The string to use as a new sequence. * @param __s The string to use as a new sequence.
* *
* Deallocates any previous stored sequence, then copies @a s to * Deallocates any previous stored sequence, then copies @a s to
* use as a new one. * use as a new one.
@ -185,12 +185,12 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Manipulates the buffer. * @brief Manipulates the buffer.
* @param s Pointer to a buffer area. * @param __s Pointer to a buffer area.
* @param n Size of @a s. * @param __n Size of @a __s.
* @return @c this * @return @c this
* *
* If no buffer has already been created, and both @a s and @a n are * If no buffer has already been created, and both @a __s and @a __n are
* non-zero, then @c s is used as a buffer; see * non-zero, then @c __s is used as a buffer; see
* http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch25s02.html * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch25s02.html
* for more. * for more.
*/ */
@ -285,11 +285,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// Constructors: // Constructors:
/** /**
* @brief Default constructor starts with an empty string buffer. * @brief Default constructor starts with an empty string buffer.
* @param mode Whether the buffer can read, or write, or both. * @param __mode Whether the buffer can read, or write, or both.
* *
* @c ios_base::in is automatically included in @a mode. * @c ios_base::in is automatically included in @a __mode.
* *
* Initializes @c sb using @c mode|in, and passes @c &sb to the base * Initializes @c sb using @c __mode|in, and passes @c &sb to the base
* class initializer. Does not allocate any buffer. * class initializer. Does not allocate any buffer.
* *
* That's a lie. We initialize the base class with NULL, because the * That's a lie. We initialize the base class with NULL, because the
@ -302,8 +302,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Starts with an existing string buffer. * @brief Starts with an existing string buffer.
* @param str A string to copy as a starting buffer. * @param __str A string to copy as a starting buffer.
* @param mode Whether the buffer can read, or write, or both. * @param __mode Whether the buffer can read, or write, or both.
* *
* @c ios_base::in is automatically included in @a mode. * @c ios_base::in is automatically included in @a mode.
* *
@ -349,7 +349,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Setting a new buffer. * @brief Setting a new buffer.
* @param s The string to use as a new sequence. * @param __s The string to use as a new sequence.
* *
* Calls @c rdbuf()->str(s). * Calls @c rdbuf()->str(s).
*/ */
@ -395,7 +395,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// Constructors/destructor: // Constructors/destructor:
/** /**
* @brief Default constructor starts with an empty string buffer. * @brief Default constructor starts with an empty string buffer.
* @param mode Whether the buffer can read, or write, or both. * @param __mode Whether the buffer can read, or write, or both.
* *
* @c ios_base::out is automatically included in @a mode. * @c ios_base::out is automatically included in @a mode.
* *
@ -412,8 +412,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Starts with an existing string buffer. * @brief Starts with an existing string buffer.
* @param str A string to copy as a starting buffer. * @param __str A string to copy as a starting buffer.
* @param mode Whether the buffer can read, or write, or both. * @param __mode Whether the buffer can read, or write, or both.
* *
* @c ios_base::out is automatically included in @a mode. * @c ios_base::out is automatically included in @a mode.
* *
@ -459,7 +459,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Setting a new buffer. * @brief Setting a new buffer.
* @param s The string to use as a new sequence. * @param __s The string to use as a new sequence.
* *
* Calls @c rdbuf()->str(s). * Calls @c rdbuf()->str(s).
*/ */
@ -505,10 +505,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// Constructors/destructors // Constructors/destructors
/** /**
* @brief Default constructor starts with an empty string buffer. * @brief Default constructor starts with an empty string buffer.
* @param mode Whether the buffer can read, or write, or both. * @param __m Whether the buffer can read, or write, or both.
* *
* Initializes @c sb using @c mode, and passes @c &sb to the base * Initializes @c sb using the mode from @c __m, and passes @c
* class initializer. Does not allocate any buffer. * &sb to the base class initializer. Does not allocate any
* buffer.
* *
* That's a lie. We initialize the base class with NULL, because the * That's a lie. We initialize the base class with NULL, because the
* string class does its own memory management. * string class does its own memory management.
@ -520,10 +521,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Starts with an existing string buffer. * @brief Starts with an existing string buffer.
* @param str A string to copy as a starting buffer. * @param __str A string to copy as a starting buffer.
* @param mode Whether the buffer can read, or write, or both. * @param __m Whether the buffer can read, or write, or both.
* *
* Initializes @c sb using @a str and @c mode, and passes @c &sb * Initializes @c sb using @a __str and @c __m, and passes @c &sb
* to the base class initializer. * to the base class initializer.
* *
* That's a lie. We initialize the base class with NULL, because the * That's a lie. We initialize the base class with NULL, because the
@ -565,7 +566,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Setting a new buffer. * @brief Setting a new buffer.
* @param s The string to use as a new sequence. * @param __s The string to use as a new sequence.
* *
* Calls @c rdbuf()->str(s). * Calls @c rdbuf()->str(s).
*/ */

108
libstdc++-v3/include/std/streambuf
View File

@ -198,13 +198,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// [27.5.2.2.1] locales // [27.5.2.2.1] locales
/** /**
* @brief Entry point for imbue(). * @brief Entry point for imbue().
* @param loc The new locale. * @param __loc The new locale.
* @return The previous locale. * @return The previous locale.
* *
* Calls the derived imbue(loc). * Calls the derived imbue(__loc).
*/ */
locale locale
pubimbue(const locale &__loc) pubimbue(const locale& __loc)
{ {
locale __tmp(this->getloc()); locale __tmp(this->getloc());
this->imbue(__loc); this->imbue(__loc);
@ -237,16 +237,34 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
pubsetbuf(char_type* __s, streamsize __n) pubsetbuf(char_type* __s, streamsize __n)
{ return this->setbuf(__s, __n); } { return this->setbuf(__s, __n); }
/**
* @brief Alters the stream position.
* @param __off Offset.
* @param __way Value for ios_base::seekdir.
* @param __mode Value for ios_base::openmode.
*
* Calls virtual seekoff function.
*/
pos_type pos_type
pubseekoff(off_type __off, ios_base::seekdir __way, pubseekoff(off_type __off, ios_base::seekdir __way,
ios_base::openmode __mode = ios_base::in | ios_base::out) ios_base::openmode __mode = ios_base::in | ios_base::out)
{ return this->seekoff(__off, __way, __mode); } { return this->seekoff(__off, __way, __mode); }
/**
* @brief Alters the stream position.
* @param __sp Position
* @param __mode Value for ios_base::openmode.
*
* Calls virtual seekpos function.
*/
pos_type pos_type
pubseekpos(pos_type __sp, pubseekpos(pos_type __sp,
ios_base::openmode __mode = ios_base::in | ios_base::out) ios_base::openmode __mode = ios_base::in | ios_base::out)
{ return this->seekpos(__sp, __mode); } { return this->seekpos(__sp, __mode); }
/**
* @brief Calls virtual sync function.
*/
int int
pubsync() { return this->sync(); } pubsync() { return this->sync(); }
//@} //@}
@ -327,11 +345,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Entry point for xsgetn. * @brief Entry point for xsgetn.
* @param s A buffer area. * @param __s A buffer area.
* @param n A count. * @param __n A count.
* *
* Returns xsgetn(s,n). The effect is to fill @a s[0] through * Returns xsgetn(__s,__n). The effect is to fill @a __s[0] through
* @a s[n-1] with characters from the input sequence, if possible. * @a __s[__n-1] with characters from the input sequence, if possible.
*/ */
streamsize streamsize
sgetn(char_type* __s, streamsize __n) sgetn(char_type* __s, streamsize __n)
@ -340,13 +358,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// [27.5.2.2.4] putback // [27.5.2.2.4] putback
/** /**
* @brief Pushing characters back into the input stream. * @brief Pushing characters back into the input stream.
* @param c The character to push back. * @param __c The character to push back.
* @return The previous character, if possible. * @return The previous character, if possible.
* *
* Similar to sungetc(), but @a c is pushed onto the stream * Similar to sungetc(), but @a __c is pushed onto the stream
* instead of <em>the previous character.</em> If successful, * instead of <em>the previous character.</em> If successful,
* the next character fetched from the input stream will be @a * the next character fetched from the input stream will be @a
* c. * __c.
*/ */
int_type int_type
sputbackc(char_type __c) sputbackc(char_type __c)
@ -390,15 +408,15 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// [27.5.2.2.5] put area // [27.5.2.2.5] put area
/** /**
* @brief Entry point for all single-character output functions. * @brief Entry point for all single-character output functions.
* @param c A character to output. * @param __c A character to output.
* @return @a c, if possible. * @return @a __c, if possible.
* *
* One of two public output functions. * One of two public output functions.
* *
* If a write position is available for the output sequence (i.e., * If a write position is available for the output sequence (i.e.,
* the buffer is not full), stores @a c in that position, increments * the buffer is not full), stores @a __c in that position, increments
* the position, and returns @c traits::to_int_type(c). If a write * the position, and returns @c traits::to_int_type(__c). If a write
* position is not available, returns @c overflow(c). * position is not available, returns @c overflow(__c).
*/ */
int_type int_type
sputc(char_type __c) sputc(char_type __c)
@ -417,14 +435,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Entry point for all single-character output functions. * @brief Entry point for all single-character output functions.
* @param s A buffer read area. * @param __s A buffer read area.
* @param n A count. * @param __n A count.
* *
* One of two public output functions. * One of two public output functions.
* *
* *
* Returns xsputn(s,n). The effect is to write @a s[0] through * Returns xsputn(__s,__n). The effect is to write @a __s[0] through
* @a s[n-1] to the output sequence, if possible. * @a __s[__n-1] to the output sequence, if possible.
*/ */
streamsize streamsize
sputn(const char_type* __s, streamsize __n) sputn(const char_type* __s, streamsize __n)
@ -470,7 +488,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Moving the read position. * @brief Moving the read position.
* @param n The delta by which to move. * @param __n The delta by which to move.
* *
* This just advances the read position without returning any data. * This just advances the read position without returning any data.
*/ */
@ -479,11 +497,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Setting the three read area pointers. * @brief Setting the three read area pointers.
* @param gbeg A pointer. * @param __gbeg A pointer.
* @param gnext A pointer. * @param __gnext A pointer.
* @param gend A pointer. * @param __gend A pointer.
* @post @a gbeg == @c eback(), @a gnext == @c gptr(), and * @post @a __gbeg == @c eback(), @a __gnext == @c gptr(), and
* @a gend == @c egptr() * @a __gend == @c egptr()
*/ */
void void
setg(char_type* __gbeg, char_type* __gnext, char_type* __gend) setg(char_type* __gbeg, char_type* __gnext, char_type* __gend)
@ -517,7 +535,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Moving the write position. * @brief Moving the write position.
* @param n The delta by which to move. * @param __n The delta by which to move.
* *
* This just advances the write position without returning any data. * This just advances the write position without returning any data.
*/ */
@ -526,10 +544,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Setting the three write area pointers. * @brief Setting the three write area pointers.
* @param pbeg A pointer. * @param __pbeg A pointer.
* @param pend A pointer. * @param __pend A pointer.
* @post @a pbeg == @c pbase(), @a pbeg == @c pptr(), and * @post @a __pbeg == @c pbase(), @a __pbeg == @c pptr(), and
* @a pend == @c epptr() * @a __pend == @c epptr()
*/ */
void void
setp(char_type* __pbeg, char_type* __pend) setp(char_type* __pbeg, char_type* __pend)
@ -542,7 +560,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// [27.5.2.4.1] locales // [27.5.2.4.1] locales
/** /**
* @brief Changes translations. * @brief Changes translations.
* @param loc A new locale. * @param __loc A new locale.
* *
* Translations done during I/O which depend on the current * Translations done during I/O which depend on the current
* locale are changed by this call. The standard adds, * locale are changed by this call. The standard adds,
@ -553,7 +571,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* @note Base class version does nothing. * @note Base class version does nothing.
*/ */
virtual void virtual void
imbue(const locale&) imbue(const locale& __loc)
{ } { }
// [27.5.2.4.2] buffer management and positioning // [27.5.2.4.2] buffer management and positioning
@ -630,12 +648,12 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Multiple character extraction. * @brief Multiple character extraction.
* @param s A buffer area. * @param __s A buffer area.
* @param n Maximum number of characters to assign. * @param __n Maximum number of characters to assign.
* @return The number of characters assigned. * @return The number of characters assigned.
* *
* Fills @a s[0] through @a s[n-1] with characters from the input * Fills @a __s[0] through @a __s[__n-1] with characters from the input
* sequence, as if by @c sbumpc(). Stops when either @a n characters * sequence, as if by @c sbumpc(). Stops when either @a __n characters
* have been copied, or when @c traits::eof() would be copied. * have been copied, or when @c traits::eof() would be copied.
* *
* It is expected that derived classes provide a more efficient * It is expected that derived classes provide a more efficient
@ -693,7 +711,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
// [27.5.2.4.4] putback // [27.5.2.4.4] putback
/** /**
* @brief Tries to back up the input sequence. * @brief Tries to back up the input sequence.
* @param c The character to be inserted back into the sequence. * @param __c The character to be inserted back into the sequence.
* @return eof() on failure, <em>some other value</em> on success * @return eof() on failure, <em>some other value</em> on success
* @post The constraints of @c gptr(), @c eback(), and @c pptr() * @post The constraints of @c gptr(), @c eback(), and @c pptr()
* are the same as for @c underflow(). * are the same as for @c underflow().
@ -701,17 +719,17 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* @note Base class version does nothing, returns eof(). * @note Base class version does nothing, returns eof().
*/ */
virtual int_type virtual int_type
pbackfail(int_type /* __c */ = traits_type::eof()) pbackfail(int_type __c = traits_type::eof())
{ return traits_type::eof(); } { return traits_type::eof(); }
// Put area: // Put area:
/** /**
* @brief Multiple character insertion. * @brief Multiple character insertion.
* @param s A buffer area. * @param __s A buffer area.
* @param n Maximum number of characters to write. * @param __n Maximum number of characters to write.
* @return The number of characters written. * @return The number of characters written.
* *
* Writes @a s[0] through @a s[n-1] to the output sequence, as if * Writes @a __s[0] through @a __s[__n-1] to the output sequence, as if
* by @c sputc(). Stops when either @a n characters have been * by @c sputc(). Stops when either @a n characters have been
* copied, or when @c sputc() would return @c traits::eof(). * copied, or when @c sputc() would return @c traits::eof().
* *
@ -724,9 +742,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* @brief Consumes data from the buffer; writes to the * @brief Consumes data from the buffer; writes to the
* controlled sequence. * controlled sequence.
* @param c An additional character to consume. * @param __c An additional character to consume.
* @return eof() to indicate failure, something else (usually * @return eof() to indicate failure, something else (usually
* @a c, or not_eof()) * @a __c, or not_eof())
* *
* Informally, this function is called when the output buffer * Informally, this function is called when the output buffer
* is full (or does not exist, as buffering need not actually * is full (or does not exist, as buffering need not actually
@ -734,7 +752,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* <em>some effect</em> on the controlled sequence. * <em>some effect</em> on the controlled sequence.
* (Typically, the buffer is written out to the sequence * (Typically, the buffer is written out to the sequence
* verbatim.) In either case, the character @a c is also * verbatim.) In either case, the character @a c is also
* written out, if @a c is not @c eof(). * written out, if @a __c is not @c eof().
* *
* For a formal definition of this function, see a good text * For a formal definition of this function, see a good text
* such as Langer & Kreft, or [27.5.2.4.5]/3-7. * such as Langer & Kreft, or [27.5.2.4.5]/3-7.
@ -745,7 +763,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* @note Base class version does nothing, returns eof(). * @note Base class version does nothing, returns eof().
*/ */
virtual int_type virtual int_type
overflow(int_type /* __c */ = traits_type::eof()) overflow(int_type __c = traits_type::eof())
{ return traits_type::eof(); } { return traits_type::eof(); }
#if _GLIBCXX_USE_DEPRECATED #if _GLIBCXX_USE_DEPRECATED

110
libstdc++-v3/include/std/valarray
View File

@ -110,7 +110,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* one-dimensional array from which different multidimensional subsets can * one-dimensional array from which different multidimensional subsets can
* be accessed and modified. * be accessed and modified.
* *
* @param Tp Type of object in the array. * @tparam _Tp Type of object in the array.
*/ */
template<class _Tp> template<class _Tp>
class valarray class valarray
@ -173,9 +173,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* Assign elements of array to values in @a v. * Assign elements of array to values in @a v.
* *
* @param v Valarray to get values from. * @param __v Valarray to get values from.
*/ */
valarray<_Tp>& operator=(const valarray<_Tp>&); valarray<_Tp>& operator=(const valarray<_Tp>& __v);
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
@ -183,9 +183,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* Move assign elements of array to values in @a v. * Move assign elements of array to values in @a v.
* *
* @param v Valarray to get values from. * @param __v Valarray to get values from.
*/ */
valarray<_Tp>& operator=(valarray<_Tp>&&) noexcept; valarray<_Tp>& operator=(valarray<_Tp>&& __v) noexcept;
#endif #endif
/** /**
@ -193,9 +193,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* *
* Assign all elements of array to @a t. * Assign all elements of array to @a t.
* *
* @param t Value for elements. * @param __t Value for elements.
*/ */
valarray<_Tp>& operator=(const _Tp&); valarray<_Tp>& operator=(const _Tp& __t);
/** /**
* @brief Assign elements to an array subset. * @brief Assign elements to an array subset.
@ -203,9 +203,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* Assign elements of array to values in @a sa. Results are undefined * Assign elements of array to values in @a sa. Results are undefined
* if @a sa does not have the same size as this array. * if @a sa does not have the same size as this array.
* *
* @param sa Array slice to get values from. * @param __sa Array slice to get values from.
*/ */
valarray<_Tp>& operator=(const slice_array<_Tp>&); valarray<_Tp>& operator=(const slice_array<_Tp>& __sa);
/** /**
* @brief Assign elements to an array subset. * @brief Assign elements to an array subset.
@ -213,9 +213,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* Assign elements of array to values in @a ga. Results are undefined * Assign elements of array to values in @a ga. Results are undefined
* if @a ga does not have the same size as this array. * if @a ga does not have the same size as this array.
* *
* @param ga Array slice to get values from. * @param __ga Array slice to get values from.
*/ */
valarray<_Tp>& operator=(const gslice_array<_Tp>&); valarray<_Tp>& operator=(const gslice_array<_Tp>& __ga);
/** /**
* @brief Assign elements to an array subset. * @brief Assign elements to an array subset.
@ -223,9 +223,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* Assign elements of array to values in @a ma. Results are undefined * Assign elements of array to values in @a ma. Results are undefined
* if @a ma does not have the same size as this array. * if @a ma does not have the same size as this array.
* *
* @param ma Array slice to get values from. * @param __ma Array slice to get values from.
*/ */
valarray<_Tp>& operator=(const mask_array<_Tp>&); valarray<_Tp>& operator=(const mask_array<_Tp>& __ma);
/** /**
* @brief Assign elements to an array subset. * @brief Assign elements to an array subset.
@ -233,20 +233,20 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* Assign elements of array to values in @a ia. Results are undefined * Assign elements of array to values in @a ia. Results are undefined
* if @a ia does not have the same size as this array. * if @a ia does not have the same size as this array.
* *
* @param ia Array slice to get values from. * @param __ia Array slice to get values from.
*/ */
valarray<_Tp>& operator=(const indirect_array<_Tp>&); valarray<_Tp>& operator=(const indirect_array<_Tp>& __ia);
#ifdef __GXX_EXPERIMENTAL_CXX0X__ #ifdef __GXX_EXPERIMENTAL_CXX0X__
/** /**
* @brief Assign elements to an initializer_list. * @brief Assign elements to an initializer_list.
* *
* Assign elements of array to values in @a l. Results are undefined * Assign elements of array to values in @a __l. Results are undefined
* if @a l does not have the same size as this array. * if @a __l does not have the same size as this array.
* *
* @param l initializer_list to get values from. * @param __l initializer_list to get values from.
*/ */
valarray& operator=(initializer_list<_Tp>); valarray& operator=(initializer_list<_Tp> __l);
#endif #endif
template<class _Dom> valarray<_Tp>& template<class _Dom> valarray<_Tp>&
@ -256,10 +256,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
/** /**
* Return a reference to the i'th array element. * Return a reference to the i'th array element.
* *
* @param i Index of element to return. * @param __i Index of element to return.
* @return Reference to the i'th element. * @return Reference to the i'th element.
*/ */
_Tp& operator[](size_t); _Tp& operator[](size_t __i);
// _GLIBCXX_RESOLVE_LIB_DEFECTS // _GLIBCXX_RESOLVE_LIB_DEFECTS
// 389. Const overload of valarray::operator[] returns by value. // 389. Const overload of valarray::operator[] returns by value.
@ -273,10 +273,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* indicated by the slice argument. The new valarray has the same size * indicated by the slice argument. The new valarray has the same size
* as the input slice. @see slice. * as the input slice. @see slice.
* *
* @param s The source slice. * @param __s The source slice.
* @return New valarray containing elements in @a s. * @return New valarray containing elements in @a __s.
*/ */
_Expr<_SClos<_ValArray, _Tp>, _Tp> operator[](slice) const; _Expr<_SClos<_ValArray, _Tp>, _Tp> operator[](slice __s) const;
/** /**
* @brief Return a reference to an array subset. * @brief Return a reference to an array subset.
@ -285,10 +285,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* indicated by the slice argument. The new valarray has the same size * indicated by the slice argument. The new valarray has the same size
* as the input slice. @see slice. * as the input slice. @see slice.
* *
* @param s The source slice. * @param __s The source slice.
* @return New valarray containing elements in @a s. * @return New valarray containing elements in @a __s.
*/ */
slice_array<_Tp> operator[](slice); slice_array<_Tp> operator[](slice __s);
/** /**
* @brief Return an array subset. * @brief Return an array subset.
@ -296,10 +296,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* Returns a slice_array referencing the elements of the array * Returns a slice_array referencing the elements of the array
* indicated by the slice argument. @see gslice. * indicated by the slice argument. @see gslice.
* *
* @param s The source slice. * @param __s The source slice.
* @return Slice_array referencing elements indicated by @a s. * @return Slice_array referencing elements indicated by @a __s.
*/ */
_Expr<_GClos<_ValArray, _Tp>, _Tp> operator[](const gslice&) const; _Expr<_GClos<_ValArray, _Tp>, _Tp> operator[](const gslice& __s) const;
/** /**
* @brief Return a reference to an array subset. * @brief Return a reference to an array subset.
@ -308,10 +308,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* indicated by the gslice argument. The new valarray has * indicated by the gslice argument. The new valarray has
* the same size as the input gslice. @see gslice. * the same size as the input gslice. @see gslice.
* *
* @param s The source gslice. * @param __s The source gslice.
* @return New valarray containing elements in @a s. * @return New valarray containing elements in @a __s.
*/ */
gslice_array<_Tp> operator[](const gslice&); gslice_array<_Tp> operator[](const gslice& __s);
/** /**
* @brief Return an array subset. * @brief Return an array subset.
@ -322,10 +322,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* the new valarray. Each element of the array is added to the return * the new valarray. Each element of the array is added to the return
* valarray if the corresponding element of the argument is true. * valarray if the corresponding element of the argument is true.
* *
* @param m The valarray bitmask. * @param __m The valarray bitmask.
* @return New valarray containing elements indicated by @a m. * @return New valarray containing elements indicated by @a __m.
*/ */
valarray<_Tp> operator[](const valarray<bool>&) const; valarray<_Tp> operator[](const valarray<bool>& __m) const;
/** /**
* @brief Return a reference to an array subset. * @brief Return a reference to an array subset.
@ -336,10 +336,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* subset. Elements of the array are part of the subset if the * subset. Elements of the array are part of the subset if the
* corresponding element of the argument is true. * corresponding element of the argument is true.
* *
* @param m The valarray bitmask. * @param __m The valarray bitmask.
* @return New valarray containing elements indicated by @a m. * @return New valarray containing elements indicated by @a __m.
*/ */
mask_array<_Tp> operator[](const valarray<bool>&); mask_array<_Tp> operator[](const valarray<bool>& __m);
/** /**
* @brief Return an array subset. * @brief Return an array subset.
@ -349,11 +349,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* interpreted as the indices of elements of this valarray to copy to * interpreted as the indices of elements of this valarray to copy to
* the return valarray. * the return valarray.
* *
* @param i The valarray element index list. * @param __i The valarray element index list.
* @return New valarray containing elements in @a s. * @return New valarray containing elements in @a __s.
*/ */
_Expr<_IClos<_ValArray, _Tp>, _Tp> _Expr<_IClos<_ValArray, _Tp>, _Tp>
operator[](const valarray<size_t>&) const; operator[](const valarray<size_t>& __i) const;
/** /**
* @brief Return a reference to an array subset. * @brief Return a reference to an array subset.
@ -364,10 +364,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* in the subset. The returned indirect_array refers to these * in the subset. The returned indirect_array refers to these
* elements. * elements.
* *
* @param i The valarray element index list. * @param __i The valarray element index list.
* @return Indirect_array referencing elements in @a i. * @return Indirect_array referencing elements in @a __i.
*/ */
indirect_array<_Tp> operator[](const valarray<size_t>&); indirect_array<_Tp> operator[](const valarray<size_t>& __i);
// _lib.valarray.unary_ unary operators: // _lib.valarray.unary_ unary operators:
/// Return a new valarray by applying unary + to each element. /// Return a new valarray by applying unary + to each element.
@ -499,10 +499,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* Positive arguments shift toward index 0, discarding elements [0, n). * Positive arguments shift toward index 0, discarding elements [0, n).
* Negative arguments discard elements from the top of the array. * Negative arguments discard elements from the top of the array.
* *
* @param n Number of element positions to shift. * @param __n Number of element positions to shift.
* @return New valarray with elements in shifted positions. * @return New valarray with elements in shifted positions.
*/ */
valarray<_Tp> shift (int) const; valarray<_Tp> shift (int __n) const;
/** /**
* @brief Return a rotated array. * @brief Return a rotated array.
@ -516,10 +516,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* Positive arguments shift toward index 0, wrapping around the top. * Positive arguments shift toward index 0, wrapping around the top.
* Negative arguments shift towards the top, wrapping around to 0. * Negative arguments shift towards the top, wrapping around to 0.
* *
* @param n Number of element positions to rotate. * @param __n Number of element positions to rotate.
* @return New valarray with elements in shifted positions. * @return New valarray with elements in shifted positions.
*/ */
valarray<_Tp> cshift(int) const; valarray<_Tp> cshift(int __n) const;
/** /**
* @brief Apply a function to the array. * @brief Apply a function to the array.
@ -551,8 +551,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
* Resize this array to @a size and set all elements to @a c. All * Resize this array to @a size and set all elements to @a c. All
* references and iterators are invalidated. * references and iterators are invalidated.
* *
* @param size New array size. * @param __size New array size.
* @param c New value for all elements. * @param __c New value for all elements.
*/ */
void resize(size_t __size, _Tp __c = _Tp()); void resize(size_t __size, _Tp __c = _Tp());
@ -1176,7 +1176,7 @@ _DEFINE_BINARY_OPERATOR(>=, __greater_equal)
/** /**
* @brief Return an iterator pointing to the first element of * @brief Return an iterator pointing to the first element of
* the valarray. * the valarray.
* @param va valarray. * @param __va valarray.
*/ */
template<class _Tp> template<class _Tp>
inline _Tp* inline _Tp*
@ -1186,7 +1186,7 @@ _DEFINE_BINARY_OPERATOR(>=, __greater_equal)
/** /**
* @brief Return an iterator pointing to the first element of * @brief Return an iterator pointing to the first element of
* the const valarray. * the const valarray.
* @param va valarray. * @param __va valarray.
*/ */
template<class _Tp> template<class _Tp>
inline const _Tp* inline const _Tp*
@ -1196,7 +1196,7 @@ _DEFINE_BINARY_OPERATOR(>=, __greater_equal)
/** /**
* @brief Return an iterator pointing to one past the last element of * @brief Return an iterator pointing to one past the last element of
* the valarray. * the valarray.
* @param va valarray. * @param __va valarray.
*/ */
template<class _Tp> template<class _Tp>
inline _Tp* inline _Tp*
@ -1206,7 +1206,7 @@ _DEFINE_BINARY_OPERATOR(>=, __greater_equal)
/** /**
* @brief Return an iterator pointing to one past the last element of * @brief Return an iterator pointing to one past the last element of
* the const valarray. * the const valarray.
* @param va valarray. * @param __va valarray.
*/ */
template<class _Tp> template<class _Tp>
inline const _Tp* inline const _Tp*

4
libstdc++-v3/libsupc++/initializer_list
View File

@ -80,7 +80,7 @@ namespace std
/** /**
* @brief Return an iterator pointing to the first element of * @brief Return an iterator pointing to the first element of
* the initilizer_list. * the initilizer_list.
* @param il Initializer list. * @param __ils Initializer list.
*/ */
template<class _Tp> template<class _Tp>
constexpr const _Tp* constexpr const _Tp*
@ -90,7 +90,7 @@ namespace std
/** /**
* @brief Return an iterator pointing to one past the last element * @brief Return an iterator pointing to one past the last element
* of the initilizer_list. * of the initilizer_list.
* @param il Initializer list. * @param __ils Initializer list.
*/ */
template<class _Tp> template<class _Tp>
constexpr const _Tp* constexpr const _Tp*

2
libstdc++-v3/testsuite/23_containers/list/requirements/dr438/assign_neg.cc
View File

@ -18,7 +18,7 @@
// <http://www.gnu.org/licenses/>. // <http://www.gnu.org/licenses/>.
// { dg-do compile } // { dg-do compile }
// { dg-error "no matching" "" { target *-*-* } 1497 } // { dg-error "no matching" "" { target *-*-* } 1498 }
#include <list> #include <list>

2
libstdc++-v3/testsuite/23_containers/list/requirements/dr438/constructor_1_neg.cc
View File

@ -18,7 +18,7 @@
// <http://www.gnu.org/licenses/>. // <http://www.gnu.org/licenses/>.
// { dg-do compile } // { dg-do compile }
// { dg-error "no matching" "" { target *-*-* } 1453 } // { dg-error "no matching" "" { target *-*-* } 1454 }
#include <list> #include <list>

2
libstdc++-v3/testsuite/23_containers/list/requirements/dr438/constructor_2_neg.cc
View File

@ -18,7 +18,7 @@
// <http://www.gnu.org/licenses/>. // <http://www.gnu.org/licenses/>.
// { dg-do compile } // { dg-do compile }
// { dg-error "no matching" "" { target *-*-* } 1453 } // { dg-error "no matching" "" { target *-*-* } 1454 }
#include <list> #include <list>
#include <utility> #include <utility>

2
libstdc++-v3/testsuite/23_containers/list/requirements/dr438/insert_neg.cc
View File

@ -18,7 +18,7 @@
// <http://www.gnu.org/licenses/>. // <http://www.gnu.org/licenses/>.
// { dg-do compile } // { dg-do compile }
// { dg-error "no matching" "" { target *-*-* } 1453 } // { dg-error "no matching" "" { target *-*-* } 1454 }
#include <list> #include <list>