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

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

Sources