diff options
Diffstat (limited to 'libstdc++-v3/include/std/istream')
-rw-r--r-- | libstdc++-v3/include/std/istream | 33 |
1 files changed, 18 insertions, 15 deletions
diff --git a/libstdc++-v3/include/std/istream b/libstdc++-v3/include/std/istream index 2d47b0f..f97e1fe 100644 --- a/libstdc++-v3/include/std/istream +++ b/libstdc++-v3/include/std/istream @@ -1,7 +1,7 @@ // Input streams -*- C++ -*- // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, -// 2006, 2007, 2008, 2009 +// 2006, 2007, 2008, 2009, 2010 // Free Software Foundation, Inc. // // This file is part of the GNU ISO C++ Library. This library is free @@ -112,8 +112,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Interface for manipulators. * * Manipulators such as @c std::ws and @c std::dec use these - * functions in constructs like "std::cin >> std::ws". For more - * information, see the iomanip header. + * functions in constructs like + * <code>std::cin >> std::ws</code>. + * For more information, see the iomanip header. */ __istream_type& operator>>(__istream_type& (*__pf)(__istream_type&)) @@ -326,7 +327,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param n Maximum number of characters to store in @a s. * @return *this * - * Returns @c get(s,n,widen('\n')). + * Returns @c get(s,n,widen('\n')). */ __istream_type& get(char_type* __s, streamsize __n) @@ -359,7 +360,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param sb A streambuf in which to store data. * @return *this * - * Returns @c get(sb,widen('\n')). + * Returns @c get(sb,widen('\n')). */ __istream_type& get(__streambuf_type& __sb) @@ -399,7 +400,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param n Maximum number of characters to extract. * @return *this * - * Returns @c getline(s,n,widen('\n')). + * Returns @c getline(s,n,widen('\n')). */ __istream_type& getline(char_type* __s, streamsize __n) @@ -624,9 +625,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @brief Performs setup work for input streams. * * Objects of this class are created before all of the standard - * extractors are run. It is responsible for "exception-safe prefix and - * suffix operations," although only prefix actions are currently required - * by the standard. + * extractors are run. It is responsible for <em>exception-safe + * prefix and suffix operations,</em> although only prefix actions + * are currently required by the standard. */ template<typename _CharT, typename _Traits> class basic_istream<_CharT, _Traits>::sentry @@ -648,8 +649,9 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * @param noskipws Whether to consume whitespace or not. * * If the stream state is good (@a is.good() is true), then the - * following actions are performed, otherwise the sentry state is - * false ("not okay") and failbit is set in the stream state. + * following actions are performed, otherwise the sentry state + * is false (<em>not okay</em>) and failbit is set in the + * stream state. * * The sentry's preparatory actions are: * @@ -661,7 +663,7 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * used to determine whether each character is whitespace. * * If the stream state is still good, then the sentry state becomes - * true ("okay"). + * true (@a okay). */ explicit sentry(basic_istream<_CharT, _Traits>& __is, bool __noskipws = false); @@ -720,9 +722,10 @@ _GLIBCXX_BEGIN_NAMESPACE(std) * status, this function extracts up to @c n characters and stores them * into the array starting at @a s. @c n is defined as: * - * - if @c width() is greater than zero, @c n is width() - * - otherwise @c n is "the number of elements of the largest array of - * @c char_type that can store a terminating @c eos." [27.6.1.2.3]/6 + * - 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 char_type that can store a terminating @c eos.</em> + * - [27.6.1.2.3]/6 * * Characters are extracted and stored until one of the following happens: * - @c n-1 characters are stored |