C++
Manipulateurs de flux
Recherche…
Introduction
Les manipulateurs sont des fonctions d'assistance spéciales qui aident à contrôler les flux d'entrée et de sortie en utilisant l' operator >>
ou l' operator <<
.
Ils peuvent tous être inclus par #include <iomanip>
.
Remarques
Les manipulateurs peuvent être utilisés autrement. Par exemple:
-
os.width(n);
est égal àos << std::setw(n);
is.width(n);
est égal àis >> std::setw(n);
-
os.precision(n);
est égal àos << std::setprecision(n);
is.precision(n);
est égal àis >> std::setprecision(n);
-
os.setfill(c);
est égal àos << std::setfill(c);
-
str >> std::setbase(base);
oustr << std::setbase(base);
est égal à
str.setf(base == 8 ? std::ios_base::oct :
base == 10 ? std::ios_base::dec :
base == 16 ? std::ios_base::hex :
std::ios_base::fmtflags(0),
std::ios_base::basefield);
-
os.setf(std::ios_base::flag);
est égal àos << std::flag;
is.setf(std::ios_base::flag);
est égal àis >> std::flag;
os.unsetf(std::ios_base::flag);
est égal àos << std::no ## flag;
is.unsetf(std::ios_base::flag);
est égal àis >> std::no ## flag;
(où ## - est l' opérateur de concaténation )
pour les prochainsflag
:boolalpha
,showbase
,showpoint
,showpos
,skipws
,uppercase
.
-
std::ios_base::basefield
.
Pour lesflag
:dec
,hex
etoct
:
-
os.setf(std::ios_base::flag, std::ios_base::basefield);
est égal àos << std::flag;
is.setf(std::ios_base::flag, std::ios_base::basefield);
est égal àis >> std::flag;
( 1 ) -
str.unsetf(std::ios_base::flag, std::ios_base::basefield);
est égal àstr.setf(std::ios_base::fmtflags(0), std::ios_base::basefield);
(2)
-
std::ios_base::adjustfield
.
Pour lesflag
:left
,right
etinternal
:
-
os.setf(std::ios_base::flag, std::ios_base::adjustfield);
est égal àos << std::flag;
is.setf(std::ios_base::flag, std::ios_base::adjustfield);
est égal àis >> std::flag;
( 1 ) -
str.unsetf(std::ios_base::flag, std::ios_base::adjustfield);
est égal àstr.setf(std::ios_base::fmtflags(0), std::ios_base::adjustfield);
(2)
(1) Si le drapeau du champ correspondant précédemment défini est déjà unsetf
par unsetf
.
(2) Si le flag
est défini.
-
std::ios_base::floatfield
.
-
os.setf(std::ios_base::flag, std::ios_base::floatfield);
est égal àos << std::flag;
is.setf(std::ios_base::flag, std::ios_base::floatfield);
est égal àis >> std::flag;
pour lesflag
:fixed
etscientific
. -
os.setf(std::ios_base::fmtflags(0), std::ios_base::floatfield);
est égal àos << std::defaultfloat;
is.setf(std::ios_base::fmtflags(0), std::ios_base::floatfield);
est égal àis >> std::defaultfloat;
-
str.setf(std::ios_base::fmtflags(0), std::ios_base::flag);
est égal àstr.unsetf(std::ios_base::flag)
pour lesflag
:basefield
,adjustfield
,floatfield
.
-
os.setf(mask)
est égal àos << setiosflags(mask);
is.setf(mask)
est égal àis >> setiosflags(mask);
os.unsetf(mask)
est égal àos << resetiosflags(mask);
is.unsetf(mask)
est égal àis >> resetiosflags(mask);
Pour presque tous lesmask
de typestd::ios_base::fmtflags
.
Manipulateurs de flux
std::boolalpha
et std::noboolalpha
- bascule entre la représentation textuelle et numérique des booléens.
std::cout << std::boolalpha << 1;
// Output: true
std::cout << std::noboolalpha << false;
// Output: 0
bool boolValue;
std::cin >> std::boolalpha >> boolValue;
std::cout << "Value \"" << std::boolalpha << boolValue
<< "\" was parsed as " << std::noboolalpha << boolValue;
// Input: true
// Output: Value "true" was parsed as 0
std::showbase
et std::noshowbase
- contrôle si le préfixe indiquant la base numérique est utilisé.
std::dec
(decimal), std::hex
(hexadécimal) et std::oct
(octal) - sont utilisés pour changer la base des entiers.
#include <sstream>
std::cout << std::dec << 29 << ' - '
<< std::hex << 29 << ' - '
<< std::showbase << std::oct << 29 << ' - '
<< std::noshowbase << 29 '\n';
int number;
std::istringstream("3B") >> std::hex >> number;
std::cout << std::dec << 10;
// Output: 22 - 1D - 35 - 035
// 59
Les valeurs par défaut sont std::ios_base::noshowbase
et std::ios_base::dec
.
Si vous voulez en savoir plus sur std::istringstream
consultez l'en-tête < sstream >.
std::uppercase
std::nouppercase
et std::nouppercase
- déterminent si les caractères majuscules sont utilisés dans la sortie entière hexadécimale et à virgule flottante. N'a aucun effet sur les flux d'entrée.
std::cout << std::hex << std::showbase
<< "0x2a with nouppercase: " << std::nouppercase << 0x2a << '\n'
<< "1e-10 with uppercase: " << std::uppercase << 1e-10 << '\n'
}
// Output: 0x2a with nouppercase: 0x2a
// 1e-10 with uppercase: 1E-10
La valeur par défaut est std::nouppercase
.
std::setw(n)
- change la largeur du prochain champ d'entrée / sortie en exactement n
.
La propriété de largeur n
est réinitialisée à 0
lorsque certaines fonctions sont appelées (la liste complète est ici ).
std::cout << "no setw:" << 51 << '\n'
<< "setw(7): " << std::setw(7) << 51 << '\n'
<< "setw(7), more output: " << 13
<< std::setw(7) << std::setfill('*') << 67 << ' ' << 94 << '\n';
char* input = "Hello, world!";
char arr[10];
std::cin >> std::setw(6) >> arr;
std::cout << "Input from \"Hello, world!\" with setw(6) gave \"" << arr << "\"\n";
// Output: 51
// setw(7): 51
// setw(7), more output: 13*****67 94
// Input: Hello, world!
// Output: Input from "Hello, world!" with setw(6) gave "Hello"
La valeur par défaut est std::setw(0)
.
std::left
, std::right
et std::internal
- modifie la position par défaut des caractères de remplissage en définissant std::ios_base::adjustfield
sur std::ios_base::left
, std::ios_base::right
et std::ios_base::internal
correspondly. std::left
et std::right
s'appliquent à toutes les sorties, std::internal
- pour les sorties entières, flottantes et monétaires. N'a aucun effet sur les flux d'entrée.
#include <locale>
...
std::cout.imbue(std::locale("en_US.utf8"));
std::cout << std::left << std::showbase << std::setfill('*')
<< "flt: " << std::setw(15) << -9.87 << '\n'
<< "hex: " << std::setw(15) << 41 << '\n'
<< " $: " << std::setw(15) << std::put_money(367, false) << '\n'
<< "usd: " << std::setw(15) << std::put_money(367, true) << '\n'
<< "usd: " << std::setw(15)
<< std::setfill(' ') << std::put_money(367, false) << '\n';
// Output:
// flt: -9.87**********
// hex: 41*************
// $: $3.67**********
// usd: USD *3.67******
// usd: $3.67
std::cout << std::internal << std::showbase << std::setfill('*')
<< "flt: " << std::setw(15) << -9.87 << '\n'
<< "hex: " << std::setw(15) << 41 << '\n'
<< " $: " << std::setw(15) << std::put_money(367, false) << '\n'
<< "usd: " << std::setw(15) << std::put_money(367, true) << '\n'
<< "usd: " << std::setw(15)
<< std::setfill(' ') << std::put_money(367, true) << '\n';
// Output:
// flt: -**********9.87
// hex: *************41
// $: $3.67**********
// usd: USD *******3.67
// usd: USD 3.67
std::cout << std::right << std::showbase << std::setfill('*')
<< "flt: " << std::setw(15) << -9.87 << '\n'
<< "hex: " << std::setw(15) << 41 << '\n'
<< " $: " << std::setw(15) << std::put_money(367, false) << '\n'
<< "usd: " << std::setw(15) << std::put_money(367, true) << '\n'
<< "usd: " << std::setw(15)
<< std::setfill(' ') << std::put_money(367, true) << '\n';
// Output:
// flt: **********-9.87
// hex: *************41
// $: **********$3.67
// usd: ******USD *3.67
// usd: USD 3.67
La valeur par défaut est std::left
.
std::fixed
, std::scientific
, std::hexfloat
[C ++ 11] et std::defaultfloat
[C ++ 11] - modifient le formatage pour les entrées / sorties en virgule flottante.
std::fixed
définit std::ios_base::floatfield
sur std::ios_base::fixed
,
std::scientific
- to std::ios_base::scientific
,
std::hexfloat
- to std::ios_base::fixed | std::ios_base::scientific
et
std::defaultfloat
- to std::ios_base::fmtflags(0)
.
fmtflags
#include <sstream>
...
std::cout << '\n'
<< "The number 0.07 in fixed: " << std::fixed << 0.01 << '\n'
<< "The number 0.07 in scientific: " << std::scientific << 0.01 << '\n'
<< "The number 0.07 in hexfloat: " << std::hexfloat << 0.01 << '\n'
<< "The number 0.07 in default: " << std::defaultfloat << 0.01 << '\n';
double f;
std::istringstream is("0x1P-1022");
double f = std::strtod(is.str().c_str(), NULL);
std::cout << "Parsing 0x1P-1022 as hex gives " << f << '\n';
// Output:
// The number 0.01 in fixed: 0.070000
// The number 0.01 in scientific: 7.000000e-02
// The number 0.01 in hexfloat: 0x1.1eb851eb851ecp-4
// The number 0.01 in default: 0.07
// Parsing 0x1P-1022 as hex gives 2.22507e-308
La valeur par défaut est std::ios_base::fmtflags(0)
.
Il y a un bug sur certains compilateurs qui provoque
double f;
std::istringstream("0x1P-1022") >> std::hexfloat >> f;
std::cout << "Parsing 0x1P-1022 as hex gives " << f << '\n';
// Output: Parsing 0x1P-1022 as hex gives 0
std::showpoint
et std::noshowpoint
- contrôle si le point décimal est toujours inclus dans la représentation en virgule flottante. N'a aucun effet sur les flux d'entrée.
std::cout << "7.0 with showpoint: " << std::showpoint << 7.0 << '\n'
<< "7.0 with noshowpoint: " << std::noshowpoint << 7.0 << '\n';
// Output: 1.0 with showpoint: 7.00000
// 1.0 with noshowpoint: 7
La valeur par défaut est std::showpoint
.
std::showpos
et std::noshowpos
- contrôle l'affichage du signe +
dans la sortie non négative . N'a aucun effet sur les flux d'entrée.
std::cout << "With showpos: " << std::showpos
<< 0 << ' ' << -2.718 << ' ' << 17 << '\n'
<< "Without showpos: " << std::noshowpos
<< 0 << ' ' << -2.718 << ' ' << 17 << '\n';
// Output: With showpos: +0 -2.718 +17
// Without showpos: 0 -2.718 17
Par défaut si std::noshowpos
.
std::unitbuf
, std::nounitbuf
- contrôle le flux de sortie après chaque opération. N'a aucun effet sur le flux d'entrée. std::unitbuf
provoque le vidage.
std::setbase(base)
- définit la base numérique du flux.
std::setbase(8)
est égal à la définition de std::ios_base::basefield
à std::ios_base::oct
,
std::setbase(16)
- to std::ios_base::hex
,
std::setbase(10)
- to std::ios_base::dec
.
Si base
est autre que 8
, 10
ou 16
alors std::ios_base::basefield
est en std::ios_base::fmtflags(0)
. Cela signifie une sortie décimale et une entrée dépendant du préfixe.
Par défaut std::ios_base::basefield
est std::ios_base::dec
alors par défaut std::setbase(10)
.
std::setprecision(n)
- modifie la précision en virgule flottante.
#include <cmath>
#include <limits>
...
typedef std::numeric_limits<long double> ld;
const long double pi = std::acos(-1.L);
std::cout << '\n'
<< "default precision (6): pi: " << pi << '\n'
<< " 10pi: " << 10 * pi << '\n'
<< "std::setprecision(4): 10pi: " << std::setprecision(4) << 10 * pi << '\n'
<< " 10000pi: " << 10000 * pi << '\n'
<< "std::fixed: 10000pi: " << std::fixed << 10000 * pi << std::defaultfloat << '\n'
<< "std::setprecision(10): pi: " << std::setprecision(10) << pi << '\n'
<< "max-1 radix precicion: pi: " << std::setprecision(ld::digits - 1) << pi << '\n'
<< "max+1 radix precision: pi: " << std::setprecision(ld::digits + 1) << pi << '\n'
<< "significant digits prec: pi: " << std::setprecision(ld::digits10) << pi << '\n';
// Output:
// default precision (6): pi: 3.14159
// 10pi: 31.4159
// std::setprecision(4): 10pi: 31.42
// 10000pi: 3.142e+04
// std::fixed: 10000pi: 31415.9265
// std::setprecision(10): pi: 3.141592654
// max-1 radix precicion: pi: 3.14159265358979323851280895940618620443274267017841339111328125
// max+1 radix precision: pi: 3.14159265358979323851280895940618620443274267017841339111328125
// significant digits prec: pi: 3.14159265358979324
La valeur par défaut est std::setprecision(6)
.
std::setiosflags(mask)
et std::resetiosflags(mask)
- définissent et std::resetiosflags(mask)
les indicateurs spécifiés dans le mask
du type std::ios_base::fmtflags
.
#include <sstream>
...
std::istringstream in("10 010 10 010 10 010");
int num1, num2;
in >> std::oct >> num1 >> num2;
std::cout << "Parsing \"10 010\" with std::oct gives: " << num1 << ' ' << num2 << '\n';
// Output: Parsing "10 010" with std::oct gives: 8 8
in >> std::dec >> num1 >> num2;
std::cout << "Parsing \"10 010\" with std::dec gives: " << num1 << ' ' << num2 << '\n';
// Output: Parsing "10 010" with std::oct gives: 10 10
in >> std::resetiosflags(std::ios_base::basefield) >> num1 >> num2;
std::cout << "Parsing \"10 010\" with autodetect gives: " << num1 << ' ' << num2 << '\n';
// Parsing "10 010" with autodetect gives: 10 8
std::cout << std::setiosflags(std::ios_base::hex |
std::ios_base::uppercase |
std::ios_base::showbase) << 42 << '\n';
// Output: OX2A
std::skipws
et std::noskipws
- contrôlent le saut des espaces blancs en tête par les fonctions d'entrée formatées. N'a aucun effet sur les flux de sortie.
#include <sstream>
...
char c1, c2, c3;
std::istringstream("a b c") >> c1 >> c2 >> c3;
std::cout << "Default behavior: c1 = " << c1 << " c2 = " << c2 << " c3 = " << c3 << '\n';
std::istringstream("a b c") >> std::noskipws >> c1 >> c2 >> c3;
std::cout << "noskipws behavior: c1 = " << c1 << " c2 = " << c2 << " c3 = " << c3 << '\n';
// Output: Default behavior: c1 = a c2 = b c3 = c
// noskipws behavior: c1 = a c2 = c3 = b
La valeur par défaut est std::ios_base::skipws
.
std::quoted(s[, delim[, escape]])
[C ++ 14] - insère ou extrait des chaînes entre guillemets avec des espaces incorporés.
s
- la chaîne à insérer ou à extraire.
delim
- le caractère à utiliser comme délimiteur, "
par défaut.
escape
- le caractère à utiliser comme caractère d'échappement, \
par défaut.
#include <sstream>
...
std::stringstream ss;
std::string in = "String with spaces, and embedded \"quotes\" too";
std::string out;
ss << std::quoted(in);
std::cout << "read in [" << in << "]\n"
<< "stored as [" << ss.str() << "]\n";
ss >> std::quoted(out);
std::cout << "written out [" << out << "]\n";
// Output:
// read in [String with spaces, and embedded "quotes" too]
// stored as ["String with spaces, and embedded \"quotes\" too"]
// written out [String with spaces, and embedded "quotes" too]
Pour plus d'informations, voir le lien ci-dessus.
Manipulateurs de flux de sortie
std::ends
- insère un caractère nul '\0'
dans le flux de sortie. Plus formellement, la déclaration de ce manipulateur ressemble à
template <class charT, class traits>
std::basic_ostream<charT, traits>& ends(std::basic_ostream<charT, traits>& os);
et ce manipulateur place un caractère en appelant os.put(charT())
lorsqu'il est utilisé dans une expression
os << std::ends;
std::endl
et std::flush
deux flux de sortie affleurant out
en appelant out.flush()
. Cela provoque une production immédiate. Mais std::endl
insère '\n'
symbole de fin de ligne '\n'
avant le vidage.
std::cout << "First line." << std::endl << "Second line. " << std::flush
<< "Still second line.";
// Output: First line.
// Second line. Still second line.
std::setfill(c)
- change le caractère de remplissage en c
. Souvent utilisé avec std::setw
.
std::cout << "\nDefault fill: " << std::setw(10) << 79 << '\n'
<< "setfill('#'): " << std::setfill('#')
<< std::setw(10) << 42 << '\n';
// Output:
// Default fill: 79
// setfill('#'): ########79
std::put_money(mon[, intl])
[C ++ 11]. Dans une expression out << std::put_money(mon, intl)
, convertit la valeur monétaire mon
(de type long double
ou std::basic_string
) en sa représentation en caractères comme spécifié par la facette std::money_put
de la localisation actuellement imprégnée out
. Utilisez des chaînes de devises internationales si intl
est true
, utilisez les symboles de devise autrement.
long double money = 123.45;
// or std::string money = "123.45";
std::cout.imbue(std::locale("en_US.utf8"));
std::cout << std::showbase << "en_US: " << std::put_money(money)
<< " or " << std::put_money(money, true) << '\n';
// Output: en_US: $1.23 or USD 1.23
std::cout.imbue(std::locale("ru_RU.utf8"));
std::cout << "ru_RU: " << std::put_money(money)
<< " or " << std::put_money(money, true) << '\n';
// Output: ru_RU: 1.23 руб or 1.23 RUB
std::cout.imbue(std::locale("ja_JP.utf8"));
std::cout << "ja_JP: " << std::put_money(money)
<< " or " << std::put_money(money, true) << '\n';
// Output: ja_JP: ¥123 or JPY 123
std::put_time(tmb, fmt)
[C ++ 11] - formate et affiche une valeur date / heure dans std::tm
selon le format spécifié fmt
.
tmb
- pointeur sur la structure de temps du calendrier const std::tm*
obtenue à partir de localtime()
ou de gmtime()
.
fmt
- pointeur sur une chaîne terminée par un caractère nul const CharT*
spécifiant le format de conversion.
#include <ctime>
...
std::time_t t = std::time(nullptr);
std::tm tm = *std::localtime(&t);
std::cout.imbue(std::locale("ru_RU.utf8"));
std::cout << "\nru_RU: " << std::put_time(&tm, "%c %Z") << '\n';
// Possible output:
// ru_RU: Вт 04 июл 2017 15:08:35 UTC
Pour plus d'informations, voir le lien ci-dessus.
Manipulateurs de flux d'entrée
std::ws
- consomme les principaux espaces blancs dans le flux d'entrée. C'est différent de std::skipws
.
#include <sstream>
...
std::string str;
std::istringstream(" \v\n\r\t Wow!There is no whitespaces!") >> std::ws >> str;
std::cout << str;
// Output: Wow!There is no whitespaces!
std::get_money(mon[, intl])
[C ++ 11]. Dans une expression in >> std::get_money(mon, intl)
parse l'entrée de caractères en tant que valeur monétaire, comme spécifié par le std::money_get
facette de l'environnement local actuellement imprégné de in
, et stocke la valeur dans mon
(de long double
ou std::basic_string
). Le manipulateur attend des chaînes de devises internationales obligatoires si intl
est true
, attend des symboles de devise facultatifs , sinon.
#include <sstream>
#include <locale>
...
std::istringstream in("$1,234.56 2.22 USD 3.33");
long double v1, v2;
std::string v3;
in.imbue(std::locale("en_US.UTF-8"));
in >> std::get_money(v1) >> std::get_money(v2) >> std::get_money(v3, true);
if (in) {
std::cout << std::quoted(in.str()) << " parsed as: "
<< v1 << ", " << v2 << ", " << v3 << '\n';
}
// Output:
// "$1,234.56 2.22 USD 3.33" parsed as: 123456, 222, 333
std::get_time(tmb, fmt)
[C ++ 11] - analyse une valeur date / heure stockée dans tmb
format spécifié fmt
.
tmb
- pointeur valide vers l'objet const std::tm*
où le résultat sera stocké.
fmt
- pointeur vers une chaîne terminée par un caractère nul const CharT*
spécifiant le format de conversion.
#include <sstream>
#include <locale>
...
std::tm t = {};
std::istringstream ss("2011-Februar-18 23:12:34");
ss.imbue(std::locale("de_DE.utf-8"));
ss >> std::get_time(&t, "%Y-%b-%d %H:%M:%S");
if (ss.fail()) {
std::cout << "Parse failed\n";
}
else {
std::cout << std::put_time(&t, "%c") << '\n';
}
// Possible output:
// Sun Feb 18 23:12:34 2011
Pour plus d'informations, voir le lien ci-dessus.