std::getline

 

C++

Lenguaje

Cabeceras

Conceptos

Biblioteca de utilidades

Biblioteca de cadenas

Biblioteca de contenedores

Biblioteca de algoritmos

Biblioteca de iteradores

Biblioteca numérica

Biblioteca de entrada/salida

Biblioteca de localización

Biblioteca de expresiones regulares (C++11)

Biblioteca de operaciones atómicas (C++11)

Biblioteca de tareas/subprocesos (C++11)

 

Strings biblioteca

Terminadas en nulo 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.

Cadenas de bytes

Multibyte cuerdas

Cadenas anchas

Clases Original: Classes The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

basic_string

char_traits

 

std::basic_string

Las funciones miembro 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

Elemento acceso 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

Los 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)

Capacidad 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)

Operaciones 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

Buscar 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

Terceros funciones 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.

operator+

operator== operator!= operator< operator> operator<= operator>=

swap(std::basic_string)

operator<< operator>>

getline

stoi stol stoll (C++11) (C++11) (C++11)

stoul stoull (C++11) (C++11)

stof stod stold (C++11) (C++11) (C++11)

to_string (C++11)

to_wstring (C++11)

Clases de ayuda 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.

hash<std::string> hash<std::wstring> hash<std::u32string> hash<std::u16string> (C++11)

 

Defined in header <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 lee los caracteres de una secuencia de entrada y los coloca en una cadena:

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, excepto que input.gcount() no se ve afectada. Después de la construcción y comprobación del objeto centinela, realiza lo siguiente:

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)

Llamadas 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)

Extrae caracteres de input y añade a ellos str hasta una de las siguientes situaciones (comprobado en el orden indicado)

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)

al final de su archivo de estado en input, en cuyo caso, conjuntos getline eofbit y vuelve .

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)

el siguiente carácter de entrada disponible es delim, según pruebas realizadas por Traits::eq(c, delim), en cuyo caso se extrae el carácter delimitador de input, pero no se anexa a 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)

str.max_size() personajes han sido almacenados, en cuyo caso getline conjuntos failbit y vuelve .

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)

Si hay personajes fueron extraídos por la razón que sea (ni siquiera el delimitador descartado), getline conjuntos failbit y vuelve .

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)

Igual que getline(input, str, input.widen(’\n’)), es decir, el delimitador predeterminado es el carácter de línea de fondo .

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.

Parámetros

input	-	la corriente para obtener los datos 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	-	la cadena para poner los datos en 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	-	el carácter 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.

Valor de retorno

input

Ejemplo

El código siguiente pregunta al usuario por su nombre, y luego saluda con ese nombre .

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.";
}

Possible output:

What is your name? John Q. Public
Hello John Q. Public, nice to meet you.