summaryrefslogtreecommitdiffstats
path: root/libstdc++-v3/include/std/std_fstream.h
diff options
context:
space:
mode:
authorpaolo <paolo@138bc75d-0d04-0410-961f-82ee72b054a4>2003-07-06 11:24:43 +0000
committerpaolo <paolo@138bc75d-0d04-0410-961f-82ee72b054a4>2003-07-06 11:24:43 +0000
commit3b2e396d1023315f275d04017792c60e5c5ff4cd (patch)
tree4286fb9953f97df2c47795c2236e847a4de109f2 /libstdc++-v3/include/std/std_fstream.h
parentcf7531e65cb07a5a55f55d21f65a832cea49b5a9 (diff)
downloadppe42-gcc-3b2e396d1023315f275d04017792c60e5c5ff4cd.tar.gz
ppe42-gcc-3b2e396d1023315f275d04017792c60e5c5ff4cd.zip
2003-07-06 Paolo Carlini <pcarlini@unitus.it>
* include/std/std_fstream.h (xsputn): Don't call _M_destroy_pback: if output is at all possible (!_M_reading), cannot be active. * include/std/std_fstream.h: Tweak comments to doxygen style. git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@69001 138bc75d-0d04-0410-961f-82ee72b054a4
Diffstat (limited to 'libstdc++-v3/include/std/std_fstream.h')
-rw-r--r--libstdc++-v3/include/std/std_fstream.h49
1 files changed, 29 insertions, 20 deletions
diff --git a/libstdc++-v3/include/std/std_fstream.h b/libstdc++-v3/include/std/std_fstream.h
index 0e9f99ce80c..209be67bd57 100644
--- a/libstdc++-v3/include/std/std_fstream.h
+++ b/libstdc++-v3/include/std/std_fstream.h
@@ -177,9 +177,13 @@ namespace std
// Cached codecvt facet.
const __codecvt_type* _M_codecvt;
- // Initializes pback buffers, and moves normal buffers to safety.
- // Assumptions:
- // _M_in_cur has already been moved back
+ /**
+ * @if maint
+ * Initializes pback buffers, and moves normal buffers to safety.
+ * Assumptions:
+ * _M_in_cur has already been moved back
+ * @endif
+ */
void
_M_create_pback()
{
@@ -192,9 +196,13 @@ namespace std
}
}
- // Deactivates pback buffer contents, and restores normal buffer.
- // Assumptions:
- // The pback buffer has only moved forward.
+ /**
+ * @if maint
+ * Deactivates pback buffer contents, and restores normal buffer.
+ * Assumptions:
+ * The pback buffer has only moved forward.
+ * @endif
+ */
void
_M_destroy_pback() throw()
{
@@ -400,10 +408,7 @@ namespace std
// [documentation is inherited]
virtual streamsize
xsputn(const char_type* __s, streamsize __n)
- {
- _M_destroy_pback();
- return __streambuf_type::xsputn(__s, __n);
- }
+ { return __streambuf_type::xsputn(__s, __n); }
/**
* @if maint
@@ -413,16 +418,20 @@ namespace std
void
_M_output_unshift();
- // This function sets the pointers of the internal buffer, both get
- // and put areas. Typically:
- //
- // __off == egptr() - eback() upon underflow/uflow ('read' mode);
- // __off == 0 upon overflow ('write' mode);
- // __off == -1 upon open, setbuf, seekoff/pos ('uncommitted' mode).
- //
- // NB: epptr() - pbase() == _M_buf_size - 1, since _M_buf_size
- // reflects the actual allocated memory and the last cell is reserved
- // for the overflow char of a full put area.
+ /**
+ * @if maint
+ * This function sets the pointers of the internal buffer, both get
+ * and put areas. Typically:
+ *
+ * __off == egptr() - eback() upon underflow/uflow ('read' mode);
+ * __off == 0 upon overflow ('write' mode);
+ * __off == -1 upon open, setbuf, seekoff/pos ('uncommitted' mode).
+ *
+ * NB: epptr() - pbase() == _M_buf_size - 1, since _M_buf_size
+ * reflects the actual allocated memory and the last cell is reserved
+ * for the overflow char of a full put area.
+ * @endif
+ */
void
_M_set_buffer(streamsize __off)
{
OpenPOWER on IntegriCloud