std:: setw

Lorsqu'il est utilisé dans une expression out << std :: setw ( n ) ou in >> std :: setw ( n ) , définit le paramètre width du flux out ou in exactement à n .

Certaines opérations réinitialisent la largeur à zéro (voir ci-dessous ), donc std::setw devra peut-être être appelé de manière répétée pour définir la largeur pour plusieurs opérations.

Paramètres

Valeur de retour

Un objet de type non spécifié tel que

• si out est un objet de type std:: basic_ostream < CharT, Traits > , l'expression out << setw ( n )
  • a pour type std:: basic_ostream < CharT, Traits > &
  • a pour valeur out
  • se comporte comme si elle appelait f ( out, n )
• si in est un objet de type std:: basic_istream < CharT, Traits > , l'expression in >> setw ( n )
  • a pour type std:: basic_istream < CharT, Traits > &
  • a pour valeur in
  • se comporte comme si elle appelait f ( in, n )

où la fonction f est définie comme :

void f(std::ios_base& str, int n)
{
    // définir la largeur
    str.width(n);
}

Notes

La propriété de largeur du flux sera réinitialisée à zéro (signifiant "non spécifiée") si l'une des fonctions suivantes est appelée :

• Entrée

• operator>>(basic_istream&, basic_string&)
• operator>>(basic_istream&, char*)

• Sortie

• Surcharges de basic_ostream::operator<<() qui prennent des types arithmétiques ou des pointeurs void (à l'Étape 3 de num_put::put() )
• operator<<(basic_ostream&, char) et operator<<(basic_ostream&, char*)
• operator<<(basic_ostream&, basic_string&)
• std::put_money (dans money_put::put() )
• std::quoted (lorsqu'utilisé avec un flux de sortie)

Les effets exacts que ce modificateur a sur l'entrée et la sortie varient selon les fonctions d'E/S individuelles et sont décrits sur chaque page de surcharge operator << et operator >> individuellement.

Exemple

#include <iomanip>
#include <iostream>
#include <sstream>
int main()
{
    std::cout << "no setw: [" << 42 << "]\n"
              << "setw(6): [" << std::setw(6) << 42 << "]\n"
              << "no setw, several elements: [" << 89 << 12 << 34 << "]\n"
              << "setw(6), several elements: [" << 89 << std::setw(6) << 12 << 34 << "]\n";
    std::istringstream is("hello, world");
    char arr[10];
    is >> std::setw(6) >> arr;
    std::cout << "Input from \"" << is.str() << "\" with setw(6) gave \""
              << arr << "\"\n";
}

no setw: [42]
setw(6): [    42]
no setw, several elements: [891234]
setw(6), several elements: [89    1234]
Input from "hello, world" with setw(6) gave "hello"

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi