1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>LCOV - lcov.info - /usr/include/c++/4.3/fstream</title>
<link rel="stylesheet" type="text/css" href="../../../../gcov.css">
</head>
<body>
<table width="100%" border=0 cellspacing=0 cellpadding=0>
<tr><td class="title">LTP GCOV extension - code coverage report</td></tr>
<tr><td class="ruler"><img src="../../../../glass.png" width=3 height=3 alt=""></td></tr>
<tr>
<td width="100%">
<table cellpadding=1 border=0 width="100%">
<tr>
<td class="headerItem" width="20%">Current view:</td>
<td class="headerValue" width="80%" colspan=4><a href="../../../../index.html">directory</a> - <a href="index.html">usr/include/c++/4.3</a> - fstream</td>
</tr>
<tr>
<td class="headerItem" width="20%">Test:</td>
<td class="headerValue" width="80%" colspan=4>lcov.info</td>
</tr>
<tr>
<td class="headerItem" width="20%">Date:</td>
<td class="headerValue" width="20%">2008-08-14</td>
<td width="20%"></td>
<td class="headerItem" width="20%">Instrumented lines:</td>
<td class="headerValue" width="20%">38</td>
</tr>
<tr>
<td class="headerItem" width="20%">Code covered:</td>
<td class="headerValue" width="20%">0.0 %</td>
<td width="20%"></td>
<td class="headerItem" width="20%">Executed lines:</td>
<td class="headerValue" width="20%">0</td>
</tr>
</table>
</td>
</tr>
<tr><td class="ruler"><img src="../../../../glass.png" width=3 height=3 alt=""></td></tr>
</table>
<table cellpadding=0 cellspacing=0 border=0>
<tr>
<td><br></td>
</tr>
<tr>
<td><pre class="source">
<span class="lineNum"> 1 </span> : // File based streams -*- C++ -*-
<span class="lineNum"> 2 </span> :
<span class="lineNum"> 3 </span> : // Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
<span class="lineNum"> 4 </span> : // 2006, 2007, 2008
<span class="lineNum"> 5 </span> : // Free Software Foundation, Inc.
<span class="lineNum"> 6 </span> : //
<span class="lineNum"> 7 </span> : // This file is part of the GNU ISO C++ Library. This library is free
<span class="lineNum"> 8 </span> : // software; you can redistribute it and/or modify it under the
<span class="lineNum"> 9 </span> : // terms of the GNU General Public License as published by the
<span class="lineNum"> 10 </span> : // Free Software Foundation; either version 2, or (at your option)
<span class="lineNum"> 11 </span> : // any later version.
<span class="lineNum"> 12 </span> :
<span class="lineNum"> 13 </span> : // This library is distributed in the hope that it will be useful,
<span class="lineNum"> 14 </span> : // but WITHOUT ANY WARRANTY; without even the implied warranty of
<span class="lineNum"> 15 </span> : // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
<span class="lineNum"> 16 </span> : // GNU General Public License for more details.
<span class="lineNum"> 17 </span> :
<span class="lineNum"> 18 </span> : // You should have received a copy of the GNU General Public License
<span class="lineNum"> 19 </span> : // along with this library; see the file COPYING. If not, write to
<span class="lineNum"> 20 </span> : // the Free Software Foundation, 51 Franklin Street, Fifth Floor,
<span class="lineNum"> 21 </span> : // Boston, MA 02110-1301, USA.
<span class="lineNum"> 22 </span> :
<span class="lineNum"> 23 </span> : // As a special exception, you may use this file as part of a free software
<span class="lineNum"> 24 </span> : // library without restriction. Specifically, if other files instantiate
<span class="lineNum"> 25 </span> : // templates or use macros or inline functions from this file, or you compile
<span class="lineNum"> 26 </span> : // this file and link it with other files to produce an executable, this
<span class="lineNum"> 27 </span> : // file does not by itself cause the resulting executable to be covered by
<span class="lineNum"> 28 </span> : // the GNU General Public License. This exception does not however
<span class="lineNum"> 29 </span> : // invalidate any other reasons why the executable file might be covered by
<span class="lineNum"> 30 </span> : // the GNU General Public License.
<span class="lineNum"> 31 </span> :
<span class="lineNum"> 32 </span> : /** @file fstream
<span class="lineNum"> 33 </span> : * This is a Standard C++ Library header.
<span class="lineNum"> 34 </span> : */
<span class="lineNum"> 35 </span> :
<span class="lineNum"> 36 </span> : //
<span class="lineNum"> 37 </span> : // ISO C++ 14882: 27.8 File-based streams
<span class="lineNum"> 38 </span> : //
<span class="lineNum"> 39 </span> :
<span class="lineNum"> 40 </span> : #ifndef _GLIBCXX_FSTREAM
<span class="lineNum"> 41 </span> : #define _GLIBCXX_FSTREAM 1
<span class="lineNum"> 42 </span> :
<span class="lineNum"> 43 </span> : #pragma GCC system_header
<span class="lineNum"> 44 </span> :
<span class="lineNum"> 45 </span> : #include <istream>
<span class="lineNum"> 46 </span> : #include <ostream>
<span class="lineNum"> 47 </span> : #include <bits/codecvt.h>
<span class="lineNum"> 48 </span> : #include <cstdio> // For BUFSIZ
<span class="lineNum"> 49 </span> : #include <bits/basic_file.h> // For __basic_file, __c_lock
<span class="lineNum"> 50 </span> :
<span class="lineNum"> 51 </span> : _GLIBCXX_BEGIN_NAMESPACE(std)
<span class="lineNum"> 52 </span> :
<span class="lineNum"> 53 </span> : // [27.8.1.1] template class basic_filebuf
<span class="lineNum"> 54 </span> : /**
<span class="lineNum"> 55 </span> : * @brief The actual work of input and output (for files).
<span class="lineNum"> 56 </span> : *
<span class="lineNum"> 57 </span> : * This class associates both its input and output sequence with an
<span class="lineNum"> 58 </span> : * external disk file, and maintains a joint file position for both
<span class="lineNum"> 59 </span> : * sequences. Many of its semantics are described in terms of similar
<span class="lineNum"> 60 </span> : * behavior in the Standard C Library's @c FILE streams.
<span class="lineNum"> 61 </span> : */
<span class="lineNum"> 62 </span> : // Requirements on traits_type, specific to this class:
<span class="lineNum"> 63 </span> : // traits_type::pos_type must be fpos<traits_type::state_type>
<span class="lineNum"> 64 </span> : // traits_type::off_type must be streamoff
<span class="lineNum"> 65 </span> : // traits_type::state_type must be Assignable and DefaultConstructible,
<span class="lineNum"> 66 </span> : // and traits_type::state_type() must be the initial state for codecvt.
<span class="lineNum"> 67 </span> : template<typename _CharT, typename _Traits>
<span class="lineNum"> 68 </span> : class basic_filebuf : public basic_streambuf<_CharT, _Traits>
<span class="lineNum"> 69 </span> : {
<span class="lineNum"> 70 </span> : public:
<span class="lineNum"> 71 </span> : // Types:
<span class="lineNum"> 72 </span> : typedef _CharT char_type;
<span class="lineNum"> 73 </span> : typedef _Traits traits_type;
<span class="lineNum"> 74 </span> : typedef typename traits_type::int_type int_type;
<span class="lineNum"> 75 </span> : typedef typename traits_type::pos_type pos_type;
<span class="lineNum"> 76 </span> : typedef typename traits_type::off_type off_type;
<span class="lineNum"> 77 </span> :
<span class="lineNum"> 78 </span> : typedef basic_streambuf<char_type, traits_type> __streambuf_type;
<span class="lineNum"> 79 </span> : typedef basic_filebuf<char_type, traits_type> __filebuf_type;
<span class="lineNum"> 80 </span> : typedef __basic_file<char> __file_type;
<span class="lineNum"> 81 </span> : typedef typename traits_type::state_type __state_type;
<span class="lineNum"> 82 </span> : typedef codecvt<char_type, char, __state_type> __codecvt_type;
<span class="lineNum"> 83 </span> :
<span class="lineNum"> 84 </span> : friend class ios_base; // For sync_with_stdio.
<span class="lineNum"> 85 </span> :
<span class="lineNum"> 86 </span> : protected:
<span class="lineNum"> 87 </span> : // Data Members:
<span class="lineNum"> 88 </span> : // MT lock inherited from libio or other low-level io library.
<span class="lineNum"> 89 </span> : __c_lock _M_lock;
<span class="lineNum"> 90 </span> :
<span class="lineNum"> 91 </span> : // External buffer.
<span class="lineNum"> 92 </span> : __file_type _M_file;
<span class="lineNum"> 93 </span> :
<span class="lineNum"> 94 </span> : /// Place to stash in || out || in | out settings for current filebuf.
<span class="lineNum"> 95 </span> : ios_base::openmode _M_mode;
<span class="lineNum"> 96 </span> :
<span class="lineNum"> 97 </span> : // Beginning state type for codecvt.
<span class="lineNum"> 98 </span> : __state_type _M_state_beg;
<span class="lineNum"> 99 </span> :
<span class="lineNum"> 100 </span> : // During output, the state that corresponds to pptr(),
<span class="lineNum"> 101 </span> : // during input, the state that corresponds to egptr() and
<span class="lineNum"> 102 </span> : // _M_ext_next.
<span class="lineNum"> 103 </span> : __state_type _M_state_cur;
<span class="lineNum"> 104 </span> :
<span class="lineNum"> 105 </span> : // Not used for output. During input, the state that corresponds
<span class="lineNum"> 106 </span> : // to eback() and _M_ext_buf.
<span class="lineNum"> 107 </span> : __state_type _M_state_last;
<span class="lineNum"> 108 </span> :
<span class="lineNum"> 109 </span> : /// Pointer to the beginning of internal buffer.
<span class="lineNum"> 110 </span> : char_type* _M_buf;
<span class="lineNum"> 111 </span> :
<span class="lineNum"> 112 </span> : /**
<span class="lineNum"> 113 </span> : * Actual size of internal buffer. This number is equal to the size
<span class="lineNum"> 114 </span> : * of the put area + 1 position, reserved for the overflow char of
<span class="lineNum"> 115 </span> : * a full area.
<span class="lineNum"> 116 </span> : */
<span class="lineNum"> 117 </span> : size_t _M_buf_size;
<span class="lineNum"> 118 </span> :
<span class="lineNum"> 119 </span> : // Set iff _M_buf is allocated memory from _M_allocate_internal_buffer.
<span class="lineNum"> 120 </span> : bool _M_buf_allocated;
<span class="lineNum"> 121 </span> :
<span class="lineNum"> 122 </span> : /**
<span class="lineNum"> 123 </span> : * _M_reading == false && _M_writing == false for 'uncommitted' mode;
<span class="lineNum"> 124 </span> : * _M_reading == true for 'read' mode;
<span class="lineNum"> 125 </span> : * _M_writing == true for 'write' mode;
<span class="lineNum"> 126 </span> : *
<span class="lineNum"> 127 </span> : * NB: _M_reading == true && _M_writing == true is unused.
<span class="lineNum"> 128 </span> : */
<span class="lineNum"> 129 </span> : bool _M_reading;
<span class="lineNum"> 130 </span> : bool _M_writing;
<span class="lineNum"> 131 </span> :
<span class="lineNum"> 132 </span> : //@{
<span class="lineNum"> 133 </span> : /**
<span class="lineNum"> 134 </span> : * Necessary bits for putback buffer management.
<span class="lineNum"> 135 </span> : *
<span class="lineNum"> 136 </span> : * @note pbacks of over one character are not currently supported.
<span class="lineNum"> 137 </span> : */
<span class="lineNum"> 138 </span> : char_type _M_pback;
<span class="lineNum"> 139 </span> : char_type* _M_pback_cur_save;
<span class="lineNum"> 140 </span> : char_type* _M_pback_end_save;
<span class="lineNum"> 141 </span> : bool _M_pback_init;
<span class="lineNum"> 142 </span> : //@}
<span class="lineNum"> 143 </span> :
<span class="lineNum"> 144 </span> : // Cached codecvt facet.
<span class="lineNum"> 145 </span> : const __codecvt_type* _M_codecvt;
<span class="lineNum"> 146 </span> :
<span class="lineNum"> 147 </span> : /**
<span class="lineNum"> 148 </span> : * Buffer for external characters. Used for input when
<span class="lineNum"> 149 </span> : * codecvt::always_noconv() == false. When valid, this corresponds
<span class="lineNum"> 150 </span> : * to eback().
<span class="lineNum"> 151 </span> : */
<span class="lineNum"> 152 </span> : char* _M_ext_buf;
<span class="lineNum"> 153 </span> :
<span class="lineNum"> 154 </span> : /**
<span class="lineNum"> 155 </span> : * Size of buffer held by _M_ext_buf.
<span class="lineNum"> 156 </span> : */
<span class="lineNum"> 157 </span> : streamsize _M_ext_buf_size;
<span class="lineNum"> 158 </span> :
<span class="lineNum"> 159 </span> : /**
<span class="lineNum"> 160 </span> : * Pointers into the buffer held by _M_ext_buf that delimit a
<span class="lineNum"> 161 </span> : * subsequence of bytes that have been read but not yet converted.
<span class="lineNum"> 162 </span> : * When valid, _M_ext_next corresponds to egptr().
<span class="lineNum"> 163 </span> : */
<span class="lineNum"> 164 </span> : const char* _M_ext_next;
<span class="lineNum"> 165 </span> : char* _M_ext_end;
<span class="lineNum"> 166 </span> :
<span class="lineNum"> 167 </span> : /**
<span class="lineNum"> 168 </span> : * Initializes pback buffers, and moves normal buffers to safety.
<span class="lineNum"> 169 </span> : * Assumptions:
<span class="lineNum"> 170 </span> : * _M_in_cur has already been moved back
<span class="lineNum"> 171 </span> : */
<span class="lineNum"> 172 </span> : void
<span class="lineNum"> 173 </span> : _M_create_pback()
<span class="lineNum"> 174 </span> : {
<span class="lineNum"> 175 </span> : if (!_M_pback_init)
<span class="lineNum"> 176 </span> : {
<span class="lineNum"> 177 </span> : _M_pback_cur_save = this->gptr();
<span class="lineNum"> 178 </span> : _M_pback_end_save = this->egptr();
<span class="lineNum"> 179 </span> : this->setg(&_M_pback, &_M_pback, &_M_pback + 1);
<span class="lineNum"> 180 </span> : _M_pback_init = true;
<span class="lineNum"> 181 </span> : }
<span class="lineNum"> 182 </span> : }
<span class="lineNum"> 183 </span> :
<span class="lineNum"> 184 </span> : /**
<span class="lineNum"> 185 </span> : * Deactivates pback buffer contents, and restores normal buffer.
<span class="lineNum"> 186 </span> : * Assumptions:
<span class="lineNum"> 187 </span> : * The pback buffer has only moved forward.
<span class="lineNum"> 188 </span> : */
<span class="lineNum"> 189 </span> : void
<span class="lineNum"> 190 </span> : _M_destroy_pback() throw()
<span class="lineNum"> 191 </span> : {
<span class="lineNum"> 192 </span> : if (_M_pback_init)
<span class="lineNum"> 193 </span> : {
<span class="lineNum"> 194 </span> : // Length _M_in_cur moved in the pback buffer.
<span class="lineNum"> 195 </span> : _M_pback_cur_save += this->gptr() != this->eback();
<span class="lineNum"> 196 </span> : this->setg(_M_buf, _M_pback_cur_save, _M_pback_end_save);
<span class="lineNum"> 197 </span> : _M_pback_init = false;
<span class="lineNum"> 198 </span> : }
<span class="lineNum"> 199 </span> : }
<span class="lineNum"> 200 </span> :
<span class="lineNum"> 201 </span> : public:
<span class="lineNum"> 202 </span> : // Constructors/destructor:
<span class="lineNum"> 203 </span> : /**
<span class="lineNum"> 204 </span> : * @brief Does not open any files.
<span class="lineNum"> 205 </span> : *
<span class="lineNum"> 206 </span> : * The default constructor initializes the parent class using its
<span class="lineNum"> 207 </span> : * own default ctor.
<span class="lineNum"> 208 </span> : */
<span class="lineNum"> 209 </span> : basic_filebuf();
<span class="lineNum"> 210 </span> :
<span class="lineNum"> 211 </span> : /**
<span class="lineNum"> 212 </span> : * @brief The destructor closes the file first.
<span class="lineNum"> 213 </span> : */
<span class="lineNum"> 214 </span> : virtual
<span class="lineNum"> 215 </span><span class="lineNoCov"> 0 : ~basic_filebuf()</span>
<span class="lineNum"> 216 </span><span class="lineNoCov"> 0 : { this->close(); }</span>
<span class="lineNum"> 217 </span> :
<span class="lineNum"> 218 </span> : // Members:
<span class="lineNum"> 219 </span> : /**
<span class="lineNum"> 220 </span> : * @brief Returns true if the external file is open.
<span class="lineNum"> 221 </span> : */
<span class="lineNum"> 222 </span> : bool
<span class="lineNum"> 223 </span><span class="lineNoCov"> 0 : is_open() const throw()</span>
<span class="lineNum"> 224 </span><span class="lineNoCov"> 0 : { return _M_file.is_open(); }</span>
<span class="lineNum"> 225 </span> :
<span class="lineNum"> 226 </span> : /**
<span class="lineNum"> 227 </span> : * @brief Opens an external file.
<span class="lineNum"> 228 </span> : * @param s The name of the file.
<span class="lineNum"> 229 </span> : * @param mode The open mode flags.
<span class="lineNum"> 230 </span> : * @return @c this on success, NULL on failure
<span class="lineNum"> 231 </span> : *
<span class="lineNum"> 232 </span> : * If a file is already open, this function immediately fails.
<span class="lineNum"> 233 </span> : * Otherwise it tries to open the file named @a s using the flags
<span class="lineNum"> 234 </span> : * given in @a mode.
<span class="lineNum"> 235 </span> : *
<span class="lineNum"> 236 </span> : * Table 92, adapted here, gives the relation between openmode
<span class="lineNum"> 237 </span> : * combinations and the equivalent fopen() flags.
<span class="lineNum"> 238 </span> : * (NB: lines app, in|out|app, in|app, binary|app, binary|in|out|app,
<span class="lineNum"> 239 </span> : * and binary|in|app per DR 596)
<span class="lineNum"> 240 </span> : * +---------------------------------------------------------+
<span class="lineNum"> 241 </span> : * | ios_base Flag combination stdio equivalent |
<span class="lineNum"> 242 </span> : * |binary in out trunc app |
<span class="lineNum"> 243 </span> : * +---------------------------------------------------------+
<span class="lineNum"> 244 </span> : * | + "w" |
<span class="lineNum"> 245 </span> : * | + + "a" |
<span class="lineNum"> 246 </span> : * | + "a" |
<span class="lineNum"> 247 </span> : * | + + "w" |
<span class="lineNum"> 248 </span> : * | + "r" |
<span class="lineNum"> 249 </span> : * | + + "r+" |
<span class="lineNum"> 250 </span> : * | + + + "w+" |
<span class="lineNum"> 251 </span> : * | + + + "a+" |
<span class="lineNum"> 252 </span> : * | + + "a+" |
<span class="lineNum"> 253 </span> : * +---------------------------------------------------------+
<span class="lineNum"> 254 </span> : * | + + "wb" |
<span class="lineNum"> 255 </span> : * | + + + "ab" |
<span class="lineNum"> 256 </span> : * | + + "ab" |
<span class="lineNum"> 257 </span> : * | + + + "wb" |
<span class="lineNum"> 258 </span> : * | + + "rb" |
<span class="lineNum"> 259 </span> : * | + + + "r+b" |
<span class="lineNum"> 260 </span> : * | + + + + "w+b" |
<span class="lineNum"> 261 </span> : * | + + + + "a+b" |
<span class="lineNum"> 262 </span> : * | + + + "a+b" |
<span class="lineNum"> 263 </span> : * +---------------------------------------------------------+
<span class="lineNum"> 264 </span> : */
<span class="lineNum"> 265 </span> : __filebuf_type*
<span class="lineNum"> 266 </span> : open(const char* __s, ios_base::openmode __mode);
<span class="lineNum"> 267 </span> :
<span class="lineNum"> 268 </span> : /**
<span class="lineNum"> 269 </span> : * @brief Closes the currently associated file.
<span class="lineNum"> 270 </span> : * @return @c this on success, NULL on failure
<span class="lineNum"> 271 </span> : *
<span class="lineNum"> 272 </span> : * If no file is currently open, this function immediately fails.
<span class="lineNum"> 273 </span> : *
<span class="lineNum"> 274 </span> : * If a "put buffer area" exists, @c overflow(eof) is called to flush
<span class="lineNum"> 275 </span> : * all the characters. The file is then closed.
<span class="lineNum"> 276 </span> : *
<span class="lineNum"> 277 </span> : * If any operations fail, this function also fails.
<span class="lineNum"> 278 </span> : */
<span class="lineNum"> 279 </span> : __filebuf_type*
<span class="lineNum"> 280 </span> : close();
<span class="lineNum"> 281 </span> :
<span class="lineNum"> 282 </span> : protected:
<span class="lineNum"> 283 </span> : void
<span class="lineNum"> 284 </span> : _M_allocate_internal_buffer();
<span class="lineNum"> 285 </span> :
<span class="lineNum"> 286 </span> : void
<span class="lineNum"> 287 </span> : _M_destroy_internal_buffer() throw();
<span class="lineNum"> 288 </span> :
<span class="lineNum"> 289 </span> : // [27.8.1.4] overridden virtual functions
<span class="lineNum"> 290 </span> : virtual streamsize
<span class="lineNum"> 291 </span> : showmanyc();
<span class="lineNum"> 292 </span> :
<span class="lineNum"> 293 </span> : // Stroustrup, 1998, p. 628
<span class="lineNum"> 294 </span> : // underflow() and uflow() functions are called to get the next
<span class="lineNum"> 295 </span> : // character from the real input source when the buffer is empty.
<span class="lineNum"> 296 </span> : // Buffered input uses underflow()
<span class="lineNum"> 297 </span> :
<span class="lineNum"> 298 </span> : virtual int_type
<span class="lineNum"> 299 </span> : underflow();
<span class="lineNum"> 300 </span> :
<span class="lineNum"> 301 </span> : virtual int_type
<span class="lineNum"> 302 </span> : pbackfail(int_type __c = _Traits::eof());
<span class="lineNum"> 303 </span> :
<span class="lineNum"> 304 </span> : // Stroustrup, 1998, p 648
<span class="lineNum"> 305 </span> : // The overflow() function is called to transfer characters to the
<span class="lineNum"> 306 </span> : // real output destination when the buffer is full. A call to
<span class="lineNum"> 307 </span> : // overflow(c) outputs the contents of the buffer plus the
<span class="lineNum"> 308 </span> : // character c.
<span class="lineNum"> 309 </span> : // 27.5.2.4.5
<span class="lineNum"> 310 </span> : // Consume some sequence of the characters in the pending sequence.
<span class="lineNum"> 311 </span> : virtual int_type
<span class="lineNum"> 312 </span> : overflow(int_type __c = _Traits::eof());
<span class="lineNum"> 313 </span> :
<span class="lineNum"> 314 </span> : // Convert internal byte sequence to external, char-based
<span class="lineNum"> 315 </span> : // sequence via codecvt.
<span class="lineNum"> 316 </span> : bool
<span class="lineNum"> 317 </span> : _M_convert_to_external(char_type*, streamsize);
<span class="lineNum"> 318 </span> :
<span class="lineNum"> 319 </span> : /**
<span class="lineNum"> 320 </span> : * @brief Manipulates the buffer.
<span class="lineNum"> 321 </span> : * @param s Pointer to a buffer area.
<span class="lineNum"> 322 </span> : * @param n Size of @a s.
<span class="lineNum"> 323 </span> : * @return @c this
<span class="lineNum"> 324 </span> : *
<span class="lineNum"> 325 </span> : * If no file has been opened, and both @a s and @a n are zero, then
<span class="lineNum"> 326 </span> : * the stream becomes unbuffered. Otherwise, @c s is used as a
<span class="lineNum"> 327 </span> : * buffer; see
<span class="lineNum"> 328 </span> : * http://gcc.gnu.org/onlinedocs/libstdc++/27_io/howto.html#2
<span class="lineNum"> 329 </span> : * for more.
<span class="lineNum"> 330 </span> : */
<span class="lineNum"> 331 </span> : virtual __streambuf_type*
<span class="lineNum"> 332 </span> : setbuf(char_type* __s, streamsize __n);
<span class="lineNum"> 333 </span> :
<span class="lineNum"> 334 </span> : virtual pos_type
<span class="lineNum"> 335 </span> : seekoff(off_type __off, ios_base::seekdir __way,
<span class="lineNum"> 336 </span> : ios_base::openmode __mode = ios_base::in | ios_base::out);
<span class="lineNum"> 337 </span> :
<span class="lineNum"> 338 </span> : virtual pos_type
<span class="lineNum"> 339 </span> : seekpos(pos_type __pos,
<span class="lineNum"> 340 </span> : ios_base::openmode __mode = ios_base::in | ios_base::out);
<span class="lineNum"> 341 </span> :
<span class="lineNum"> 342 </span> : // Common code for seekoff and seekpos
<span class="lineNum"> 343 </span> : pos_type
<span class="lineNum"> 344 </span> : _M_seek(off_type __off, ios_base::seekdir __way, __state_type __state);
<span class="lineNum"> 345 </span> :
<span class="lineNum"> 346 </span> : virtual int
<span class="lineNum"> 347 </span> : sync();
<span class="lineNum"> 348 </span> :
<span class="lineNum"> 349 </span> : virtual void
<span class="lineNum"> 350 </span> : imbue(const locale& __loc);
<span class="lineNum"> 351 </span> :
<span class="lineNum"> 352 </span> : virtual streamsize
<span class="lineNum"> 353 </span> : xsgetn(char_type* __s, streamsize __n);
<span class="lineNum"> 354 </span> :
<span class="lineNum"> 355 </span> : virtual streamsize
<span class="lineNum"> 356 </span> : xsputn(const char_type* __s, streamsize __n);
<span class="lineNum"> 357 </span> :
<span class="lineNum"> 358 </span> : // Flushes output buffer, then writes unshift sequence.
<span class="lineNum"> 359 </span> : bool
<span class="lineNum"> 360 </span> : _M_terminate_output();
<span class="lineNum"> 361 </span> :
<span class="lineNum"> 362 </span> : /**
<span class="lineNum"> 363 </span> : * This function sets the pointers of the internal buffer, both get
<span class="lineNum"> 364 </span> : * and put areas. Typically:
<span class="lineNum"> 365 </span> : *
<span class="lineNum"> 366 </span> : * __off == egptr() - eback() upon underflow/uflow ('read' mode);
<span class="lineNum"> 367 </span> : * __off == 0 upon overflow ('write' mode);
<span class="lineNum"> 368 </span> : * __off == -1 upon open, setbuf, seekoff/pos ('uncommitted' mode).
<span class="lineNum"> 369 </span> : *
<span class="lineNum"> 370 </span> : * NB: epptr() - pbase() == _M_buf_size - 1, since _M_buf_size
<span class="lineNum"> 371 </span> : * reflects the actual allocated memory and the last cell is reserved
<span class="lineNum"> 372 </span> : * for the overflow char of a full put area.
<span class="lineNum"> 373 </span> : */
<span class="lineNum"> 374 </span> : void
<span class="lineNum"> 375 </span> : _M_set_buffer(streamsize __off)
<span class="lineNum"> 376 </span> : {
<span class="lineNum"> 377 </span> : const bool __testin = _M_mode & ios_base::in;
<span class="lineNum"> 378 </span> : const bool __testout = _M_mode & ios_base::out;
<span class="lineNum"> 379 </span> :
<span class="lineNum"> 380 </span> : if (__testin && __off > 0)
<span class="lineNum"> 381 </span> : this->setg(_M_buf, _M_buf, _M_buf + __off);
<span class="lineNum"> 382 </span> : else
<span class="lineNum"> 383 </span> : this->setg(_M_buf, _M_buf, _M_buf);
<span class="lineNum"> 384 </span> :
<span class="lineNum"> 385 </span> : if (__testout && __off == 0 && _M_buf_size > 1 )
<span class="lineNum"> 386 </span> : this->setp(_M_buf, _M_buf + _M_buf_size - 1);
<span class="lineNum"> 387 </span> : else
<span class="lineNum"> 388 </span> : this->setp(NULL, NULL);
<span class="lineNum"> 389 </span> : }
<span class="lineNum"> 390 </span> : };
<span class="lineNum"> 391 </span> :
<span class="lineNum"> 392 </span> : // [27.8.1.5] Template class basic_ifstream
<span class="lineNum"> 393 </span> : /**
<span class="lineNum"> 394 </span> : * @brief Controlling input for files.
<span class="lineNum"> 395 </span> : *
<span class="lineNum"> 396 </span> : * This class supports reading from named files, using the inherited
<span class="lineNum"> 397 </span> : * functions from std::basic_istream. To control the associated
<span class="lineNum"> 398 </span> : * sequence, an instance of std::basic_filebuf is used, which this page
<span class="lineNum"> 399 </span> : * refers to as @c sb.
<span class="lineNum"> 400 </span> : */
<span class="lineNum"> 401 </span> : template<typename _CharT, typename _Traits>
<span class="lineNum"> 402 </span> : class basic_ifstream : public basic_istream<_CharT, _Traits>
<span class="lineNum"> 403 </span> : {
<span class="lineNum"> 404 </span> : public:
<span class="lineNum"> 405 </span> : // Types:
<span class="lineNum"> 406 </span> : typedef _CharT char_type;
<span class="lineNum"> 407 </span> : typedef _Traits traits_type;
<span class="lineNum"> 408 </span> : typedef typename traits_type::int_type int_type;
<span class="lineNum"> 409 </span> : typedef typename traits_type::pos_type pos_type;
<span class="lineNum"> 410 </span> : typedef typename traits_type::off_type off_type;
<span class="lineNum"> 411 </span> :
<span class="lineNum"> 412 </span> : // Non-standard types:
<span class="lineNum"> 413 </span> : typedef basic_filebuf<char_type, traits_type> __filebuf_type;
<span class="lineNum"> 414 </span> : typedef basic_istream<char_type, traits_type> __istream_type;
<span class="lineNum"> 415 </span> :
<span class="lineNum"> 416 </span> : private:
<span class="lineNum"> 417 </span> : __filebuf_type _M_filebuf;
<span class="lineNum"> 418 </span> :
<span class="lineNum"> 419 </span> : public:
<span class="lineNum"> 420 </span> : // Constructors/Destructors:
<span class="lineNum"> 421 </span> : /**
<span class="lineNum"> 422 </span> : * @brief Default constructor.
<span class="lineNum"> 423 </span> : *
<span class="lineNum"> 424 </span> : * Initializes @c sb using its default constructor, and passes
<span class="lineNum"> 425 </span> : * @c &sb to the base class initializer. Does not open any files
<span class="lineNum"> 426 </span> : * (you haven't given it a filename to open).
<span class="lineNum"> 427 </span> : */
<span class="lineNum"> 428 </span><span class="lineNoCov"> 0 : basic_ifstream() : __istream_type(), _M_filebuf()</span>
<span class="lineNum"> 429 </span><span class="lineNoCov"> 0 : { this->init(&_M_filebuf); }</span>
<span class="lineNum"> 430 </span> :
<span class="lineNum"> 431 </span> : /**
<span class="lineNum"> 432 </span> : * @brief Create an input file stream.
<span class="lineNum"> 433 </span> : * @param s Null terminated string specifying the filename.
<span class="lineNum"> 434 </span> : * @param mode Open file in specified mode (see std::ios_base).
<span class="lineNum"> 435 </span> : *
<span class="lineNum"> 436 </span> : * @c ios_base::in is automatically included in @a mode.
<span class="lineNum"> 437 </span> : *
<span class="lineNum"> 438 </span> : * Tip: When using std::string to hold the filename, you must use
<span class="lineNum"> 439 </span> : * .c_str() before passing it to this constructor.
<span class="lineNum"> 440 </span> : */
<span class="lineNum"> 441 </span> : explicit
<span class="lineNum"> 442 </span><span class="lineNoCov"> 0 : basic_ifstream(const char* __s, ios_base::openmode __mode = ios_base::in)</span>
<span class="lineNum"> 443 </span><span class="lineNoCov"> 0 : : __istream_type(), _M_filebuf()</span>
<span class="lineNum"> 444 </span> : {
<span class="lineNum"> 445 </span><span class="lineNoCov"> 0 : this->init(&_M_filebuf);</span>
<span class="lineNum"> 446 </span><span class="lineNoCov"> 0 : this->open(__s, __mode);</span>
<span class="lineNum"> 447 </span><span class="lineNoCov"> 0 : }</span>
<span class="lineNum"> 448 </span> :
<span class="lineNum"> 449 </span> : /**
<span class="lineNum"> 450 </span> : * @brief The destructor does nothing.
<span class="lineNum"> 451 </span> : *
<span class="lineNum"> 452 </span> : * The file is closed by the filebuf object, not the formatting
<span class="lineNum"> 453 </span> : * stream.
<span class="lineNum"> 454 </span> : */
<span class="lineNum"> 455 </span><span class="lineNoCov"> 0 : ~basic_ifstream()</span>
<span class="lineNum"> 456 </span><span class="lineNoCov"> 0 : { }</span>
<span class="lineNum"> 457 </span> :
<span class="lineNum"> 458 </span> : // Members:
<span class="lineNum"> 459 </span> : /**
<span class="lineNum"> 460 </span> : * @brief Accessing the underlying buffer.
<span class="lineNum"> 461 </span> : * @return The current basic_filebuf buffer.
<span class="lineNum"> 462 </span> : *
<span class="lineNum"> 463 </span> : * This hides both signatures of std::basic_ios::rdbuf().
<span class="lineNum"> 464 </span> : */
<span class="lineNum"> 465 </span> : __filebuf_type*
<span class="lineNum"> 466 </span> : rdbuf() const
<span class="lineNum"> 467 </span> : { return const_cast<__filebuf_type*>(&_M_filebuf); }
<span class="lineNum"> 468 </span> :
<span class="lineNum"> 469 </span> : /**
<span class="lineNum"> 470 </span> : * @brief Wrapper to test for an open file.
<span class="lineNum"> 471 </span> : * @return @c rdbuf()->is_open()
<span class="lineNum"> 472 </span> : */
<span class="lineNum"> 473 </span> : bool
<span class="lineNum"> 474 </span><span class="lineNoCov"> 0 : is_open()</span>
<span class="lineNum"> 475 </span><span class="lineNoCov"> 0 : { return _M_filebuf.is_open(); }</span>
<span class="lineNum"> 476 </span> :
<span class="lineNum"> 477 </span> : // _GLIBCXX_RESOLVE_LIB_DEFECTS
<span class="lineNum"> 478 </span> : // 365. Lack of const-qualification in clause 27
<span class="lineNum"> 479 </span> : bool
<span class="lineNum"> 480 </span> : is_open() const
<span class="lineNum"> 481 </span> : { return _M_filebuf.is_open(); }
<span class="lineNum"> 482 </span> :
<span class="lineNum"> 483 </span> : /**
<span class="lineNum"> 484 </span> : * @brief Opens an external file.
<span class="lineNum"> 485 </span> : * @param s The name of the file.
<span class="lineNum"> 486 </span> : * @param mode The open mode flags.
<span class="lineNum"> 487 </span> : *
<span class="lineNum"> 488 </span> : * Calls @c std::basic_filebuf::open(s,mode|in). If that function
<span class="lineNum"> 489 </span> : * fails, @c failbit is set in the stream's error state.
<span class="lineNum"> 490 </span> : *
<span class="lineNum"> 491 </span> : * Tip: When using std::string to hold the filename, you must use
<span class="lineNum"> 492 </span> : * .c_str() before passing it to this constructor.
<span class="lineNum"> 493 </span> : */
<span class="lineNum"> 494 </span> : void
<span class="lineNum"> 495 </span><span class="lineNoCov"> 0 : open(const char* __s, ios_base::openmode __mode = ios_base::in)</span>
<span class="lineNum"> 496 </span> : {
<span class="lineNum"> 497 </span><span class="lineNoCov"> 0 : if (!_M_filebuf.open(__s, __mode | ios_base::in))</span>
<span class="lineNum"> 498 </span><span class="lineNoCov"> 0 : this->setstate(ios_base::failbit);</span>
<span class="lineNum"> 499 </span> : else
<span class="lineNum"> 500 </span> : // _GLIBCXX_RESOLVE_LIB_DEFECTS
<span class="lineNum"> 501 </span> : // 409. Closing an fstream should clear error state
<span class="lineNum"> 502 </span><span class="lineNoCov"> 0 : this->clear();</span>
<span class="lineNum"> 503 </span><span class="lineNoCov"> 0 : }</span>
<span class="lineNum"> 504 </span> :
<span class="lineNum"> 505 </span> : /**
<span class="lineNum"> 506 </span> : * @brief Close the file.
<span class="lineNum"> 507 </span> : *
<span class="lineNum"> 508 </span> : * Calls @c std::basic_filebuf::close(). If that function
<span class="lineNum"> 509 </span> : * fails, @c failbit is set in the stream's error state.
<span class="lineNum"> 510 </span> : */
<span class="lineNum"> 511 </span> : void
<span class="lineNum"> 512 </span><span class="lineNoCov"> 0 : close()</span>
<span class="lineNum"> 513 </span> : {
<span class="lineNum"> 514 </span><span class="lineNoCov"> 0 : if (!_M_filebuf.close())</span>
<span class="lineNum"> 515 </span><span class="lineNoCov"> 0 : this->setstate(ios_base::failbit);</span>
<span class="lineNum"> 516 </span><span class="lineNoCov"> 0 : }</span>
<span class="lineNum"> 517 </span> : };
<span class="lineNum"> 518 </span> :
<span class="lineNum"> 519 </span> :
<span class="lineNum"> 520 </span> : // [27.8.1.8] Template class basic_ofstream
<span class="lineNum"> 521 </span> : /**
<span class="lineNum"> 522 </span> : * @brief Controlling output for files.
<span class="lineNum"> 523 </span> : *
<span class="lineNum"> 524 </span> : * This class supports reading from named files, using the inherited
<span class="lineNum"> 525 </span> : * functions from std::basic_ostream. To control the associated
<span class="lineNum"> 526 </span> : * sequence, an instance of std::basic_filebuf is used, which this page
<span class="lineNum"> 527 </span> : * refers to as @c sb.
<span class="lineNum"> 528 </span> : */
<span class="lineNum"> 529 </span> : template<typename _CharT, typename _Traits>
<span class="lineNum"> 530 </span> : class basic_ofstream : public basic_ostream<_CharT,_Traits>
<span class="lineNum"> 531 </span> : {
<span class="lineNum"> 532 </span> : public:
<span class="lineNum"> 533 </span> : // Types:
<span class="lineNum"> 534 </span> : typedef _CharT char_type;
<span class="lineNum"> 535 </span> : typedef _Traits traits_type;
<span class="lineNum"> 536 </span> : typedef typename traits_type::int_type int_type;
<span class="lineNum"> 537 </span> : typedef typename traits_type::pos_type pos_type;
<span class="lineNum"> 538 </span> : typedef typename traits_type::off_type off_type;
<span class="lineNum"> 539 </span> :
<span class="lineNum"> 540 </span> : // Non-standard types:
<span class="lineNum"> 541 </span> : typedef basic_filebuf<char_type, traits_type> __filebuf_type;
<span class="lineNum"> 542 </span> : typedef basic_ostream<char_type, traits_type> __ostream_type;
<span class="lineNum"> 543 </span> :
<span class="lineNum"> 544 </span> : private:
<span class="lineNum"> 545 </span> : __filebuf_type _M_filebuf;
<span class="lineNum"> 546 </span> :
<span class="lineNum"> 547 </span> : public:
<span class="lineNum"> 548 </span> : // Constructors:
<span class="lineNum"> 549 </span> : /**
<span class="lineNum"> 550 </span> : * @brief Default constructor.
<span class="lineNum"> 551 </span> : *
<span class="lineNum"> 552 </span> : * Initializes @c sb using its default constructor, and passes
<span class="lineNum"> 553 </span> : * @c &sb to the base class initializer. Does not open any files
<span class="lineNum"> 554 </span> : * (you haven't given it a filename to open).
<span class="lineNum"> 555 </span> : */
<span class="lineNum"> 556 </span> : basic_ofstream(): __ostream_type(), _M_filebuf()
<span class="lineNum"> 557 </span> : { this->init(&_M_filebuf); }
<span class="lineNum"> 558 </span> :
<span class="lineNum"> 559 </span> : /**
<span class="lineNum"> 560 </span> : * @brief Create an output file stream.
<span class="lineNum"> 561 </span> : * @param s Null terminated string specifying the filename.
<span class="lineNum"> 562 </span> : * @param mode Open file in specified mode (see std::ios_base).
<span class="lineNum"> 563 </span> : *
<span class="lineNum"> 564 </span> : * @c ios_base::out|ios_base::trunc is automatically included in
<span class="lineNum"> 565 </span> : * @a mode.
<span class="lineNum"> 566 </span> : *
<span class="lineNum"> 567 </span> : * Tip: When using std::string to hold the filename, you must use
<span class="lineNum"> 568 </span> : * .c_str() before passing it to this constructor.
<span class="lineNum"> 569 </span> : */
<span class="lineNum"> 570 </span> : explicit
<span class="lineNum"> 571 </span> : basic_ofstream(const char* __s,
<span class="lineNum"> 572 </span><span class="lineNoCov"> 0 : ios_base::openmode __mode = ios_base::out|ios_base::trunc)</span>
<span class="lineNum"> 573 </span><span class="lineNoCov"> 0 : : __ostream_type(), _M_filebuf()</span>
<span class="lineNum"> 574 </span> : {
<span class="lineNum"> 575 </span><span class="lineNoCov"> 0 : this->init(&_M_filebuf);</span>
<span class="lineNum"> 576 </span><span class="lineNoCov"> 0 : this->open(__s, __mode);</span>
<span class="lineNum"> 577 </span><span class="lineNoCov"> 0 : }</span>
<span class="lineNum"> 578 </span> :
<span class="lineNum"> 579 </span> : /**
<span class="lineNum"> 580 </span> : * @brief The destructor does nothing.
<span class="lineNum"> 581 </span> : *
<span class="lineNum"> 582 </span> : * The file is closed by the filebuf object, not the formatting
<span class="lineNum"> 583 </span> : * stream.
<span class="lineNum"> 584 </span> : */
<span class="lineNum"> 585 </span><span class="lineNoCov"> 0 : ~basic_ofstream()</span>
<span class="lineNum"> 586 </span><span class="lineNoCov"> 0 : { }</span>
<span class="lineNum"> 587 </span> :
<span class="lineNum"> 588 </span> : // Members:
<span class="lineNum"> 589 </span> : /**
<span class="lineNum"> 590 </span> : * @brief Accessing the underlying buffer.
<span class="lineNum"> 591 </span> : * @return The current basic_filebuf buffer.
<span class="lineNum"> 592 </span> : *
<span class="lineNum"> 593 </span> : * This hides both signatures of std::basic_ios::rdbuf().
<span class="lineNum"> 594 </span> : */
<span class="lineNum"> 595 </span> : __filebuf_type*
<span class="lineNum"> 596 </span> : rdbuf() const
<span class="lineNum"> 597 </span> : { return const_cast<__filebuf_type*>(&_M_filebuf); }
<span class="lineNum"> 598 </span> :
<span class="lineNum"> 599 </span> : /**
<span class="lineNum"> 600 </span> : * @brief Wrapper to test for an open file.
<span class="lineNum"> 601 </span> : * @return @c rdbuf()->is_open()
<span class="lineNum"> 602 </span> : */
<span class="lineNum"> 603 </span> : bool
<span class="lineNum"> 604 </span><span class="lineNoCov"> 0 : is_open()</span>
<span class="lineNum"> 605 </span><span class="lineNoCov"> 0 : { return _M_filebuf.is_open(); }</span>
<span class="lineNum"> 606 </span> :
<span class="lineNum"> 607 </span> : // _GLIBCXX_RESOLVE_LIB_DEFECTS
<span class="lineNum"> 608 </span> : // 365. Lack of const-qualification in clause 27
<span class="lineNum"> 609 </span> : bool
<span class="lineNum"> 610 </span> : is_open() const
<span class="lineNum"> 611 </span> : { return _M_filebuf.is_open(); }
<span class="lineNum"> 612 </span> :
<span class="lineNum"> 613 </span> : /**
<span class="lineNum"> 614 </span> : * @brief Opens an external file.
<span class="lineNum"> 615 </span> : * @param s The name of the file.
<span class="lineNum"> 616 </span> : * @param mode The open mode flags.
<span class="lineNum"> 617 </span> : *
<span class="lineNum"> 618 </span> : * Calls @c std::basic_filebuf::open(s,mode|out|trunc). If that
<span class="lineNum"> 619 </span> : * function fails, @c failbit is set in the stream's error state.
<span class="lineNum"> 620 </span> : *
<span class="lineNum"> 621 </span> : * Tip: When using std::string to hold the filename, you must use
<span class="lineNum"> 622 </span> : * .c_str() before passing it to this constructor.
<span class="lineNum"> 623 </span> : */
<span class="lineNum"> 624 </span> : void
<span class="lineNum"> 625 </span> : open(const char* __s,
<span class="lineNum"> 626 </span><span class="lineNoCov"> 0 : ios_base::openmode __mode = ios_base::out | ios_base::trunc)</span>
<span class="lineNum"> 627 </span> : {
<span class="lineNum"> 628 </span><span class="lineNoCov"> 0 : if (!_M_filebuf.open(__s, __mode | ios_base::out))</span>
<span class="lineNum"> 629 </span><span class="lineNoCov"> 0 : this->setstate(ios_base::failbit);</span>
<span class="lineNum"> 630 </span> : else
<span class="lineNum"> 631 </span> : // _GLIBCXX_RESOLVE_LIB_DEFECTS
<span class="lineNum"> 632 </span> : // 409. Closing an fstream should clear error state
<span class="lineNum"> 633 </span><span class="lineNoCov"> 0 : this->clear();</span>
<span class="lineNum"> 634 </span><span class="lineNoCov"> 0 : }</span>
<span class="lineNum"> 635 </span> :
<span class="lineNum"> 636 </span> : /**
<span class="lineNum"> 637 </span> : * @brief Close the file.
<span class="lineNum"> 638 </span> : *
<span class="lineNum"> 639 </span> : * Calls @c std::basic_filebuf::close(). If that function
<span class="lineNum"> 640 </span> : * fails, @c failbit is set in the stream's error state.
<span class="lineNum"> 641 </span> : */
<span class="lineNum"> 642 </span> : void
<span class="lineNum"> 643 </span> : close()
<span class="lineNum"> 644 </span> : {
<span class="lineNum"> 645 </span> : if (!_M_filebuf.close())
<span class="lineNum"> 646 </span> : this->setstate(ios_base::failbit);
<span class="lineNum"> 647 </span> : }
<span class="lineNum"> 648 </span> : };
<span class="lineNum"> 649 </span> :
<span class="lineNum"> 650 </span> :
<span class="lineNum"> 651 </span> : // [27.8.1.11] Template class basic_fstream
<span class="lineNum"> 652 </span> : /**
<span class="lineNum"> 653 </span> : * @brief Controlling input and output for files.
<span class="lineNum"> 654 </span> : *
<span class="lineNum"> 655 </span> : * This class supports reading from and writing to named files, using
<span class="lineNum"> 656 </span> : * the inherited functions from std::basic_iostream. To control the
<span class="lineNum"> 657 </span> : * associated sequence, an instance of std::basic_filebuf is used, which
<span class="lineNum"> 658 </span> : * this page refers to as @c sb.
<span class="lineNum"> 659 </span> : */
<span class="lineNum"> 660 </span> : template<typename _CharT, typename _Traits>
<span class="lineNum"> 661 </span> : class basic_fstream : public basic_iostream<_CharT, _Traits>
<span class="lineNum"> 662 </span> : {
<span class="lineNum"> 663 </span> : public:
<span class="lineNum"> 664 </span> : // Types:
<span class="lineNum"> 665 </span> : typedef _CharT char_type;
<span class="lineNum"> 666 </span> : typedef _Traits traits_type;
<span class="lineNum"> 667 </span> : typedef typename traits_type::int_type int_type;
<span class="lineNum"> 668 </span> : typedef typename traits_type::pos_type pos_type;
<span class="lineNum"> 669 </span> : typedef typename traits_type::off_type off_type;
<span class="lineNum"> 670 </span> :
<span class="lineNum"> 671 </span> : // Non-standard types:
<span class="lineNum"> 672 </span> : typedef basic_filebuf<char_type, traits_type> __filebuf_type;
<span class="lineNum"> 673 </span> : typedef basic_ios<char_type, traits_type> __ios_type;
<span class="lineNum"> 674 </span> : typedef basic_iostream<char_type, traits_type> __iostream_type;
<span class="lineNum"> 675 </span> :
<span class="lineNum"> 676 </span> : private:
<span class="lineNum"> 677 </span> : __filebuf_type _M_filebuf;
<span class="lineNum"> 678 </span> :
<span class="lineNum"> 679 </span> : public:
<span class="lineNum"> 680 </span> : // Constructors/destructor:
<span class="lineNum"> 681 </span> : /**
<span class="lineNum"> 682 </span> : * @brief Default constructor.
<span class="lineNum"> 683 </span> : *
<span class="lineNum"> 684 </span> : * Initializes @c sb using its default constructor, and passes
<span class="lineNum"> 685 </span> : * @c &sb to the base class initializer. Does not open any files
<span class="lineNum"> 686 </span> : * (you haven't given it a filename to open).
<span class="lineNum"> 687 </span> : */
<span class="lineNum"> 688 </span> : basic_fstream()
<span class="lineNum"> 689 </span> : : __iostream_type(), _M_filebuf()
<span class="lineNum"> 690 </span> : { this->init(&_M_filebuf); }
<span class="lineNum"> 691 </span> :
<span class="lineNum"> 692 </span> : /**
<span class="lineNum"> 693 </span> : * @brief Create an input/output file stream.
<span class="lineNum"> 694 </span> : * @param s Null terminated string specifying the filename.
<span class="lineNum"> 695 </span> : * @param mode Open file in specified mode (see std::ios_base).
<span class="lineNum"> 696 </span> : *
<span class="lineNum"> 697 </span> : * Tip: When using std::string to hold the filename, you must use
<span class="lineNum"> 698 </span> : * .c_str() before passing it to this constructor.
<span class="lineNum"> 699 </span> : */
<span class="lineNum"> 700 </span> : explicit
<span class="lineNum"> 701 </span> : basic_fstream(const char* __s,
<span class="lineNum"> 702 </span> : ios_base::openmode __mode = ios_base::in | ios_base::out)
<span class="lineNum"> 703 </span> : : __iostream_type(NULL), _M_filebuf()
<span class="lineNum"> 704 </span> : {
<span class="lineNum"> 705 </span> : this->init(&_M_filebuf);
<span class="lineNum"> 706 </span> : this->open(__s, __mode);
<span class="lineNum"> 707 </span> : }
<span class="lineNum"> 708 </span> :
<span class="lineNum"> 709 </span> : /**
<span class="lineNum"> 710 </span> : * @brief The destructor does nothing.
<span class="lineNum"> 711 </span> : *
<span class="lineNum"> 712 </span> : * The file is closed by the filebuf object, not the formatting
<span class="lineNum"> 713 </span> : * stream.
<span class="lineNum"> 714 </span> : */
<span class="lineNum"> 715 </span> : ~basic_fstream()
<span class="lineNum"> 716 </span> : { }
<span class="lineNum"> 717 </span> :
<span class="lineNum"> 718 </span> : // Members:
<span class="lineNum"> 719 </span> : /**
<span class="lineNum"> 720 </span> : * @brief Accessing the underlying buffer.
<span class="lineNum"> 721 </span> : * @return The current basic_filebuf buffer.
<span class="lineNum"> 722 </span> : *
<span class="lineNum"> 723 </span> : * This hides both signatures of std::basic_ios::rdbuf().
<span class="lineNum"> 724 </span> : */
<span class="lineNum"> 725 </span> : __filebuf_type*
<span class="lineNum"> 726 </span> : rdbuf() const
<span class="lineNum"> 727 </span> : { return const_cast<__filebuf_type*>(&_M_filebuf); }
<span class="lineNum"> 728 </span> :
<span class="lineNum"> 729 </span> : /**
<span class="lineNum"> 730 </span> : * @brief Wrapper to test for an open file.
<span class="lineNum"> 731 </span> : * @return @c rdbuf()->is_open()
<span class="lineNum"> 732 </span> : */
<span class="lineNum"> 733 </span> : bool
<span class="lineNum"> 734 </span> : is_open()
<span class="lineNum"> 735 </span> : { return _M_filebuf.is_open(); }
<span class="lineNum"> 736 </span> :
<span class="lineNum"> 737 </span> : // _GLIBCXX_RESOLVE_LIB_DEFECTS
<span class="lineNum"> 738 </span> : // 365. Lack of const-qualification in clause 27
<span class="lineNum"> 739 </span> : bool
<span class="lineNum"> 740 </span> : is_open() const
<span class="lineNum"> 741 </span> : { return _M_filebuf.is_open(); }
<span class="lineNum"> 742 </span> :
<span class="lineNum"> 743 </span> : /**
<span class="lineNum"> 744 </span> : * @brief Opens an external file.
<span class="lineNum"> 745 </span> : * @param s The name of the file.
<span class="lineNum"> 746 </span> : * @param mode The open mode flags.
<span class="lineNum"> 747 </span> : *
<span class="lineNum"> 748 </span> : * Calls @c std::basic_filebuf::open(s,mode). If that
<span class="lineNum"> 749 </span> : * function fails, @c failbit is set in the stream's error state.
<span class="lineNum"> 750 </span> : *
<span class="lineNum"> 751 </span> : * Tip: When using std::string to hold the filename, you must use
<span class="lineNum"> 752 </span> : * .c_str() before passing it to this constructor.
<span class="lineNum"> 753 </span> : */
<span class="lineNum"> 754 </span> : void
<span class="lineNum"> 755 </span> : open(const char* __s,
<span class="lineNum"> 756 </span> : ios_base::openmode __mode = ios_base::in | ios_base::out)
<span class="lineNum"> 757 </span> : {
<span class="lineNum"> 758 </span> : if (!_M_filebuf.open(__s, __mode))
<span class="lineNum"> 759 </span> : this->setstate(ios_base::failbit);
<span class="lineNum"> 760 </span> : else
<span class="lineNum"> 761 </span> : // _GLIBCXX_RESOLVE_LIB_DEFECTS
<span class="lineNum"> 762 </span> : // 409. Closing an fstream should clear error state
<span class="lineNum"> 763 </span> : this->clear();
<span class="lineNum"> 764 </span> : }
<span class="lineNum"> 765 </span> :
<span class="lineNum"> 766 </span> : /**
<span class="lineNum"> 767 </span> : * @brief Close the file.
<span class="lineNum"> 768 </span> : *
<span class="lineNum"> 769 </span> : * Calls @c std::basic_filebuf::close(). If that function
<span class="lineNum"> 770 </span> : * fails, @c failbit is set in the stream's error state.
<span class="lineNum"> 771 </span> : */
<span class="lineNum"> 772 </span> : void
<span class="lineNum"> 773 </span> : close()
<span class="lineNum"> 774 </span> : {
<span class="lineNum"> 775 </span> : if (!_M_filebuf.close())
<span class="lineNum"> 776 </span> : this->setstate(ios_base::failbit);
<span class="lineNum"> 777 </span> : }
<span class="lineNum"> 778 </span> : };
<span class="lineNum"> 779 </span> :
<span class="lineNum"> 780 </span> : _GLIBCXX_END_NAMESPACE
<span class="lineNum"> 781 </span> :
<span class="lineNum"> 782 </span> : #ifndef _GLIBCXX_EXPORT_TEMPLATE
<span class="lineNum"> 783 </span> : # include <bits/fstream.tcc>
<span class="lineNum"> 784 </span> : #endif
<span class="lineNum"> 785 </span> :
<span class="lineNum"> 786 </span> : #endif /* _GLIBCXX_FSTREAM */
</pre>
</td>
</tr>
</table>
<br>
<table width="100%" border=0 cellspacing=0 cellpadding=0>
<tr><td class="ruler"><img src="../../../../glass.png" width=3 height=3 alt=""></td></tr>
<tr><td class="versionInfo">Generated by: <a href="http://ltp.sourceforge.net/coverage/lcov.php" target="_parent">LTP GCOV extension version 1.6</a></td></tr>
</table>
<br>
</body>
</html>
|
