Espaços nominais
Variantes
Acções

std::getline

Da cppreference.com
< cpp‎ | string‎ | basic string

This page has been machine-translated from the English version of the wiki using Google Translate.

The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here.

Click here for the English version of this page


 
C++
 
Biblioteca cordas
Strings terminadas
Original:
Null-terminated strings
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
Cadeias de bytes
Multibyte cordas
Cordas de largura
Classes
Original:
Classes
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
 
std::basic_string
Funções de membro
Original:
Member functions
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
basic_string::basic_string
basic_string::operator=
basic_string::assign
basic_string::get_allocator
acesso. Elemento
Original:
Element access
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
basic_string::at
basic_string::operator[]
basic_string::front(C++11)
basic_string::back(C++11)
basic_string::data
basic_string::c_str
Iteradores
Original:
Iterators
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
basic_string::begin
basic_string::cbegin
(C++11)
basic_string::end
basic_string::cend
(C++11)
basic_string::rbegin
basic_string::crbegin
(C++11)
basic_string::rend
basic_string::crend
(C++11)
Capacidade
Original:
Capacity
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
basic_string::empty
basic_string::size
basic_string::length
basic_string::max_size
basic_string::reserve
basic_string::capacity
basic_string::shrink_to_fit(C++11)
Operações
Original:
Operations
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
basic_string::clear
basic_string::insert
basic_string::erase
basic_string::push_back
basic_string::pop_back(C++11)
basic_string::append
basic_string::operator+=
basic_string::compare
basic_string::replace
basic_string::substr
basic_string::copy
basic_string::resize
basic_string::swap
Pesquisar
Original:
Search
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
basic_string::find
basic_string::rfind
basic_string::find_first_of
basic_string::find_first_not_of
basic_string::find_last_of
basic_string::find_last_not_of
Constantes
Original:
Constants
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
basic_string::npos
Não-membros funções
Original:
Non-member functions
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
getline
(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Classes auxiliares
Original:
Helper classes
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
(C++11)
 
Definido no cabeçalho <string>
template< class CharT, class Traits, class Allocator >

std::basic_istream<CharT,Traits>& getline( std::basic_istream<CharT,Traits>& input,
                                           std::basic_string<CharT,Traits,Allocator>& str,

                                           CharT delim );
 (1)
template< class CharT, class Traits, class Allocator >

std::basic_istream<CharT,Traits>& getline( std::basic_istream<CharT,Traits>&& input,
                                           std::basic_string<CharT,Traits,Allocator>& str,

                                           CharT delim );
 (1) (desde C++11)
template< class CharT, class Traits, class Allocator >

std::basic_istream<CharT,Traits>& getline( std::basic_istream<CharT,Traits>& input,

                                           std::basic_string<CharT,Traits,Allocator>& str );
 (2)
template< class CharT, class Traits, class Allocator >

std::basic_istream<CharT,Traits>& getline( std::basic_istream<CharT,Traits>&& input,

                                           std::basic_string<CharT,Traits,Allocator>& str );
 (2) (desde C++11)
getline lê caracteres a partir de um fluxo de entrada e coloca-los em uma string:
Original:
getline reads characters from an input stream and places them into a string:
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
1)
Se comporta como UnformattedInputFunction, exceto que input.gcount() não é afetado. Depois de construir e verificar o objeto de sentinela, executa o seguinte:
Original:
Behaves as UnformattedInputFunction, except that input.gcount() is not affected. After constructing and checking the sentry object, performs the following:
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
1)
Chama str.erase()
Original:
Calls str.erase()
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
2)
Extrai personagens de input e acrescenta-lhes a str até uma das seguintes situações (marcada na ordem listada)
Original:
Extracts characters from input and appends them to str until one of the following occurs (checked in the order listed)
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
a)
fim-de-arquivo na condição input, caso em que, getline conjuntos eofbit e retornos.
Original:
end-of-file condition on input, in which case, getline sets eofbit and returns.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
b)
o caracter de entrada disponível é delim, como testado por Traits::eq(c, delim), caso em que o carácter delimitador é extraído input, mas não é acrescentado ao str.
Original:
the next available input character is delim, as tested by Traits::eq(c, delim), in which case the delimiter character is extracted from input, but is not appended to str.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
c)
Caracteres str.max_size() foram armazenados, caso em que getline conjuntos failbit e retornos.
Original:
str.max_size() characters have been stored, in which case getline sets failbit and returns.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
3)
Se nenhum dos caracteres foram extraídos por qualquer motivo (nem mesmo o delimitador descartados), getline conjuntos failbit e retornos.
Original:
If no characters were extracted for whatever reason (not even the discarded delimiter), getline sets failbit and returns.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
2)
Mesmo que getline(input, str, input.widen(’\n’)), isto é, o padrão é o carácter delimitador endline.
Original:
Same as getline(input, str, input.widen(’\n’)), that is, the default delimiter is the endline character.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

[editar] Parâmetros

input -
o fluxo para obter os dados
Original:
the stream to get data from
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
str -
a corda para colocar os dados
Original:
the string to put the data into
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
delim -
o caractere delimitador
Original:
the delimiter character
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

[editar] Valor de retorno

input

[editar] Exemplo

O código a seguir pede ao usuário para o seu nome, em seguida, cumprimenta-los usando esse nome .
Original:
The following code asks the user for their name, then greets them using that name.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

#include <string>
#include <iostream>
 
int main()
{
    std::string name;
    std::cout << "What is your name? ";
    std::getline(std::cin, name);
    std::cout << "Hello " << name << ", nice to meet you.";
}

Potencial saída: 

What is your name? John Q. Public
Hello John Q. Public, nice to meet you.
Obtida de "https://pt.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/getline&oldid=26661"