Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::setw — définir la largeur d’un champ de flux

std::setw(n), déclaré dans <iomanip>, définit la largeur d’un champ de flux. En sortie, les valeurs plus courtes sont complétées et les plus longues ne sont pas tronquées. Réappliquez la largeur pour chaque champ successif, car les opérations de sortie peuvent la réinitialiser.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <iomanip>
out << std::setw(n) << value;
in >> std::setw(n) >> value;

std::setw(n) est un manipulateur déclaré dans <iomanip>. Utilisé sous la forme out << std::setw(n) ou in >> std::setw(n), il appelle en pratique width(n) sur le flux concerné. Il accepte un int et renvoie un objet de type non spécifié, et non la largeur elle-même. En entrée, le sens du réglage dépend de l’opération d’extraction ; il ne s’agit pas d’une limite générale du nombre de chiffres.

En sortie, la largeur indique une taille minimale de champ pour les opérations qui en tiennent compte. Une représentation plus courte reçoit des caractères de remplissage ; une représentation plus longue est écrite en entier. std::setfill choisit le caractère de remplissage, tandis que std::left et std::right permettent respectivement d’aligner le texte à gauche et à droite.

Ne considérez pas la largeur comme un réglage de colonne permanent. Les opérations d’insertion de caractères et de chaînes de caractères la réinitialisent après utilisation : placez donc std::setw(n) juste avant chaque champ à compléter. Même un séparateur inséré avant la valeur prévue peut consommer la largeur. Le simple fait de définir le remplissage ou l’alignement ne la consomme pas ; ces réglages restent actifs jusqu’à modification.

Dans l’exemple, cat reçoit deux points à gauche, x n’est pas complété et dog reçoit deux points à droite. bird reste entier malgré la largeur 2. std::setw est défini dans la section [std.manip]. Le document cité est un projet de travail, et non une publication C++23 définitive.

Exemples

#include <iomanip>
#include <iostream>
#include <sstream>

int main() {
    std::ostringstream out;
    out << std::setfill('.') << std::right;
    out << '|' << std::setw(5) << "cat" << '|' << "x" << '|';
    out << std::left << std::setw(5) << "dog" << '|';
    out << std::setw(2) << "bird" << '|';
    std::cout << out.str() << '\n';
}

Résultat

|..cat|x|dog..|bird|

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources