std::basic_filebuf<CharT,Traits>:: setbuf

Si s es un puntero nulo y n es cero, el filebuf se convierte en unbuffered para salida, lo que significa que pbase() y pptr() son nulos y cualquier salida se envía inmediatamente al archivo.

De lo contrario, una llamada a setbuf() reemplaza el buffer interno (la secuencia de caracteres controlada) con el arreglo de caracteres proporcionado por el usuario cuyo primer elemento es apuntado por s y permite que este objeto std::basic_filebuf utilice hasta n bytes en ese arreglo para el almacenamiento en búfer.

Esta función es protegida virtual, solo puede ser llamada a través de pubsetbuf() o desde funciones miembro de una clase definida por el usuario derivada de std::basic_filebuf .

Parámetros

Valor de retorno

this

Notas

Las condiciones en las que esta función puede utilizarse y la forma en que se utiliza el búfer proporcionado están definidas por la implementación.

• GCC 4.6 libstdc++

setbuf() solo puede llamarse cuando el std::basic_filebuf no está asociado con un archivo (no tiene efecto en caso contrario). Con un búfer proporcionado por el usuario, la lectura del archivo lee n-1 bytes a la vez.

• Clang++3.0 libc++

setbuf() puede llamarse después de abrir el archivo, pero antes de cualquier operación de E/S (de lo contrario podría fallar). Con un búfer proporcionado por el usuario, la lectura del archivo lee los múltiplos más grandes de 4096 que quepan en el búfer.

• Visual Studio 2010

setbuf() puede ser llamado en cualquier momento, incluso después de que haya ocurrido alguna operación de E/S. El contenido actual del búfer, si existe, se pierde.

El estándar no define ningún comportamiento para esta función excepto que setbuf ( 0 , 0 ) llamado antes de que se haya realizado cualquier operación de E/S debe establecer la salida sin búfer.

Ejemplo

#include <fstream>
#include <iostream>
#include <string>
int main()
{
    int cnt = 0;
    std::ifstream file;
    char buf[10241];
    file.rdbuf()->pubsetbuf(buf, sizeof buf);
    file.open("/usr/share/dict/words");
    for (std::string line; getline(file, line);)
        ++cnt;
    std::cout << cnt << '\n';
}

356010

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

Véase también