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

CKTIS / C++

std::left — aligner un champ de sortie à gauche

std::left sélectionne l’alignement à gauche pour les sorties formatées d’un flux. Lorsqu’un champ est plus large que sa valeur, les caractères de remplissage apparaissent après celle-ci. L’alignement reste actif jusqu’à ce qu’il soit modifié.

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

Syntaxe

#include <iomanip>
#include <ios>
#include <ostream>

// Usage with an output stream:
out << std::left << std::setw(width) << value;

std::left est un manipulateur déclaré dans <ios>. L’écriture de out << std::left modifie l’état de formatage du flux au lieu d’afficher du texte. La fonction appelle str.setf(std::ios_base::left, std::ios_base::adjustfield) et renvoie str : elle remplace le réglage d’alignement sans modifier les autres groupes de drapeaux.

Dans un champ de sortie aligné à gauche, les caractères de remplissage suivent la valeur. Définissez la largeur avec std::setw(width) et le caractère de remplissage avec std::setfill(c) ; ces deux manipulateurs nécessitent <iomanip>. La largeur est un minimum : un texte plus long n’est pas tronqué. std::left ne définit ni la largeur ni le caractère de remplissage.

L’alignement et le caractère de remplissage restent définis jusqu’à leur modification. En revanche, l’insertion d’un caractère ou d’une chaîne de caractères réinitialise la largeur du champ ; répétez donc std::setw avant chaque champ de ce type. std::right remplace l’alignement à gauche par l’alignement à droite. Avec un flux partagé, gardez à l’esprit que l’état modifié affecte aussi les opérations de sortie suivantes.

L’exemple utilise des points pour rendre le remplissage visible. Les deux premiers champs montrent que std::left reste actif, et le dernier illustre le passage à std::right. Vous pouvez vérifier l’exemple localement avec -std=c++23. Le code source affiché a été exécuté sans modification dans un environnement isolé, et la sortie standard (stdout) correspondait exactement à la sortie attendue. Cette vérification ne permet pas d’attester le comportement à l’exécution en production.

Exemples

#include <iomanip>
#include <ios>
#include <iostream>

int main() {
    std::cout << std::setfill('.') << std::left;
    std::cout << '|' << std::setw(6) << "cat"
              << '|' << std::setw(6) << "ox" << "|\n";
    std::cout << std::right
              << '|' << std::setw(6) << "cat" << "|\n";
}

Résultat

|cat...|ox....|
|...cat|

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