Bagikan melalui


basic_ofstream Kelas

Menjelaskan objek yang mengontrol penyisipan elemen dan objek yang dikodekan ke dalam buffer aliran kelas basic_filebuf< Elem, Tr>, dengan elemen jenis Elem, yang sifat karakternya ditentukan oleh kelas Tr. Untuk informasi selengkapnya, lihat basic_filebuf .

Sintaks

template <class Elem, class Tr = char_traits<Elem>>
class basic_ofstream : public basic_ostream<Elem, Tr>

Parameter

Elem
Elemen dasar buffer file.

Tr
Ciri-ciri elemen dasar buffer file (biasanya char_traits<Elem>).

Keterangan

wchar_t Ketika spesialisasi penulisan basic_ofstream ke file, jika file dibuka dalam mode teks, itu akan menulis urutan MBCS. Representasi internal akan menggunakan buffer wchar_t karakter.

Objek menyimpan objek kelas basic_filebuf< Elem, Tr>.

Contoh

Contoh berikut menunjukkan cara membuat basic_ofstream objek dan menulis teks ke objek tersebut.

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

using namespace std;

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

Konstruktor

Konstruktor Deskripsi
basic_ofstream Membuat objek jenis basic_ofstream.

Fungsi anggota

Fungsi anggota Deskripsi
close Menutup berkas.
is_open Menentukan apakah file terbuka.
open Membuka file.
rdbuf Mengembalikan alamat buffer aliran tersimpan.
swap Tukarkan isi ini basic_ofstream dengan konten yang disediakan basic_ofstream.

Operator

Operator Deskripsi
operator= Menetapkan isi objek aliran ini. Ini adalah penetapan pemindahan yang rvalue reference melibatkan yang tidak meninggalkan salinan di belakang.

Persyaratan

Header: <fstream>

kumpulan nama XML: std

basic_ofstream::basic_ofstream

Membuat objek jenis 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);

Parameter

_Filename
Nama file yang akan dibuka.

_Mode
Salah satu enumerasi dalam ios_base::openmode.

_Prot
Perlindungan pembukaan file default, setara dengan shflag parameter di _fsopen, _wfsopen.

right
Referensi rvalue ke objek yang basic_ofstream digunakan untuk menginisialisasi objek ini basic_ofstream .

Keterangan

Konstruktor pertama menginisialisasi kelas dasar dengan memanggil basic_ostream(sb), di mana sb adalah objek kelas basic_filebuf< Elem, Tr>yang disimpan . Ini juga menginisialisasi sb dengan memanggil basic_filebufElem<, . Tr>

Konstruktor kedua dan ketiga menginisialisasi kelas dasar dengan memanggil basic_ostream( sb). Ini juga menginisialisasi sb dengan memanggil<Elembasic_filebuf , Tr> lalu .sb.open( _Filename, _Mode | ios_base::out) Jika fungsi terakhir mengembalikan NULL penunjuk, konstruktor akan memanggil setstate(failbit).

Konstruktor keempat adalah fungsi salinan. Ini menginisialisasi objek dengan konten right, diperlakukan sebagai referensi rvalue.

Untuk informasi selengkapnya, lihat basic_ostream, open, and setstate.

Contoh

Contoh berikut menunjukkan cara membuat basic_ofstream objek dan menulis teks ke objek tersebut.

// 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();
    }
}

basic_ofstream::close

Menutup berkas.

void close();

Keterangan

Fungsi anggota memanggil rdbuf->close. Untuk informasi lebih lanjut, lihat rdbuf dan close.

Contoh

Lihat basic_filebuf::close contoh yang menggunakan close.

basic_ofstream::is_open

Menunjukkan apakah file terbuka.

bool is_open() const;

Tampilkan Nilai

true jika file terbuka, false jika tidak.

Keterangan

Fungsi anggota mengembalikan rdbuf->is_open. Untuk informasi lebih lanjut, lihat rdbuf dan is_open.

Contoh

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

int main( )
{
   using namespace std;
   ifstream file;
   // Open and close with a basic_filebuf
   file.rdbuf( )->open( "basic_ofstream_is_open.txt", ios::in );
   file.close( );
   if (file.is_open())
      cout << "it's open" << endl;
   else
      cout << "it's closed" << endl;
}

basic_ofstream::open

Membuka file.

void open(
    const char* _Filename,
    ios_base::openmode _Mode = 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::out,
    int _Prot = (int)ios_base::_Openprot);

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

Parameter

_Filename
Nama file yang akan dibuka.

_Mode
Salah satu enumerasi dalam ios_base::openmode.

_Prot
Perlindungan pembukaan file default, setara dengan shflag parameter di _fsopen, _wfsopen.

Keterangan

Fungsi anggota memanggil rdbuf -> open(_ Filename, _Mode | ios_base::out). Jika fungsi tersebut mengembalikan NULL penunjuk, fungsi akan memanggil setstate(failbit).

Untuk informasi selengkapnya, lihat rdbuf, open, and setstate.

Contoh

Lihat basic_filebuf::open contoh yang menggunakan open.

basic_ofstream::operator=

Menetapkan isi objek aliran ini. Ini adalah penetapan pemindahan yang rvalue reference melibatkan yang tidak meninggalkan salinan di belakang.

basic_ofstream& operator=(basic_ofstream&& right);

Parameter

right
Referensi rvalue ke basic_ofstream objek.

Tampilkan Nilai

Menampilkan *this.

Keterangan

Operator anggota menggantikan konten objek dengan menggunakan konten right, diperlakukan sebagai referensi rvalue.

basic_ofstream::rdbuf

Mengembalikan alamat buffer aliran tersimpan.

basic_filebuf<Elem, Tr> *rdbuf() const

Tampilkan Nilai

Mengembalikan alamat buffer aliran tersimpan.

Contoh

Lihat basic_filebuf::close contoh yang menggunakan rdbuf.

basic_ofstream::swap

Menukar isi dua basic_ofstream objek.

void swap(basic_ofstream& right);

Parameter

right
Referensi lvalue ke objek lain basic_ofstream .

Keterangan

Fungsi anggota bertukar isi objek ini dengan konten right.

Lihat juga

basic_ostream Kelas
Keamanan utas di Pustaka Standar C++
iostream Pemrograman
iostreams Konvensi