Init

cppdraft/fstream/general.md

@@ -0,0 +1,41 @@
+[fstream.general]
+
+# 31 Input/output library [[input.output]](./#input.output)
+
+## 31.10 File-based streams [[file.streams]](file.streams#fstream.general)
+
+### 31.10.6 Class template basic_fstream [[fstream]](fstream#general)
+
+#### 31.10.6.1 General [fstream.general]
+
+[🔗](#lib:basic_fstream)
+
+namespace std {template<class charT, class traits = char_traits<charT>>class basic_fstream : public basic_iostream<charT, traits> {public:using char_type = charT; using int_type = typename traits::int_type; using pos_type = typename traits::pos_type; using off_type = typename traits::off_type; using traits_type = traits; using native_handle_type = typename basic_filebuf<charT, traits>::native_handle_type; // [[fstream.cons]](fstream.cons "31.10.6.2 Constructors"), constructors basic_fstream(); explicit basic_fstream(const char* s,
+ ios_base::openmode mode = ios_base::in | ios_base::out); explicit basic_fstream(const filesystem::path::value_type* s,
+ ios_base::openmode mode = ios_base::in | ios_base::out); // wide systems only; see [[fstream.syn]](fstream.syn "31.10.1 Header <fstream> synopsis")explicit basic_fstream(const string& s,
+ ios_base::openmode mode = ios_base::in | ios_base::out); template<class T>explicit basic_fstream(const T& s, ios_base::openmode mode = ios_base::in | ios_base::out);
+ basic_fstream(const basic_fstream&) = delete;
+ basic_fstream(basic_fstream&& rhs);
+
+ basic_fstream& operator=(const basic_fstream&) = delete;
+ basic_fstream& operator=(basic_fstream&& rhs); // [[fstream.swap]](fstream.swap "31.10.6.3 Swap"), swapvoid swap(basic_fstream& rhs); // [[fstream.members]](fstream.members "31.10.6.4 Member functions"), members basic_filebuf<charT, traits>* rdbuf() const;
+ native_handle_type native_handle() const noexcept; bool is_open() const; void open(const char* s,
+ ios_base::openmode mode = ios_base::in | ios_base::out); void open(const filesystem::path::value_type* s,
+ ios_base::openmode mode = ios_base::in | ios_base::out); // wide systems only; see [[fstream.syn]](fstream.syn "31.10.1 Header <fstream> synopsis")void open(const string& s,
+ ios_base::openmode mode = ios_base::in | ios_base::out); void open(const filesystem::path& s,
+ ios_base::openmode mode = ios_base::in | ios_base::out); void close(); private: basic_filebuf<charT, traits> *sb*; // *exposition only*};}
+
+[1](#1)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iostreams.tex#L12347)
+
+The
+class templatebasic_fstream<charT, traits> supports reading and writing from named files[.](#1.sentence-1)
+
+It uses abasic_filebuf<charT, traits> object to control the associated sequences[.](#1.sentence-2)
+
+For the sake of exposition, the maintained data is presented here as:
+
+- [(1.1)](#1.1)
+
+*sb*, the basic_filebuf object[.](#1.sentence-3)