CKTIS / C++
std::getline : lire du texte jusqu’à un délimiteur
std::getline remplace un std::string par les caractères du flux jusqu’au délimiteur extrait mais non ajouté.
Version : C++23
Syntaxe
template<class CharT, class Traits, class Allocator>
std::basic_istream<CharT, Traits>&
std::getline(std::basic_istream<CharT, Traits>& input,
std::basic_string<CharT, Traits, Allocator>& text,
CharT delimiter);
// Without delimiter, uses input.widen('\n').std::getline(input, text, delim) se comporte comme une fonction d’entrée non formatée : après une sentry réussie, elle appelle text.erase(), puis ajoute les caractères jusqu’à EOF, au prochain delim ou à text.max_size(). Le délimiteur est extrait du flux sans être stocké. La surcharge sans délimiteur emploie input.widen('\n') et n’affecte pas un gcount() ultérieur.
L’exemple lit red,green\n : le premier appel s’arrête à la virgule et le second à la fin de ligne ; il affiche donc red|green. La destination est remplacée, non prolongée à partir de son ancien contenu.
Si aucun caractère n’est extrait, failbit est positionné ; EOF positionne eofbit, et atteindre max_size() positionne aussi failbit. Les bits sélectionnés par exceptions() peuvent lancer std::ios_base::failure. Après operator>>, une fin de ligne restante peut produire un enregistrement vide ; consommez-la avec ignore ou utilisez sciemment std::ws, qui supprime tous les blancs initiaux.
Exemples
#include <iostream>
#include <sstream>
#include <string>
int main() {
std::istringstream input{"red,green\n"};
std::string first;
std::string second;
std::getline(input, first, ',');
std::getline(input, second);
std::cout << first << '|' << second << '\n';
}
Résultat
red|green
std::getline → red|green