Requisitos denominados de C++: FormattedOutputFunction

Requisitos

Una FormattedOutputFunction es una funcin de flujo de salida que realiza lo siguiente:

• Construye un objeto de tipo basic_ostream::sentry con duracin automtica de almacenamiento, lo que realiza lo siguiente:

• Si eofbit o badbit se activan en el flujo de salida, tambin se activa el failbit, y si se habilitan excepciones en failbit para la exception mask de este flujo de entrada ((exceptions() & failbit) != 0), lanza ios_base::failure.
• Vaca el flujo de salida atado, si aplica.

• Valida el estado del centinela por medio del llamado a sentry::operator bool(), lo que equivale a basic_ios::good.
• Si el centinela devolvi false, o el constructor del centinela lanz una excepcin, no se genera ninguna salida.
• Si el centinela devolvi true, intenta crear la salida deseada insertando los caracteres en el flujo de salida, como si fuera un llamado a rdbuf()->sputc(). Otros miembros pblicos de std::basic_ostream tambin pueden ser usados, pero nunca sern llamados los miembros virtuales de rdbuf(), a excepcin de overflow(), xsputn() y sync().

• Si la salida no se pudo generar, activa failbit. Si se habilitan excepciones en failbit para la exception mask de este flujo ((exceptions() & failbit) != 0), lanza ios_base::failure.
• Si se lanza una excepcin en la salida, se activa badbit en el flujo de salida. Si se habilitan excepciones en badbit para la exception mask ((exceptions() & badbit) != 0) de este flujo, la excepcin es relanzada.
• Si no se lanza ninguna excepcin, devuelve *this.

• En cualquier caso, ya sea terminando por excepcin o devolviendo un valor, el destructor del centinela es llamado antes de salir de esta funcin.

Relleno

Biblioteca estndar

Las siguientes son funciones de la biblioteca estndar que corresponden a funciones FormattedOutputFunction.

• basic_ostream::operator<<(std::basic_ostream&, int / long / double / void* / bool)
• operator<<(std::basic_ostream&, char)
• operator<<(std::basic_ostream&, char*)
• operator<<(std::basic_ostream&, const std::bitset&)
• operator<<(std::basic_ostream&, const std::basic_string&)
• operator<< , cuando se llama sobre el valor devuelto de std::put_money

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estndares de C++ publicados anteriormente.