1 // Iostreams wrapper for stdio FILE* -*- C++ -*-
2 
3 // Copyright (C) 2003, 2004, 2005, 2006, 2007, 2009, 2010
4 // Free Software Foundation, Inc.
5 //
6 // This file is part of the GNU ISO C++ Library.  This library is free
7 // software; you can redistribute it and/or modify it under the
8 // terms of the GNU General Public License as published by the
9 // Free Software Foundation; either version 3, or (at your option)
10 // any later version.
11 
12 // This library is distributed in the hope that it will be useful,
13 // but WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 // GNU General Public License for more details.
16 
17 // Under Section 7 of GPL version 3, you are granted additional
18 // permissions described in the GCC Runtime Library Exception, version
19 // 3.1, as published by the Free Software Foundation.
20 
21 // You should have received a copy of the GNU General Public License and
22 // a copy of the GCC Runtime Library Exception along with this program;
23 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
24 // <http://www.gnu.org/licenses/>.
25 
26 /** @file ext/stdio_sync_filebuf.h
27  *  This file is a GNU extension to the Standard C++ Library.
28  */
29 
30 #ifndef _STDIO_SYNC_FILEBUF_H
31 #define _STDIO_SYNC_FILEBUF_H 1
32 
33 #pragma GCC system_header
34 
35 #include <streambuf>
36 #include <unistd.h>
37 #include <cstdio>
38 #include <bits/c++io.h>  // For __c_file
39 
40 #ifdef _GLIBCXX_USE_WCHAR_T
41 #include <cwchar>
42 #endif
43 
44 namespace __gnu_cxx _GLIBCXX_VISIBILITY(default)
45 {
46 _GLIBCXX_BEGIN_NAMESPACE_VERSION
47 
48   /**
49    *  @brief Provides a layer of compatibility for C.
50    *  @ingroup io
51    *
52    *  This GNU extension provides extensions for working with standard
53    *  C FILE*'s.  It must be instantiated by the user with the type of
54    *  character used in the file stream, e.g., stdio_filebuf<char>.
55   */
56   template<typename _CharT, typename _Traits = std::char_traits<_CharT> >
57     class stdio_sync_filebuf : public std::basic_streambuf<_CharT, _Traits>
58     {
59     public:
60       // Types:
61       typedef _CharT					char_type;
62       typedef _Traits					traits_type;
63       typedef typename traits_type::int_type		int_type;
64       typedef typename traits_type::pos_type		pos_type;
65       typedef typename traits_type::off_type		off_type;
66 
67     private:
68       // Underlying stdio FILE
69       std::__c_file* const _M_file;
70 
71       // Last character gotten. This is used when pbackfail is
72       // called from basic_streambuf::sungetc()
73       int_type _M_unget_buf;
74 
75     public:
76       explicit
77       stdio_sync_filebuf(std::__c_file* __f)
78       : _M_file(__f), _M_unget_buf(traits_type::eof())
79       { }
80 
81       /**
82        *  @return  The underlying FILE*.
83        *
84        *  This function can be used to access the underlying C file pointer.
85        *  Note that there is no way for the library to track what you do
86        *  with the file, so be careful.
87        */
88       std::__c_file* const
89       file() { return this->_M_file; }
90 
91     protected:
92       int_type
93       syncgetc();
94 
95       int_type
96       syncungetc(int_type __c);
97 
98       int_type
99       syncputc(int_type __c);
100 
101       virtual int_type
102       underflow()
103       {
104 	int_type __c = this->syncgetc();
105 	return this->syncungetc(__c);
106       }
107 
108       virtual int_type
109       uflow()
110       {
111 	// Store the gotten character in case we need to unget it.
112 	_M_unget_buf = this->syncgetc();
113 	return _M_unget_buf;
114       }
115 
116       virtual int_type
117       pbackfail(int_type __c = traits_type::eof())
118       {
119 	int_type __ret;
120 	const int_type __eof = traits_type::eof();
121 
122 	// Check if the unget or putback was requested
123 	if (traits_type::eq_int_type(__c, __eof)) // unget
124 	  {
125 	    if (!traits_type::eq_int_type(_M_unget_buf, __eof))
126 	      __ret = this->syncungetc(_M_unget_buf);
127 	    else // buffer invalid, fail.
128 	      __ret = __eof;
129 	  }
130 	else // putback
131 	  __ret = this->syncungetc(__c);
132 
133 	// The buffered character is no longer valid, discard it.
134 	_M_unget_buf = __eof;
135 	return __ret;
136       }
137 
138       virtual std::streamsize
139       xsgetn(char_type* __s, std::streamsize __n);
140 
141       virtual int_type
142       overflow(int_type __c = traits_type::eof())
143       {
144 	int_type __ret;
145 	if (traits_type::eq_int_type(__c, traits_type::eof()))
146 	  {
147 	    if (std::fflush(_M_file))
148 	      __ret = traits_type::eof();
149 	    else
150 	      __ret = traits_type::not_eof(__c);
151 	  }
152 	else
153 	  __ret = this->syncputc(__c);
154 	return __ret;
155       }
156 
157       virtual std::streamsize
158       xsputn(const char_type* __s, std::streamsize __n);
159 
160       virtual int
161       sync()
162       { return std::fflush(_M_file); }
163 
164       virtual std::streampos
165       seekoff(std::streamoff __off, std::ios_base::seekdir __dir,
166 	      std::ios_base::openmode = std::ios_base::in | std::ios_base::out)
167       {
168 	std::streampos __ret(std::streamoff(-1));
169 	int __whence;
170 	if (__dir == std::ios_base::beg)
171 	  __whence = SEEK_SET;
172 	else if (__dir == std::ios_base::cur)
173 	  __whence = SEEK_CUR;
174 	else
175 	  __whence = SEEK_END;
176 #ifdef _GLIBCXX_USE_LFS
177 	if (!fseeko64(_M_file, __off, __whence))
178 	  __ret = std::streampos(ftello64(_M_file));
179 #else
180 	if (!fseek(_M_file, __off, __whence))
181 	  __ret = std::streampos(std::ftell(_M_file));
182 #endif
183 	return __ret;
184       }
185 
186       virtual std::streampos
187       seekpos(std::streampos __pos,
188 	      std::ios_base::openmode __mode =
189 	      std::ios_base::in | std::ios_base::out)
190       { return seekoff(std::streamoff(__pos), std::ios_base::beg, __mode); }
191     };
192 
193   template<>
194     inline stdio_sync_filebuf<char>::int_type
195     stdio_sync_filebuf<char>::syncgetc()
196     { return std::getc(_M_file); }
197 
198   template<>
199     inline stdio_sync_filebuf<char>::int_type
200     stdio_sync_filebuf<char>::syncungetc(int_type __c)
201     { return std::ungetc(__c, _M_file); }
202 
203   template<>
204     inline stdio_sync_filebuf<char>::int_type
205     stdio_sync_filebuf<char>::syncputc(int_type __c)
206     { return std::putc(__c, _M_file); }
207 
208   template<>
209     inline std::streamsize
210     stdio_sync_filebuf<char>::xsgetn(char* __s, std::streamsize __n)
211     {
212       std::streamsize __ret = std::fread(__s, 1, __n, _M_file);
213       if (__ret > 0)
214 	_M_unget_buf = traits_type::to_int_type(__s[__ret - 1]);
215       else
216 	_M_unget_buf = traits_type::eof();
217       return __ret;
218     }
219 
220   template<>
221     inline std::streamsize
222     stdio_sync_filebuf<char>::xsputn(const char* __s, std::streamsize __n)
223     { return std::fwrite(__s, 1, __n, _M_file); }
224 
225 #ifdef _GLIBCXX_USE_WCHAR_T
226   template<>
227     inline stdio_sync_filebuf<wchar_t>::int_type
228     stdio_sync_filebuf<wchar_t>::syncgetc()
229     { return std::getwc(_M_file); }
230 
231   template<>
232     inline stdio_sync_filebuf<wchar_t>::int_type
233     stdio_sync_filebuf<wchar_t>::syncungetc(int_type __c)
234     { return std::ungetwc(__c, _M_file); }
235 
236   template<>
237     inline stdio_sync_filebuf<wchar_t>::int_type
238     stdio_sync_filebuf<wchar_t>::syncputc(int_type __c)
239     { return std::putwc(__c, _M_file); }
240 
241   template<>
242     inline std::streamsize
243     stdio_sync_filebuf<wchar_t>::xsgetn(wchar_t* __s, std::streamsize __n)
244     {
245       std::streamsize __ret = 0;
246       const int_type __eof = traits_type::eof();
247       while (__n--)
248 	{
249 	  int_type __c = this->syncgetc();
250 	  if (traits_type::eq_int_type(__c, __eof))
251 	    break;
252 	  __s[__ret] = traits_type::to_char_type(__c);
253 	  ++__ret;
254 	}
255 
256       if (__ret > 0)
257 	_M_unget_buf = traits_type::to_int_type(__s[__ret - 1]);
258       else
259 	_M_unget_buf = traits_type::eof();
260       return __ret;
261     }
262 
263   template<>
264     inline std::streamsize
265     stdio_sync_filebuf<wchar_t>::xsputn(const wchar_t* __s,
266 					std::streamsize __n)
267     {
268       std::streamsize __ret = 0;
269       const int_type __eof = traits_type::eof();
270       while (__n--)
271 	{
272 	  if (traits_type::eq_int_type(this->syncputc(*__s++), __eof))
273 	    break;
274 	  ++__ret;
275 	}
276       return __ret;
277     }
278 #endif
279 
280 #if _GLIBCXX_EXTERN_TEMPLATE
281   extern template class stdio_sync_filebuf<char>;
282 #ifdef _GLIBCXX_USE_WCHAR_T
283   extern template class stdio_sync_filebuf<wchar_t>;
284 #endif
285 #endif
286 
287 _GLIBCXX_END_NAMESPACE_VERSION
288 } // namespace
289 
290 #endif
291