basic_ofstream::basic_ofstream

Article
06/09/2015

Crée un objet de type 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
);

Paramètres

_Filename
Nom du fichier à ouvrir.
_Mode
L'une des énumérations dans ios_base::openmode.
_Prot
La protection d'ouverture du fichier par défaut, correspondant au paramètre shflag dans _fsopen, _wfsopen.
_Right
La référence de rvalue à l'objet basic_ofstream utilisé pour lancer cet objet basic_ofstream.

Notes

Le premier constructeur initialise la classe de base en appelant basic_ostream(sb), où sb est l'objet stocké de la classe basic_filebuf<Elem, Tr>. Il lance également sb en appelant basic_filebuf<Elem, Tr>.

Les deuxième et troisième constructeurs initialisent la classe de base en appelant basic_ostream(sb). Il lance également sb en appelant basic_filebuf<Elem, Tr> puis sb.open(_Filename, _Mode | ios_base::out). Si la dernière fonction retourne un pointeur null, le constructeur appelle setstate(failbit).

Le quatrième constructeur est une fonction de copie. Il initialise l'objet avec le contenu de right, traité comme référence rvalue.

Exemple

L'exemple suivant montre comment créer un objet basic_ofstream et écrire du texte dans celui-ci.

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