std::basic_stringbuf<CharT,Traits,Allocator>:: underflow
|
protected
:
virtual int_type underflow ( ) |
||
Lee el siguiente carácter del área de obtención del búfer.
Específicamente:
Cualquier carácter en el búfer que haya sido inicializado, independientemente de si se originó a partir de la cadena pasada en el constructor o fue añadido por overflow() , se considera parte de la secuencia de entrada.
Contenidos |
Parámetros
(ninguno)
Valor de retorno
Traits :: to_int_type ( * gptr ( ) ) (el siguiente carácter a leer en el área de obtención) en caso de éxito, o Traits :: eof ( ) en caso de fallo.
Ejemplo
#include <iostream> #include <sstream> struct mybuf : std::stringbuf { mybuf(const std::string& new_str, std::ios_base::openmode which = std::ios_base::in | std::ios_base::out) : std::stringbuf(new_str, which) {} int_type overflow(int_type c) { std::cout << "Before overflow(): get area size is " << egptr() - eback() << ", the put area size is " << epptr() - pbase() << '\n'; int_type rc = std::stringbuf::overflow(c); std::cout << "After overflow(): get area size is " << egptr() - eback() << ", put area size is " << epptr() - pbase() << '\n'; return rc; } int_type underflow() { std::cout << "Before underflow(): get area size is " << egptr() - eback() << ", put area size is " << epptr() - pbase() << '\n'; int_type ch = std::stringbuf::underflow(); std::cout << "After underflow(): get area size is " << egptr() - eback() << ", put area size is " << epptr() - pbase() << '\n'; if (ch == EOF) std::cout << "underflow() returns EOF\n"; else std::cout << "underflow() returns '" << char(ch) << "'\n"; return ch; } }; int main() { mybuf sbuf("123"); // flujo de lectura-escritura std::iostream stream(&sbuf); int n; stream >> n; // llama a sgetc() cuatro veces // tres llamadas retornan los caracteres '1', '2', '3' // en la cuarta llamada, gptr() == egptr() y se llama a underflow() // underflow retorna EOF std::cout << "n = " << n << '\n'; stream.clear(); // limpia el eofbit stream << "123456"; // se llama a sputc() 6 veces // las primeras tres llamadas almacenan "123" en el buffer existente // la 4ª llamada encuentra que pptr() == epptr() y llama a overflow() // overflow() aumenta el buffer y establece egptr() a 4 // las llamadas 5ª y 6ª almacenan '5' y '6', avanzando pptr() stream >> n; // llama a sgetc() 4 veces // la 1ª llamada retorna el '4' que fue hecho disponible por overflow() // en la 2ª llamada, egptr() == egptr() y se llama a underflow() // underflow avanza egptr() para igualar pptr() (que es 6) // la 3ª sgetc() retorna '6' // la 4ª sgetc() encuentra gptr() == egptr(), llama a underflow() // underflow() retorna EOF std::cout << "n = " << n << '\n'; }
Salida posible:
Before underflow(): get area size is 3, put area size is 15 After underflow(): get area size is 3, put area size is 15 underflow() returns EOF n = 123 Before underflow(): get area size is 3, put area size is 15 After underflow(): get area size is 6, put area size is 15 underflow() returns '4' Before underflow(): get area size is 6, put area size is 15 After underflow(): get area size is 6, put area size is 15 underflow() returns EOF n = 456
Informes de defectos
Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.
| DR | Aplicado a | Comportamiento publicado | Comportamiento correcto |
|---|---|---|---|
| LWG 432 | C++98 |
no estaba claro si los caracteres añadidos por
overflow()
se consideran parte de la secuencia de entrada |
aclarado |
Véase también
|
[virtual]
|
lee caracteres de la secuencia de entrada asociada al área de obtención
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
lee del archivo asociado
(función miembro protegida virtual de
std::basic_filebuf<CharT,Traits>
)
|
|
[virtual]
|
lee un carácter de la secuencia de entrada sin avanzar el puntero siguiente
(función miembro protegida virtual de
std::strstreambuf
)
|
|
lee un carácter de la secuencia de entrada sin avanzar la secuencia
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|