getline
Vstupní proud řádek po řádku extrahujte řetězce.
template<class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>& _Istr,
basic_string<CharType, Traits, Allocator>& _Str
);
template<class CharType, class Traits, class Allocator>
basic_istream< CharType, Traits >& getline(
basic_istream< CharType, Traits >& _Istr,
basic_string< CharType, Traits, Allocator >& _Str,
CharType _Delim
);
template<class Allocator, class Traits, class Allocator>
basic_istream< Allocator, Traits >& getline(
basic_istream< Allocator, Traits >&& _Istr,
basic_string< Allocator, Traits, Allocator >& _Str
);
template<class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>&& _Istr,
basic_string<CharType, Traits, Allocator>& _Str,
const CharType _Delim
);
Parametry
_Istr
Vstupní proud, ze kterého má být extrahován řetězec._Str
Řetězec, do kterého jsou čtení znaků ze vstupního datového proudu._Delim
Oddělovač řádku.
Vrácená hodnota
The first function returns getline( _Istr, _Str, _Istr.widen( '\n' ) ).
Druhá funkce nahradí sekvence řízena _Str s posloupností prvky extrahované z proudu _Istr.
Ostatní funkce jsou analogs ty starší, ale s Lvalues a Rvalues.
Poznámky
Extrakce zastaví v pořadí zkoušek:
Na konec souboru.
Po funkci extrahuje element, který porovnává rovno delim, v tom případě prvek umístit zpět ani k řízené sekvence.
Po funkci extrahuje str.max_size prvky, které v případě volání funkce setstate(ios_base::failbit).
Pokud funkce extrahuje žádné prvky, volá setstate(failbit).V každém případě vrátí hodnotu _Istr.
Příklad
Viz string::getline pro příklad použití getline.
Požadavky
Záhlaví: <string>
Obor názvů: std