CKTIS / C++
std::setfill — caractère de remplissage des champs de sortie
std::setfill de <iomanip> définit le caractère utilisé pour remplir les champs lors d’une sortie formatée. Il fonctionne avec une largeur de champ, définie par exemple par std::setw, et reste actif jusqu’à ce qu’il soit modifié.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <iomanip>
// Declaration (unspecified denotes an unspecified return type):
template<class charT> unspecified setfill(charT c);
// Usage:
out << std::setfill(c);std::setfill(c) est un manipulateur de <iomanip>. L’expression out << std::setfill(c) modifie l’état du flux comme le ferait un appel à out.fill(c) ; elle n’écrit pas elle-même de caractères. La fonction renvoie un objet de type non spécifié, tandis que l’expression complète avec << renvoie une référence à out, ce qui permet d’enchaîner les opérations.
Lorsque la sortie formatée doit être complétée pour atteindre une largeur de champ, le flux utilise le caractère défini. std::setw(n) indique une largeur minimale, et non une limite de longueur : un texte plus long n’est pas tronqué. Pour le texte, std::right place le remplissage avant le contenu et std::left le place après. std::setfill seul ne définit ni la largeur ni l’alignement.
Le caractère de remplissage reste défini pour les opérations suivantes, tandis que l’insertion de caractères et de chaînes remet la largeur du champ à zéro. Répétez donc std::setw avant chaque champ à compléter. Lorsqu’un flux est partagé, enregistrez le caractère précédent avec out.fill() et rétablissez-le avec out.fill(previous) ; cela ne rétablit pas les autres paramètres de formatage.
Le type de c doit correspondre au type de caractères du flux : utilisez par exemple '.' pour un flux char et L'.' pour un flux wchar_t. L’exemple montre que le caractère de remplissage reste actif, ainsi que les deux sens d’alignement. La spécification de std::setfill figure dans la section [std.manip] du projet de norme C++.
Exemples
#include <iomanip>
#include <iostream>
#include <sstream>
int main() {
std::ostringstream out;
const char previous = out.fill();
out << std::setfill('.') << std::right
<< std::setw(5) << "A" << '|'
<< std::setw(5) << "BC" << '|'
<< std::left << std::setw(5) << "D";
out.fill(previous);
std::cout << out.str() << '\n';
}
Résultat
....A|...BC|D....
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.