std::basic_filebuf::pbackfail

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de E/S

Manipuladores de E/S

E/S estilo C

Búferes

basic_streambuf

basic_filebuf

basic_stringbuf

strstreambuf (en desuso en C++98)

basic_syncbuf (C++20)

Flujos

Abstracciones

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

E/S de archivos

basic_ifstream

basic_ofstream

basic_fstream

E/S de cadenas

basic_istringstream

basic_ostringstream

basic_stringstream

E/S de arrays

istrstream (en desuso en C++98)

ostrstream (en desuso en C++98)

strstream (en desuso en C++98)

Salida sincronizada

basic_osyncstream (C++20)

Tipos

streamoff

streamsize

fpos

Interfaz de categoría de error

iostream_category (C++11)

io_errc (C++11)

 

std::basic_filebuf

Las funciones públicas miembros Original: Public 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_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

Protegido funciones miembro Original: Protected 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_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

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.

swap(std::basic_filebuf) (C++11)

 

protected: virtual int_type pbackfail( int_type c = Traits::eof())

Esta función virtual protegida se llama por las funciones públicas basic_streambuf::sungetc y basic_streambuf::sputbackc (que, a su vez, se llaman por basic_istream::unget y basic_istream::putback).

1) El invocador solicita que el área de obtención esté respaldada por un carácter (se llama a pbackfail() sin argumentos), en cuyo caso, esta función vuelve a leer el archivo comenzando un byte antes y decrementa basic_streambuf::gptr(), por ejemplo llamando a gbump(-1).

2) El invocador intenta devolver un carácter diferente del recuperado anteriormente (se llama a pbackfail() con el carácter que se necesita devolver), en cuyo caso

a) Primero, verifica si existe una posición de reposición y, de no ser así, retrocede el área de obtención releyendo el archivo que comienza un byte antes.

a) Luego, verifica qué carácter se encuentra en la posición de reposición. Si el carácter contenido ya es igual a c, según lo determinado por Traits::eq(to_char_type(c), gptr()[-1]), simplemente decrementa basic_streambuf::gptr().

b) De lo contrario, si se permite que el búfer modifique su propia área de obtención, decrementa basic_streambuf::gptr() y escribe c en la ubicación indicada por gptr() después del ajuste.

Esta función nunca modifica el archivo, solo el área de obtención del búfer en memoria.

Si el archivo no está abierto (is_open()==false, esta función devuelve Traits::eof() inmediatamente.

Parámetros

c

-

El carácter a reponer, o Traits::eof() para indicar que se solicita que el área de obtención se retroceda.

Valor de retorno

c en caso de éxito, excepto si c fue Traits::eof(), en cuyo caso se devuelve Traits::not_eof(c); Traits::eof() en caso de falla.

Véase también

pbackfail [virtual]	Pone un carácter de nuevo en la secuencia de entrada, posiblemente modificando tal secuencia. (función miembro virtual protegida de std::basic_streambuf<CharT,Traits>)
sungetc	Mueve el puntero siguiente en la secuencia de entrada hacia atrás en uno. (función miembro pública de std::basic_streambuf<CharT,Traits>)
sputbackc	Pone un carácter de nuevo en la secuencia de entrada. (función miembro pública de std::basic_streambuf<CharT,Traits>)
unget	unextracts un carácter Original: unextracts a character The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (función miembro pública de std::basic_istream)
putback	pone personaje en la corriente de entrada Original: puts character into input stream The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (función miembro pública de std::basic_istream)