KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::getline: tekst tot een scheidingsteken lezen

std::getline vervangt een std::string door streamtekens tot een scheidingsteken dat wel gelezen maar niet toegevoegd wordt.

Versie: C++23

Syntax

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) werkt als niet-geformatteerde invoer: na een geslaagde sentry roept het text.erase() aan en voegt tekens toe tot EOF, de volgende delim of text.max_size(). Het scheidingsteken wordt uit de stream gehaald maar niet opgeslagen. De overload zonder scheidingsteken gebruikt input.widen('\n') en beïnvloedt een latere gcount() niet.

Het voorbeeld leest red,green\n: de eerste aanroep stopt bij de komma en de tweede bij het regeleinde, zodat red|green verschijnt. De bestemming wordt vervangen en niet uitgebreid vanaf de oude inhoud.

Als geen teken wordt gelezen, wordt failbit gezet; EOF zet eofbit, en max_size() bereiken zet ook failbit. In exceptions() gekozen bits kunnen std::ios_base::failure werpen. Na operator>> kan een achtergebleven newline een leeg record geven; verbruik die met ignore of bewust met std::ws, dat alle voorafgaande witruimte verwijdert.

Voorbeelden

#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';
}

Resultaat

red|green

std::getline → red|green

Bronnen