Standard library header <ostream>
From cppreference.net
Cet en-tête fait partie de la bibliothèque d'entrée/sortie .
Classes |
||
|
encapsule un dispositif abstrait donné (
std::basic_streambuf
)
et fournit une interface de sortie de haut niveau (modèle de classe) |
||
| std::ostream |
std::
basic_ostream
<
char
>
(typedef) |
|
| std::wostream |
std::
basic_ostream
<
wchar_t
>
(typedef) |
|
Fonctions |
||
|
insère des données de caractères ou insère dans un flux de rvalue
(modèle de fonction) |
||
|
(C++23)
|
affiche une représentation
formatée
des arguments
(modèle de fonction) |
|
|
(C++23)
|
affiche une représentation
formatée
des arguments avec un
'
\n
'
ajouté
(modèle de fonction) |
|
|
(C++23)
|
effectue une sortie prenant en compte Unicode en utilisant une représentation
à effacement de type
des arguments
(fonction) |
|
|
(C++23)
|
affiche des données de caractères en utilisant une représentation
à effacement de type
des arguments
(fonction) |
|
Manipulateurs |
||
|
affiche
'
\n
'
et vide le flux de sortie
(modèle de fonction) |
||
|
affiche
'
\0
'
(modèle de fonction) |
||
|
vide le flux de sortie
(modèle de fonction) |
||
|
(C++20)
|
contrôle si un
basic_syncbuf
d'un flux émet lors du vidage
(modèle de fonction) |
|
|
(C++20)
|
vide un flux et émet le contenu s'il utilise un
basic_syncbuf
(modèle de fonction) |
|
Synopsis
namespace std { template<class CharT, class Traits = char_traits<CharT>> class basic_ostream; using ostream = basic_ostream<char>; using wostream = basic_ostream<wchar_t>; template<class CharT, class Traits> basic_ostream<CharT, Traits>& endl(basic_ostream<CharT, Traits>& os); template<class CharT, class Traits> basic_ostream<CharT, Traits>& ends(basic_ostream<CharT, Traits>& os); template<class CharT, class Traits> basic_ostream<CharT, Traits>& flush(basic_ostream<CharT, Traits>& os); template<class CharT, class Traits> basic_ostream<CharT, Traits>& emit_on_flush(basic_ostream<CharT, Traits>& os); template<class CharT, class Traits> basic_ostream<CharT, Traits>& noemit_on_flush(basic_ostream<CharT, Traits>& os); template<class CharT, class Traits> basic_ostream<CharT, Traits>& flush_emit(basic_ostream<CharT, Traits>& os); template<class Ostream, class T> Ostream&& operator<<(Ostream&& os, const T& x); // fonctions d'impression template<class... Args> void print(ostream& os, format_string<Args...> fmt, Args&&... args); template<class... Args> void println(ostream& os, format_string<Args...> fmt, Args&&... args); void println(ostream& os); void vprint_unicode(ostream& os, string_view fmt, format_args args); void vprint_nonunicode(ostream& os, string_view fmt, format_args args); }
Modèle de classe std::basic_ostream
namespace std { template<class CharT, class Traits = char_traits<CharT>> class basic_ostream : virtual public basic_ios<CharT, Traits> { public: // types (hérités de basic_ios) using char_type = CharT; using int_type = typename Traits::int_type; using pos_type = typename Traits::pos_type; using off_type = typename Traits::off_type; using traits_type = Traits; // constructeur/destructeur explicit basic_ostream(basic_streambuf<char_type, Traits>* sb); virtual ~basic_ostream(); // préfixe/suffixe class sentry; // sortie formatée basic_ostream& operator<<(basic_ostream& (*pf)(basic_ostream&)); basic_ostream& operator<<(basic_ios<CharT, Traits>& (*pf)(basic_ios<CharT, Traits>&)); basic_ostream& operator<<(ios_base& (*pf)(ios_base&)); basic_ostream& operator<<(bool n); basic_ostream& operator<<(short n); basic_ostream& operator<<(unsigned short n); basic_ostream& operator<<(int n); basic_ostream& operator<<(unsigned int n); basic_ostream& operator<<(long n); basic_ostream& operator<<(unsigned long n); basic_ostream& operator<<(long long n); basic_ostream& operator<<(unsigned long long n); basic_ostream& operator<<(float f); basic_ostream& operator<<(double f); basic_ostream& operator<<(long double f); basic_ostream& operator<<(/*type à virgule flottante étendu*/ f); basic_ostream& operator<<(const void* p); basic_ostream& operator<<(const volatile void* p); basic_ostream& operator<<(nullptr_t); basic_ostream& operator<<(basic_streambuf<char_type, Traits>* sb); // sortie non formatée basic_ostream& put(char_type c); basic_ostream& write(const char_type* s, streamsize n); basic_ostream& flush(); // cherche pos_type tellp(); basic_ostream& seekp(pos_type); basic_ostream& seekp(off_type, ios_base::seekdir); protected: // constructeur de copie/déplacement basic_ostream(const basic_ostream&) = delete; basic_ostream(basic_ostream&& rhs); // assignation et échange basic_ostream& operator=(const basic_ostream&) = delete; basic_ostream& operator=(basic_ostream&& rhs); void swap(basic_ostream& rhs); }; // insertions de caractères template<class CharT, class Traits> basic_ostream<CharT, Traits>& operator<<(basic_ostream<CharT, Traits>&, CharT); template<class CharT, class Traits> basic_ostream<CharT, Traits>& operator<<(basic_ostream<CharT, Traits>&, char); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, char); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, signed char); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, unsigned char); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, wchar_t) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, char8_t) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, char16_t) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, char32_t) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, char8_t) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, char16_t) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, char32_t) = delete; template<class CharT, class Traits> basic_ostream<CharT, Traits>& operator<<(basic_ostream<CharT, Traits>&, const CharT*); template<class CharT, class Traits> basic_ostream<CharT, Traits>& operator<<(basic_ostream<CharT, Traits>&, const char*); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const char*); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const signed char*); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const unsigned char*); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const wchar_t*) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const char8_t*) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const char16_t*) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const char32_t*) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, const char8_t*) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, const char16_t*) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, const char32_t*) = delete; }
Classe std::basic_ostream::sentry
namespace std { template<class CharT, class Traits> class basic_ostream<CharT, Traits>::sentry { bool ok_; // exposition uniquement public: explicit sentry(basic_ostream& os); ~sentry(); explicit operator bool() const { return ok_; } sentry(const sentry&) = delete; sentry& operator=(const sentry&) = delete; }; }