1// Wrapper of C-language FILE struct -*- C++ -*- 2 3// Copyright (C) 2000-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// 26// ISO C++ 14882: 27.8 File-based streams 27// 28 29/** @file bits/basic_file.h 30 * This is an internal header file, included by other library headers. 31 * Do not attempt to use it directly. @headername{ios} 32 */ 33 34#ifndef _GLIBCXX_BASIC_FILE_STDIO_H 35#define _GLIBCXX_BASIC_FILE_STDIO_H 1 36 37#pragma GCC system_header 38 39#include <bits/c++config.h> 40#include <bits/c++io.h> // for __c_lock and __c_file 41#include <bits/move.h> // for swap 42#include <ios> 43 44namespace std _GLIBCXX_VISIBILITY(default) 45{ 46_GLIBCXX_BEGIN_NAMESPACE_VERSION 47 48 // Generic declaration. 49 template<typename _CharT> 50 class __basic_file; 51 52 // Specialization. 53 template<> 54 class __basic_file<char> 55 { 56 // Underlying data source/sink. 57 __c_file* _M_cfile; 58 59 // True iff we opened _M_cfile, and thus must close it ourselves. 60 bool _M_cfile_created; 61 62 public: 63 __basic_file(__c_lock* __lock = 0) throw (); 64 65#if __cplusplus >= 201103L 66 __basic_file(__basic_file&& __rv, __c_lock* = 0) noexcept 67 : _M_cfile(__rv._M_cfile), _M_cfile_created(__rv._M_cfile_created) 68 { 69 __rv._M_cfile = nullptr; 70 __rv._M_cfile_created = false; 71 } 72 73 __basic_file& operator=(const __basic_file&) = delete; 74 __basic_file& operator=(__basic_file&&) = delete; 75 76 void 77 swap(__basic_file& __f) noexcept 78 { 79 std::swap(_M_cfile, __f._M_cfile); 80 std::swap(_M_cfile_created, __f._M_cfile_created); 81 } 82#endif 83 84 __basic_file* 85 open(const char* __name, ios_base::openmode __mode, int __prot = 0664); 86 87#if _GLIBCXX_HAVE__WFOPEN && _GLIBCXX_USE_WCHAR_T 88 __basic_file* 89 open(const wchar_t* __name, ios_base::openmode __mode); 90#endif 91 92 __basic_file* 93 sys_open(__c_file* __file, ios_base::openmode); 94 95 __basic_file* 96 sys_open(int __fd, ios_base::openmode __mode) throw (); 97 98 __basic_file* 99 close(); 100 101 _GLIBCXX_PURE bool 102 is_open() const throw (); 103 104 _GLIBCXX_PURE int 105 fd() throw (); 106 107 _GLIBCXX_PURE __c_file* 108 file() throw (); 109 110 ~__basic_file(); 111 112 streamsize 113 xsputn(const char* __s, streamsize __n); 114 115 streamsize 116 xsputn_2(const char* __s1, streamsize __n1, 117 const char* __s2, streamsize __n2); 118 119 streamsize 120 xsgetn(char* __s, streamsize __n); 121 122 streamoff 123 seekoff(streamoff __off, ios_base::seekdir __way) throw (); 124 125 int 126 sync(); 127 128 streamsize 129 showmanyc(); 130 }; 131 132_GLIBCXX_END_NAMESPACE_VERSION 133} // namespace 134 135#endif 136