basic_ofstream::basic_ofstream

Artigo
03/14/2013

Cria um objeto do tipo basic_ofstream.

basic_ofstream( );
explicit basic_ofstream(
    const char *_Filename,
    ios_base::openmode _Mode = ios_base::out,
    int _Prot = (int)ios_base::_Openprot
);
explicit basic_ofstream(
    const wchar_t *_Filename,
    ios_base::openmode _Mode = ios_base::out,
    int _Prot = (int)ios_base::_Openprot
);
basic_ofstream(
    basic_ofstream&& _Right
);

Parâmetros

_Filename
O nome do arquivo para abrir o.
_Mode
Uma das enumerações em ios_base::openmode.
_Prot
Proteção de abertura do arquivo padrão, equivalente ao parâmetro de shflag em _fsopen, _wfsopen.
_Right
A referência de rvalue ao objeto de basic_ofstream que está sendo usado para inicializar o objeto de basic_ofstream .

Comentários

O primeiro construtor inicializa a classe base chamando basic_ostream(sb), onde sb é o objeto armazenado na classe basic_filebuf<Elem, Tr>.Também inicializa sb chamando basic_filebuf<Elem, Tr>.

O segundo e terceiro construtores inicializam a classe base chamando basic_ostreamsb().Também inicializa sb chamando basic_filebuf<Elem, Tr> e em seguida sb.abrir(_Filename, _Mode | ios_base::out).Se a última função retorna um ponteiro zero, o construtor chama setstatefailbit().

O quarto construtor é uma função de impressão.Inicializa o objeto com o conteúdo de right, tratados como uma referência de rvalue.

Exemplo

O exemplo a seguir mostra como criar um objeto de basic_ofstream e gravar o texto.

// basic_ofstream_ctor.cpp
// compile with: /EHsc
#include <fstream>

using namespace std;

int main(int argc, char **argv)
{
    ofstream ofs("C:\\ofstream.txt");
    if (!ofs.bad())
    {
        ofs << "Writing to a basic_ofstream object..." << endl;
        ofs.close();
    }
}