basic_filebuf::open
Ouvre un fichier.
basic_filebuf<Elem, Tr> *open(
const char *_Filename,
ios_base::openmode _Mode,
int _Prot = (int)ios_base::_Openprot
);
basic_filebuf<Elem, Tr> *open(
const char *_Filename,
ios_base::openmode _Mode
);
basic_filebuf<Elem, Tr> *open(
const wchar_t *_Filename,
ios_base::openmode _Mode,
int _Prot = (int)ios_base::_Openprot
);
basic_filebuf<Elem, Tr> *open(
const wchar_t *_Filename,
ios_base::openmode _Mode
);
Paramètres
_Filename
Le nom du fichier à ouvrir._Mode
L'une des énumérations dans ios_base::openmode._Prot
La protection d'ouverture de fichier par défaut, l'équivalent du paramètre d' shflag dans _fsopen, _wfsopen.
Valeur de retour
Si le pointeur de fichier est un pointeur null, la fonction retourne un pointeur null.Sinon, il retourne this.
Notes
La fonction membre ouvre le fichier sous le nom du fichierde nom de fichier, en appelant fopen(nom de fichier, strmode).strmode est déterminé à partir de mode &| (un mangé et | binaire) :
ios_base::in devient "r" (fichier existant ouvert pour la lecture).
ios_base::out ou ios_base::out | ios_base::trunc devient "w" (le fichier existant tronqué ou créent pour écrire).
ios_base::out | app devient "a" (fichier existant ouvert pour ajouter toutes écrit).
ios_base::in | ios_base::out devient "r+" (fichier existant ouvert pour lire et écrire).
ios_base::in | ios_base::out | ios_base::trunc devient "w+" (le fichier existant tronqué ou créent pour lire et écrire).
ios_base::in | ios_base::out | ios_base::app devient "a+" (fichier existant ouvert pour lire et pour ajouter toutes écrit).
Si mode & ios_base::binary est différent de zéro, la fonction ajoute b à strmode pour ouvrir un flux binaire au lieu d'un flux de texte.Elle stocke la valeur retournée par fopen dans le pointeur de fichier fp.Si mode & ios_base::ate est différent de zéro et le pointeur de fichier n'est pas un pointeur null, les appels de fonction fseek(fp, 0, SEEK_END) pour positionner le flux de données à de fin de fichier.Si cette opération de positionnement échoue, les appels de fonction fermer(fp) et les stocke un pointeur null dans le pointeur de fichier.
Si le pointeur de fichier n'est pas un pointeur null, la fonction détermine la facette de conversion de fichier : use_facet<codecvt<Elem, char, traits_type::state_type> > (getloc), à des fins de dépassement de capacité et de dépassement.
Si le pointeur de fichier est un pointeur null, la fonction retourne un pointeur null.Sinon, il retourne this.
Exemple
Consultez basic_filebuf::close pour obtenir un exemple qui utilise ouvrir.
Configuration requise
en-tête : <fstream>
l'espace de noms : DST