basic_ofstream::basic_ofstream

Artigo
06/09/2015

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 a ser aberta.
_Mode
Uma das enumerações em ios_base::openmode.
_Prot
A 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 este objeto de basic_ofstream .

Comentários

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

O segundo e o terceiro construtores inicializar a classe basesbchamando basic_ostream(). Também inicializa sb chamando basic_filebuf<Elem, Tr> e depois sb.aberto(_Filename, _Mode | ios_base::out). Se a última função retorna um ponteiro nulo, o construtor setstatechama (failbit).

O quarto construtor é uma função de cópia. 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 ser gravada nele e 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();
    }
}