basic_fstream Classe

Descreve um objeto que controla a inserção e extração de elementos e objetos codificados usando um buffer de fluxo de classe basic_filebuf<Elem, Tr>, com elementos do tipo Elem, cujos traços de caractere são determinados pela classe Tr.

Sintaxe

template <class Elem, class Tr = char_traits<Elem>>
class basic_fstream : public basic_iostream<Elem, Tr>

Parâmetros

Elem
O elemento básico do buffer de arquivos.

Tr
As características do elemento básico do buffer de arquivos (geralmente char_traits<Elem>).

Observações

O objeto armazena um objeto de classe basic_filebuf<Elem, . Tr>

Exemplo

O exemplo a seguir demonstra como criar um basic_fstream objeto que pode ser lido e gravado.

// basic_fstream_class.cpp
// compile with: /EHsc

#include <fstream>
#include <iostream>

using namespace std;

int main(int argc, char **argv)
{
    fstream fs("fstream.txt", ios::in | ios::out | ios::trunc);
    if (!fs.bad())
    {
        // Write to the file.
        fs << "Writing to a basic_fstream object..." << endl;
        fs.close();

        // Dump the contents of the file to cout.
        fs.open("fstream.txt", ios::in);
        cout << fs.rdbuf();
        fs.close();
    }
}

Writing to a basic_fstream object...

Construtores

Funções de membro

Requerimentos

Cabeçalho:<fstream>

Espaço de nomes: std

basic_fstream::basic_fstream

Constrói um objeto do tipo basic_fstream.

basic_fstream();

explicit basic_fstream(
    const char* _Filename,
    ios_base::openmode _Mode = ios_base::in | ios_base::out,
    int _Prot = (int)ios_base::_Openprot);

explicit basic_fstream(
    const wchar_t* _Filename,
    ios_base::openmode _Mode = ios_base::in | ios_base::out,
    int _Prot = (int)ios_base::_Openprot);

basic_fstream(basic_fstream&& right);

Parâmetros

_Filename
O nome do arquivo a ser aberto.

_Mode
Uma das enumerações em ios_base::openmode.

_Prot
A proteção de abertura de arquivo padrão, equivalente ao parâmetro shflag no _fsopen, _wfsopen.

Observações

O primeiro construtor inicializa a classe base chamando basic_iostream(sb), onde sb é o objeto armazenado da classe basic_filebuf<Elem, Tr>. Ele também inicializa sb chamando basic_filebuf<Elem, Tr>.

O segundo e terceiro construtores inicializa a classe base chamando basic_iostream( sb). Ele também inicializa sb chamando basic_filebuf<Elem, Tr> e, em seguida, sb.open(_ Nome do arquivo, _Mode). Se a última função retorna um ponteiro nulo, o construtor chama setstate(failbit).

O quarto construtor inicializa o objeto com o conteúdo de , tratado como uma referência rvalue right.

Exemplo

Consulte streampos para obter um exemplo que usa basic_fstreamo .

basic_fstream::fechar

Fecha um arquivo.

void close();

Observações

A função de membro chama rdbuf-close>.

Exemplo

Consulte basic_filebuf::close para obter um exemplo de como usar closeo .

basic_fstream::is_open

Determina se um arquivo está aberto.

bool is_open() const;

Valor de retorno

true se o arquivo estiver aberto, false caso contrário.

Observações

A função de membro retorna rdbuf-is_open>.

Exemplo

Consulte basic_filebuf::is_open para obter um exemplo de como usar is_openo .

basic_fstream::aberto

Abre um arquivo.

void open(
    const char* _Filename,
    ios_base::openmode _Mode = ios_base::in | ios_base::out,
    int _Prot = (int)ios_base::_Openprot);

void open(
    const char* _Filename,
    ios_base::openmode _Mode);

void open(
    const wchar_t* _Filename,
    ios_base::openmode _Mode = ios_base::in | ios_base::out,
    int _Prot = (int)ios_base::_Openprot);

void open(
    const wchar_t* _Filename,
    ios_base::openmode _Mode);

Parâmetros

_Filename
O nome do arquivo a ser aberto.

_Mode
Uma das enumerações em ios_base::openmode.

_Prot
A proteção de abertura de arquivo padrão, equivalente ao parâmetro shflag no _fsopen, _wfsopen.

Observações

A função de membro chama rdbuf-open>(_ Nome do arquivo, _Mode). Se essa função retornar um ponteiro nulo, a função chamará setstate(failbit).

Exemplo

Consulte basic_filebuf::open para obter um exemplo de como usar openo .

basic_fstream::operador=

Atribui a este objeto o conteúdo de um objeto de fluxo especificado. Esta é uma atribuição de movimento que envolve um valor de rvalue que não deixa uma cópia para trás.

basic_fstream& operator=(basic_fstream&& right);

Parâmetros

direito
Uma referência lvalue a um basic_fstream objeto.

Valor de retorno

Retorna *this.

Observações

O operador membro substitui o conteúdo do objeto usando o conteúdo do direito, tratado como uma referência de rvalue.

basic_fstream::rdbuf

Retorna o endereço do buffer de fluxo armazenado, do tipo ponteiro para basic_filebuf<Elem, Tr>.

basic_filebuf<Elem, Tr> *rdbuf() const

Valor de retorno

O endereço do buffer de fluxo armazenado.

Exemplo

Consulte basic_filebuf::close para obter um exemplo de como usar rdbufo .

basic_fstream::swap

Troca o conteúdo de dois basic_fstream objetos.

void swap(basic_fstream& right);

Parâmetros

direito
Uma lvalue referência a um basic_fstream objeto.

Observações

A função de membro troca o conteúdo deste objeto e o conteúdo do direito.

Ver também

segurança de threads na biblioteca padrão C++
Programação iostream
iostreams Convenções