libstdc++
streambuf.tcc
Go to the documentation of this file.
1// Stream buffer classes -*- C++ -*-
2
3// Copyright (C) 1997-2022 Free Software Foundation, Inc.
4//
5// This file is part of the GNU ISO C++ Library. This library is free
6// software; you can redistribute it and/or modify it under the
7// terms of the GNU General Public License as published by the
8// Free Software Foundation; either version 3, or (at your option)
9// any later version.
10
11// This library is distributed in the hope that it will be useful,
12// but WITHOUT ANY WARRANTY; without even the implied warranty of
13// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14// GNU General Public License for more details.
15
16// Under Section 7 of GPL version 3, you are granted additional
17// permissions described in the GCC Runtime Library Exception, version
18// 3.1, as published by the Free Software Foundation.
19
20// You should have received a copy of the GNU General Public License and
21// a copy of the GCC Runtime Library Exception along with this program;
22// see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
23// <http://www.gnu.org/licenses/>.
24
25/** @file bits/streambuf.tcc
26 * This is an internal header file, included by other library headers.
27 * Do not attempt to use it directly. @headername{streambuf}
28 */
29
30//
31// ISO C++ 14882: 27.5 Stream buffers
32//
33
34#ifndef _STREAMBUF_TCC
35#define _STREAMBUF_TCC 1
36
37#pragma GCC system_header
38
39namespace std _GLIBCXX_VISIBILITY(default)
40{
41_GLIBCXX_BEGIN_NAMESPACE_VERSION
42
43 template<typename _CharT, typename _Traits>
47 {
48 streamsize __ret = 0;
49 while (__ret < __n)
50 {
51 const streamsize __buf_len = this->egptr() - this->gptr();
52 if (__buf_len)
53 {
54 const streamsize __remaining = __n - __ret;
55 const streamsize __len = std::min(__buf_len, __remaining);
56 traits_type::copy(__s, this->gptr(), __len);
57 __ret += __len;
58 __s += __len;
59 this->__safe_gbump(__len);
60 }
61
62 if (__ret < __n)
63 {
64 const int_type __c = this->uflow();
65 if (!traits_type::eq_int_type(__c, traits_type::eof()))
66 {
67 traits_type::assign(*__s++, traits_type::to_char_type(__c));
68 ++__ret;
69 }
70 else
71 break;
72 }
73 }
74 return __ret;
75 }
76
77 template<typename _CharT, typename _Traits>
80 xsputn(const char_type* __s, streamsize __n)
81 {
82 streamsize __ret = 0;
83 while (__ret < __n)
84 {
85 const streamsize __buf_len = this->epptr() - this->pptr();
86 if (__buf_len)
87 {
88 const streamsize __remaining = __n - __ret;
89 const streamsize __len = std::min(__buf_len, __remaining);
90 traits_type::copy(this->pptr(), __s, __len);
91 __ret += __len;
92 __s += __len;
93 this->__safe_pbump(__len);
94 }
95
96 if (__ret < __n)
97 {
98 int_type __c = this->overflow(traits_type::to_int_type(*__s));
99 if (!traits_type::eq_int_type(__c, traits_type::eof()))
100 {
101 ++__ret;
102 ++__s;
103 }
104 else
105 break;
106 }
107 }
108 return __ret;
109 }
110
111 // Conceivably, this could be used to implement buffer-to-buffer
112 // copies, if this was ever desired in an un-ambiguous way by the
113 // standard.
114 template<typename _CharT, typename _Traits>
116 __copy_streambufs_eof(basic_streambuf<_CharT, _Traits>* __sbin,
118 bool& __ineof)
119 {
120 streamsize __ret = 0;
121 __ineof = true;
122 typename _Traits::int_type __c = __sbin->sgetc();
123 while (!_Traits::eq_int_type(__c, _Traits::eof()))
124 {
125 __c = __sbout->sputc(_Traits::to_char_type(__c));
126 if (_Traits::eq_int_type(__c, _Traits::eof()))
127 {
128 __ineof = false;
129 break;
130 }
131 ++__ret;
132 __c = __sbin->snextc();
133 }
134 return __ret;
135 }
136
137 template<typename _CharT, typename _Traits>
138 inline streamsize
139 __copy_streambufs(basic_streambuf<_CharT, _Traits>* __sbin,
140 basic_streambuf<_CharT, _Traits>* __sbout)
141 {
142 bool __ineof;
143 return __copy_streambufs_eof(__sbin, __sbout, __ineof);
144 }
145
146 // Inhibit implicit instantiations for required instantiations,
147 // which are defined via explicit instantiations elsewhere.
148#if _GLIBCXX_EXTERN_TEMPLATE
149 extern template class basic_streambuf<char>;
150
151 extern template
153 __copy_streambufs(basic_streambuf<char>*,
154 basic_streambuf<char>*);
155
156#ifdef _GLIBCXX_USE_WCHAR_T
157 extern template class basic_streambuf<wchar_t>;
158
159 extern template
161 __copy_streambufs(basic_streambuf<wchar_t>*,
162 basic_streambuf<wchar_t>*);
163#endif
164#endif
165
166_GLIBCXX_END_NAMESPACE_VERSION
167} // namespace std
168
169#endif
constexpr const _Tp & min(const _Tp &, const _Tp &)
This does what you think it does.
Definition: stl_algobase.h:230
ISO C++ entities toplevel namespace is std.
ptrdiff_t streamsize
Integral type for I/O operation counts and buffer sizes.
Definition: postypes.h:68
The actual work of input and output (interface).
Definition: streambuf:125
traits_type::int_type int_type
Definition: streambuf:135
virtual streamsize xsputn(const char_type *__s, streamsize __n)
Multiple character insertion.
Definition: streambuf.tcc:80
virtual streamsize xsgetn(char_type *__s, streamsize __n)
Multiple character extraction.
Definition: streambuf.tcc:46
int_type snextc()
Getting the next character.
Definition: streambuf:305
int_type sgetc()
Getting the next character.
Definition: streambuf:345
int_type sputc(char_type __c)
Entry point for all single-character output functions.
Definition: streambuf:431