Поделиться через


basic_filebuf::open

Открывает файл.

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

Параметры

  • _Filename
    Имя файла, который необходимо открыть.

  • _Mode
    Одно из перечислений в ios_base::openmode.

  • _Prot
    Защита от открытия файла по умолчанию, соответствующее параметру shflag в _fsopen, _wfsopen.

Возвращаемое значение

Если указатель файла указатель, функция возвращает указатель. В противном случае он возвращает значение this.

Заметки

Функция-член будет открыт файл с именем файла имени файла, путем вызова fopen(имя файла, strmode). strmode определяется из режим &| (ate& | бинарный).

  • "r" (ios_base::in становится открытым существующим файлом для чтения).

  • ios_base::out или ios_base::out | ios_base::trunc будет "w" (усечения существующий файл или создания для записи).

  • ios_base::out | приложение будет "a" (открыть существующий файл для добавления все записи).

  • ios_base::in | ios_base::out будет "r+" (открытым существующим файлом для чтения и записи).

  • ios_base::in | ios_base::out | ios_base::trunc будет "w+" (усечения существующий файл или создания для чтения и записи).

  • ios_base::in | ios_base::out | ios_base::app будет "a+" (открыть существующий файл для чтения и добавления все записи).

Если режим & ios_base::бинарный отличное от нуля, то функция b добавляет к strmode, чтобы открыть двоичный поток вместо текстового потока. Затем он хранит значение, fopen в указателе файла fp. Если режим & ios_base::ate отличное от нуля и указатель файла не пустых указателей, вызовы функций fseek(fp, 0, SEEK_END) для размещения поток в конец файла. Если эта операция перетаскивания завершается ошибкой, вызовы функций закрыть(fp) и сохраняют указатель в указателе файла.

Если указатель файла не пустых указателей, функция задает аспект преобразования файла: use_facet<codecvt<Elem, **traits_type::**char,state_type> >(getloc), для использования потеря значимости и переполнение.

Если указатель файла указатель, функция возвращает указатель. В противном случае он возвращает значение this.

Пример

См. basic_filebuf::close. пример, использующий open.

Требования

Заголовок:<fstream>

Пространство имен: std

См. также

Ссылки

Класс basic_filebuf

Программирование iostream

Соглашения iostreams