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.
Возвращаемое значение
Если указатель файла является указателем null, то функция возвращает указатель null.В противном случае возвращается this.
Заметки
Функция-член открывает файл с именем файла имени файла, путем вызова fopen(имя файла, strmode).strmode определяется из mode &| (съел & | бинарный):
ios_base::in будет "r" (открытый существующим файлом для чтения).
ios_base::out или ios_base::out | ios_base::trunc будут "w" (усеченный существующий файл или создает для записи).
ios_base::out | app будет "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+" существующим файлом (открытый для чтения и для добавления все записи).
Если не равен нулю, то mode & ios_base::бинарный добавления b функции к strmode для открытия является поток, а не текстового потока.Затем он хранит значение, возвращаемое fopen в указателе файла fp.Если mode & ios_base::ate ненулевое значение и указатель файла не является указателем null, то вызовы функций fseek(fp, 0, SEEK_END) для позиционирования поток в конец файла.Если эта операция размещения завершается неудачей, то вызовы функций закрыть(fp) и магазины указатель null в указателе файла.
Если указатель файла не является указателем null, функция задает аспект преобразования файла: <Elemcodecvt< use_facet, char, > > traits_type::state_type(getloc) для использования потеря значимости и переполнение.
Если указатель файла является указателем null, то функция возвращает указатель null.В противном случае возвращается this.
Пример
См. раздел basic_filebuf::close пример, использующий open.
Требования
заголовок: <fstream>
std пространство имен: