Condividi tramite


basic_filebuf::open

Aprire il file.

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
);

Parametri

  • _Filename
    Il nome del file da aprire.

  • _Mode
    Una delle enumerazioni in ios_base::openmode.

  • _Prot
    La protezione di apertura file predefinito, equivalente al parametro shflag in _fsopen, _wfsopen.

Valore restituito

Se il puntatore del file è un puntatore null, la funzione restituisce un puntatore null.In caso contrario, restituisce this.

Note

La funzione membro viene aperto il file con ilnome file, chiamando fopen(nome file, strmode).strmode è determinato da mode &~ (&è mangiato | binario):

  • ios_base::in diventa "r" (file esistente aperto per la lettura).

  • ios_base::out o ios_base::out | ios_base::trunc diventa "w" (il file esistente troncato o crea per la scrittura).

  • ios_base::out | app diventa "a" (il file esistente aperto per aggiungere tutto scritto).

  • ios_base::in | ios_base::out diventa "r+" (file esistente aperto per la lettura e la scrittura).

  • ios_base::in | ios_base::out | ios_base::trunc diventa "w+" (il file esistente troncato o crea per la lettura e la scrittura).

  • ios_base::in | ios_base::out | ios_base::app diventa "a+" (il file esistente aperto per indicare e aggiungere tutto scritto).

Se mode & ios_base::binary è diverso da zero, la funzione aggiunge b a strmode per aprire un flusso binario anziché un flusso di testo.Quindi archiviare il valore restituito da fopen nel puntatore del file fp.Se mode & ios_base::ate è diverso da zero e il puntatore del file non è un puntatore null, le chiamate di funzione fseek(fp, 0, SEEK_END) per attivare il flusso alla fine di un file.Se tale che consente l'operazione non riesce, le chiamate di funzione fine(fp) e archivi un puntatore null nel puntatore del file.

Se il puntatore del file non è un puntatore null, la funzione determina il facet di conversione di file: use_facet<codecvt<Elem, char, traits_type::state_type> > (getloc), da underflow e overflow.

Se il puntatore del file è un puntatore null, la funzione restituisce un puntatore null.In caso contrario, restituisce this.

Esempio

Vedere basic_filebuf::close per un esempio che utilizza open.

Requisiti

intestazione: <fstream>

Spazio dei nomi: deviazione standard

Vedere anche

Riferimenti

basic_filebuf Class

programmazione di iostream

convenzioni di iostream