std::basic_ostream<CharT,Traits>:: write

Se comporta como una UnformattedOutputFunction . Después de construir y verificar el objeto sentry, envía los caracteres desde ubicaciones sucesivas en el array de caracteres cuyo primer elemento está señalado por s . Los caracteres se insertan en la secuencia de salida hasta que ocurra una de las siguientes condiciones:

• se insertan exactamente count caracteres
• la inserción en la secuencia de salida falla (en cuyo caso se llama a setstate ( badbit ) ).

Parámetros

Valor de retorno

* this

Excepciones

Si una operación interna lanza una excepción, esta es capturada y badbit se establece. Si exceptions() está configurado para badbit , la excepción se relanza.

Notas

Esta función no está sobrecargada para los tipos signed char o unsigned char , a diferencia del operator<< formateado.

Además, a diferencia de las funciones de salida formateadas, esta función no establece el failbit en caso de fallo.

Al utilizar una configuración regional no convertidora (la configuración regional predeterminada es no convertidora), el reemplazo de esta función en std::basic_ofstream puede ser optimizado para E/S masiva de copia cero (mediante el reemplazo de std::streambuf::xsputn ).

Ejemplo

#include <iostream>
int main()
{
    int n = 0x41424344;
    std::cout.write(reinterpret_cast<char*>(&n), sizeof n) << '\n';
    char c[] = "This is sample text.";
    std::cout.write(c, 4).write("!\n", 2);
}

DCBA
This!

Véase también