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
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
|
<!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/istream</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> - istream</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%">8</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> : // Input 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> : //
<span class="lineNum"> 33 </span> : // ISO C++ 14882: 27.6.1 Input streams
<span class="lineNum"> 34 </span> : //
<span class="lineNum"> 35 </span> :
<span class="lineNum"> 36 </span> : /** @file istream
<span class="lineNum"> 37 </span> : * This is a Standard C++ Library header.
<span class="lineNum"> 38 </span> : */
<span class="lineNum"> 39 </span> :
<span class="lineNum"> 40 </span> : #ifndef _GLIBCXX_ISTREAM
<span class="lineNum"> 41 </span> : #define _GLIBCXX_ISTREAM 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 <ios>
<span class="lineNum"> 46 </span> : #include <ostream>
<span class="lineNum"> 47 </span> :
<span class="lineNum"> 48 </span> : _GLIBCXX_BEGIN_NAMESPACE(std)
<span class="lineNum"> 49 </span> :
<span class="lineNum"> 50 </span> : // [27.6.1.1] Template class basic_istream
<span class="lineNum"> 51 </span> : /**
<span class="lineNum"> 52 </span> : * @brief Controlling input.
<span class="lineNum"> 53 </span> : *
<span class="lineNum"> 54 </span> : * This is the base class for all input streams. It provides text
<span class="lineNum"> 55 </span> : * formatting of all builtin types, and communicates with any class
<span class="lineNum"> 56 </span> : * derived from basic_streambuf to do the actual input.
<span class="lineNum"> 57 </span> : */
<span class="lineNum"> 58 </span> : template<typename _CharT, typename _Traits>
<span class="lineNum"> 59 </span> : class basic_istream : virtual public basic_ios<_CharT, _Traits>
<span class="lineNum"> 60 </span> : {
<span class="lineNum"> 61 </span> : public:
<span class="lineNum"> 62 </span> : // Types (inherited from basic_ios (27.4.4)):
<span class="lineNum"> 63 </span> : typedef _CharT char_type;
<span class="lineNum"> 64 </span> : typedef typename _Traits::int_type int_type;
<span class="lineNum"> 65 </span> : typedef typename _Traits::pos_type pos_type;
<span class="lineNum"> 66 </span> : typedef typename _Traits::off_type off_type;
<span class="lineNum"> 67 </span> : typedef _Traits traits_type;
<span class="lineNum"> 68 </span> :
<span class="lineNum"> 69 </span> : // Non-standard Types:
<span class="lineNum"> 70 </span> : typedef basic_streambuf<_CharT, _Traits> __streambuf_type;
<span class="lineNum"> 71 </span> : typedef basic_ios<_CharT, _Traits> __ios_type;
<span class="lineNum"> 72 </span> : typedef basic_istream<_CharT, _Traits> __istream_type;
<span class="lineNum"> 73 </span> : typedef num_get<_CharT, istreambuf_iterator<_CharT, _Traits> >
<span class="lineNum"> 74 </span> : __num_get_type;
<span class="lineNum"> 75 </span> : typedef ctype<_CharT> __ctype_type;
<span class="lineNum"> 76 </span> :
<span class="lineNum"> 77 </span> : protected:
<span class="lineNum"> 78 </span> : // Data Members:
<span class="lineNum"> 79 </span> : /**
<span class="lineNum"> 80 </span> : * The number of characters extracted in the previous unformatted
<span class="lineNum"> 81 </span> : * function; see gcount().
<span class="lineNum"> 82 </span> : */
<span class="lineNum"> 83 </span> : streamsize _M_gcount;
<span class="lineNum"> 84 </span> :
<span class="lineNum"> 85 </span> : public:
<span class="lineNum"> 86 </span> : // [27.6.1.1.1] constructor/destructor
<span class="lineNum"> 87 </span> : /**
<span class="lineNum"> 88 </span> : * @brief Base constructor.
<span class="lineNum"> 89 </span> : *
<span class="lineNum"> 90 </span> : * This ctor is almost never called by the user directly, rather from
<span class="lineNum"> 91 </span> : * derived classes' initialization lists, which pass a pointer to
<span class="lineNum"> 92 </span> : * their own stream buffer.
<span class="lineNum"> 93 </span> : */
<span class="lineNum"> 94 </span> : explicit
<span class="lineNum"> 95 </span> : basic_istream(__streambuf_type* __sb)
<span class="lineNum"> 96 </span> : : _M_gcount(streamsize(0))
<span class="lineNum"> 97 </span> : { this->init(__sb); }
<span class="lineNum"> 98 </span> :
<span class="lineNum"> 99 </span> : /**
<span class="lineNum"> 100 </span> : * @brief Base destructor.
<span class="lineNum"> 101 </span> : *
<span class="lineNum"> 102 </span> : * This does very little apart from providing a virtual base dtor.
<span class="lineNum"> 103 </span> : */
<span class="lineNum"> 104 </span> : virtual
<span class="lineNum"> 105 </span><span class="lineNoCov"> 0 : ~basic_istream() </span>
<span class="lineNum"> 106 </span><span class="lineNoCov"> 0 : { _M_gcount = streamsize(0); }</span>
<span class="lineNum"> 107 </span> :
<span class="lineNum"> 108 </span> : // [27.6.1.1.2] prefix/suffix
<span class="lineNum"> 109 </span> : class sentry;
<span class="lineNum"> 110 </span> : friend class sentry;
<span class="lineNum"> 111 </span> :
<span class="lineNum"> 112 </span> : // [27.6.1.2] formatted input
<span class="lineNum"> 113 </span> : // [27.6.1.2.3] basic_istream::operator>>
<span class="lineNum"> 114 </span> : //@{
<span class="lineNum"> 115 </span> : /**
<span class="lineNum"> 116 </span> : * @brief Interface for manipulators.
<span class="lineNum"> 117 </span> : *
<span class="lineNum"> 118 </span> : * Manipulators such as @c std::ws and @c std::dec use these
<span class="lineNum"> 119 </span> : * functions in constructs like "std::cin >> std::ws". For more
<span class="lineNum"> 120 </span> : * information, see the iomanip header.
<span class="lineNum"> 121 </span> : */
<span class="lineNum"> 122 </span> : __istream_type&
<span class="lineNum"> 123 </span> : operator>>(__istream_type& (*__pf)(__istream_type&))
<span class="lineNum"> 124 </span> : { return __pf(*this); }
<span class="lineNum"> 125 </span> :
<span class="lineNum"> 126 </span> : __istream_type&
<span class="lineNum"> 127 </span> : operator>>(__ios_type& (*__pf)(__ios_type&))
<span class="lineNum"> 128 </span> : {
<span class="lineNum"> 129 </span> : __pf(*this);
<span class="lineNum"> 130 </span> : return *this;
<span class="lineNum"> 131 </span> : }
<span class="lineNum"> 132 </span> :
<span class="lineNum"> 133 </span> : __istream_type&
<span class="lineNum"> 134 </span> : operator>>(ios_base& (*__pf)(ios_base&))
<span class="lineNum"> 135 </span> : {
<span class="lineNum"> 136 </span> : __pf(*this);
<span class="lineNum"> 137 </span> : return *this;
<span class="lineNum"> 138 </span> : }
<span class="lineNum"> 139 </span> : //@}
<span class="lineNum"> 140 </span> :
<span class="lineNum"> 141 </span> : // [27.6.1.2.2] arithmetic extractors
<span class="lineNum"> 142 </span> : /**
<span class="lineNum"> 143 </span> : * @name Arithmetic Extractors
<span class="lineNum"> 144 </span> : *
<span class="lineNum"> 145 </span> : * All the @c operator>> functions (aka <em>formatted input
<span class="lineNum"> 146 </span> : * functions</em>) have some common behavior. Each starts by
<span class="lineNum"> 147 </span> : * constructing a temporary object of type std::basic_istream::sentry
<span class="lineNum"> 148 </span> : * with the second argument (noskipws) set to false. This has several
<span class="lineNum"> 149 </span> : * effects, concluding with the setting of a status flag; see the
<span class="lineNum"> 150 </span> : * sentry documentation for more.
<span class="lineNum"> 151 </span> : *
<span class="lineNum"> 152 </span> : * If the sentry status is good, the function tries to extract
<span class="lineNum"> 153 </span> : * whatever data is appropriate for the type of the argument.
<span class="lineNum"> 154 </span> : *
<span class="lineNum"> 155 </span> : * If an exception is thrown during extraction, ios_base::badbit
<span class="lineNum"> 156 </span> : * will be turned on in the stream's error state without causing an
<span class="lineNum"> 157 </span> : * ios_base::failure to be thrown. The original exception will then
<span class="lineNum"> 158 </span> : * be rethrown.
<span class="lineNum"> 159 </span> : */
<span class="lineNum"> 160 </span> : //@{
<span class="lineNum"> 161 </span> : /**
<span class="lineNum"> 162 </span> : * @brief Basic arithmetic extractors
<span class="lineNum"> 163 </span> : * @param A variable of builtin type.
<span class="lineNum"> 164 </span> : * @return @c *this if successful
<span class="lineNum"> 165 </span> : *
<span class="lineNum"> 166 </span> : * These functions use the stream's current locale (specifically, the
<span class="lineNum"> 167 </span> : * @c num_get facet) to parse the input data.
<span class="lineNum"> 168 </span> : */
<span class="lineNum"> 169 </span> : __istream_type&
<span class="lineNum"> 170 </span> : operator>>(bool& __n)
<span class="lineNum"> 171 </span> : { return _M_extract(__n); }
<span class="lineNum"> 172 </span> :
<span class="lineNum"> 173 </span> : __istream_type&
<span class="lineNum"> 174 </span> : operator>>(short& __n);
<span class="lineNum"> 175 </span> :
<span class="lineNum"> 176 </span> : __istream_type&
<span class="lineNum"> 177 </span> : operator>>(unsigned short& __n)
<span class="lineNum"> 178 </span> : { return _M_extract(__n); }
<span class="lineNum"> 179 </span> :
<span class="lineNum"> 180 </span> : __istream_type&
<span class="lineNum"> 181 </span> : operator>>(int& __n);
<span class="lineNum"> 182 </span> :
<span class="lineNum"> 183 </span> : __istream_type&
<span class="lineNum"> 184 </span> : operator>>(unsigned int& __n)
<span class="lineNum"> 185 </span> : { return _M_extract(__n); }
<span class="lineNum"> 186 </span> :
<span class="lineNum"> 187 </span> : __istream_type&
<span class="lineNum"> 188 </span> : operator>>(long& __n)
<span class="lineNum"> 189 </span> : { return _M_extract(__n); }
<span class="lineNum"> 190 </span> :
<span class="lineNum"> 191 </span> : __istream_type&
<span class="lineNum"> 192 </span> : operator>>(unsigned long& __n)
<span class="lineNum"> 193 </span> : { return _M_extract(__n); }
<span class="lineNum"> 194 </span> :
<span class="lineNum"> 195 </span> : #ifdef _GLIBCXX_USE_LONG_LONG
<span class="lineNum"> 196 </span> : __istream_type&
<span class="lineNum"> 197 </span> : operator>>(long long& __n)
<span class="lineNum"> 198 </span> : { return _M_extract(__n); }
<span class="lineNum"> 199 </span> :
<span class="lineNum"> 200 </span> : __istream_type&
<span class="lineNum"> 201 </span> : operator>>(unsigned long long& __n)
<span class="lineNum"> 202 </span> : { return _M_extract(__n); }
<span class="lineNum"> 203 </span> : #endif
<span class="lineNum"> 204 </span> :
<span class="lineNum"> 205 </span> : __istream_type&
<span class="lineNum"> 206 </span> : operator>>(float& __f)
<span class="lineNum"> 207 </span> : { return _M_extract(__f); }
<span class="lineNum"> 208 </span> :
<span class="lineNum"> 209 </span> : __istream_type&
<span class="lineNum"> 210 </span> : operator>>(double& __f)
<span class="lineNum"> 211 </span> : { return _M_extract(__f); }
<span class="lineNum"> 212 </span> :
<span class="lineNum"> 213 </span> : __istream_type&
<span class="lineNum"> 214 </span> : operator>>(long double& __f)
<span class="lineNum"> 215 </span> : { return _M_extract(__f); }
<span class="lineNum"> 216 </span> :
<span class="lineNum"> 217 </span> : __istream_type&
<span class="lineNum"> 218 </span> : operator>>(void*& __p)
<span class="lineNum"> 219 </span> : { return _M_extract(__p); }
<span class="lineNum"> 220 </span> :
<span class="lineNum"> 221 </span> : /**
<span class="lineNum"> 222 </span> : * @brief Extracting into another streambuf.
<span class="lineNum"> 223 </span> : * @param sb A pointer to a streambuf
<span class="lineNum"> 224 </span> : *
<span class="lineNum"> 225 </span> : * This function behaves like one of the basic arithmetic extractors,
<span class="lineNum"> 226 </span> : * in that it also constructs a sentry object and has the same error
<span class="lineNum"> 227 </span> : * handling behavior.
<span class="lineNum"> 228 </span> : *
<span class="lineNum"> 229 </span> : * If @a sb is NULL, the stream will set failbit in its error state.
<span class="lineNum"> 230 </span> : *
<span class="lineNum"> 231 </span> : * Characters are extracted from this stream and inserted into the
<span class="lineNum"> 232 </span> : * @a sb streambuf until one of the following occurs:
<span class="lineNum"> 233 </span> : *
<span class="lineNum"> 234 </span> : * - the input stream reaches end-of-file,
<span class="lineNum"> 235 </span> : * - insertion into the output buffer fails (in this case, the
<span class="lineNum"> 236 </span> : * character that would have been inserted is not extracted), or
<span class="lineNum"> 237 </span> : * - an exception occurs (and in this case is caught)
<span class="lineNum"> 238 </span> : *
<span class="lineNum"> 239 </span> : * If the function inserts no characters, failbit is set.
<span class="lineNum"> 240 </span> : */
<span class="lineNum"> 241 </span> : __istream_type&
<span class="lineNum"> 242 </span> : operator>>(__streambuf_type* __sb);
<span class="lineNum"> 243 </span> : //@}
<span class="lineNum"> 244 </span> :
<span class="lineNum"> 245 </span> : // [27.6.1.3] unformatted input
<span class="lineNum"> 246 </span> : /**
<span class="lineNum"> 247 </span> : * @brief Character counting
<span class="lineNum"> 248 </span> : * @return The number of characters extracted by the previous
<span class="lineNum"> 249 </span> : * unformatted input function dispatched for this stream.
<span class="lineNum"> 250 </span> : */
<span class="lineNum"> 251 </span> : streamsize
<span class="lineNum"> 252 </span> : gcount() const
<span class="lineNum"> 253 </span> : { return _M_gcount; }
<span class="lineNum"> 254 </span> :
<span class="lineNum"> 255 </span> : /**
<span class="lineNum"> 256 </span> : * @name Unformatted Input Functions
<span class="lineNum"> 257 </span> : *
<span class="lineNum"> 258 </span> : * All the unformatted input functions have some common behavior.
<span class="lineNum"> 259 </span> : * Each starts by constructing a temporary object of type
<span class="lineNum"> 260 </span> : * std::basic_istream::sentry with the second argument (noskipws)
<span class="lineNum"> 261 </span> : * set to true. This has several effects, concluding with the
<span class="lineNum"> 262 </span> : * setting of a status flag; see the sentry documentation for more.
<span class="lineNum"> 263 </span> : *
<span class="lineNum"> 264 </span> : * If the sentry status is good, the function tries to extract
<span class="lineNum"> 265 </span> : * whatever data is appropriate for the type of the argument.
<span class="lineNum"> 266 </span> : *
<span class="lineNum"> 267 </span> : * The number of characters extracted is stored for later retrieval
<span class="lineNum"> 268 </span> : * by gcount().
<span class="lineNum"> 269 </span> : *
<span class="lineNum"> 270 </span> : * If an exception is thrown during extraction, ios_base::badbit
<span class="lineNum"> 271 </span> : * will be turned on in the stream's error state without causing an
<span class="lineNum"> 272 </span> : * ios_base::failure to be thrown. The original exception will then
<span class="lineNum"> 273 </span> : * be rethrown.
<span class="lineNum"> 274 </span> : */
<span class="lineNum"> 275 </span> : //@{
<span class="lineNum"> 276 </span> : /**
<span class="lineNum"> 277 </span> : * @brief Simple extraction.
<span class="lineNum"> 278 </span> : * @return A character, or eof().
<span class="lineNum"> 279 </span> : *
<span class="lineNum"> 280 </span> : * Tries to extract a character. If none are available, sets failbit
<span class="lineNum"> 281 </span> : * and returns traits::eof().
<span class="lineNum"> 282 </span> : */
<span class="lineNum"> 283 </span> : int_type
<span class="lineNum"> 284 </span> : get();
<span class="lineNum"> 285 </span> :
<span class="lineNum"> 286 </span> : /**
<span class="lineNum"> 287 </span> : * @brief Simple extraction.
<span class="lineNum"> 288 </span> : * @param c The character in which to store data.
<span class="lineNum"> 289 </span> : * @return *this
<span class="lineNum"> 290 </span> : *
<span class="lineNum"> 291 </span> : * Tries to extract a character and store it in @a c. If none are
<span class="lineNum"> 292 </span> : * available, sets failbit and returns traits::eof().
<span class="lineNum"> 293 </span> : *
<span class="lineNum"> 294 </span> : * @note This function is not overloaded on signed char and
<span class="lineNum"> 295 </span> : * unsigned char.
<span class="lineNum"> 296 </span> : */
<span class="lineNum"> 297 </span> : __istream_type&
<span class="lineNum"> 298 </span> : get(char_type& __c);
<span class="lineNum"> 299 </span> :
<span class="lineNum"> 300 </span> : /**
<span class="lineNum"> 301 </span> : * @brief Simple multiple-character extraction.
<span class="lineNum"> 302 </span> : * @param s Pointer to an array.
<span class="lineNum"> 303 </span> : * @param n Maximum number of characters to store in @a s.
<span class="lineNum"> 304 </span> : * @param delim A "stop" character.
<span class="lineNum"> 305 </span> : * @return *this
<span class="lineNum"> 306 </span> : *
<span class="lineNum"> 307 </span> : * Characters are extracted and stored into @a s until one of the
<span class="lineNum"> 308 </span> : * following happens:
<span class="lineNum"> 309 </span> : *
<span class="lineNum"> 310 </span> : * - @c n-1 characters are stored
<span class="lineNum"> 311 </span> : * - the input sequence reaches EOF
<span class="lineNum"> 312 </span> : * - the next character equals @a delim, in which case the character
<span class="lineNum"> 313 </span> : * is not extracted
<span class="lineNum"> 314 </span> : *
<span class="lineNum"> 315 </span> : * If no characters are stored, failbit is set in the stream's error
<span class="lineNum"> 316 </span> : * state.
<span class="lineNum"> 317 </span> : *
<span class="lineNum"> 318 </span> : * In any case, a null character is stored into the next location in
<span class="lineNum"> 319 </span> : * the array.
<span class="lineNum"> 320 </span> : *
<span class="lineNum"> 321 </span> : * @note This function is not overloaded on signed char and
<span class="lineNum"> 322 </span> : * unsigned char.
<span class="lineNum"> 323 </span> : */
<span class="lineNum"> 324 </span> : __istream_type&
<span class="lineNum"> 325 </span> : get(char_type* __s, streamsize __n, char_type __delim);
<span class="lineNum"> 326 </span> :
<span class="lineNum"> 327 </span> : /**
<span class="lineNum"> 328 </span> : * @brief Simple multiple-character extraction.
<span class="lineNum"> 329 </span> : * @param s Pointer to an array.
<span class="lineNum"> 330 </span> : * @param n Maximum number of characters to store in @a s.
<span class="lineNum"> 331 </span> : * @return *this
<span class="lineNum"> 332 </span> : *
<span class="lineNum"> 333 </span> : * Returns @c get(s,n,widen('\n')).
<span class="lineNum"> 334 </span> : */
<span class="lineNum"> 335 </span> : __istream_type&
<span class="lineNum"> 336 </span> : get(char_type* __s, streamsize __n)
<span class="lineNum"> 337 </span> : { return this->get(__s, __n, this->widen('\n')); }
<span class="lineNum"> 338 </span> :
<span class="lineNum"> 339 </span> : /**
<span class="lineNum"> 340 </span> : * @brief Extraction into another streambuf.
<span class="lineNum"> 341 </span> : * @param sb A streambuf in which to store data.
<span class="lineNum"> 342 </span> : * @param delim A "stop" character.
<span class="lineNum"> 343 </span> : * @return *this
<span class="lineNum"> 344 </span> : *
<span class="lineNum"> 345 </span> : * Characters are extracted and inserted into @a sb until one of the
<span class="lineNum"> 346 </span> : * following happens:
<span class="lineNum"> 347 </span> : *
<span class="lineNum"> 348 </span> : * - the input sequence reaches EOF
<span class="lineNum"> 349 </span> : * - insertion into the output buffer fails (in this case, the
<span class="lineNum"> 350 </span> : * character that would have been inserted is not extracted)
<span class="lineNum"> 351 </span> : * - the next character equals @a delim (in this case, the character
<span class="lineNum"> 352 </span> : * is not extracted)
<span class="lineNum"> 353 </span> : * - an exception occurs (and in this case is caught)
<span class="lineNum"> 354 </span> : *
<span class="lineNum"> 355 </span> : * If no characters are stored, failbit is set in the stream's error
<span class="lineNum"> 356 </span> : * state.
<span class="lineNum"> 357 </span> : */
<span class="lineNum"> 358 </span> : __istream_type&
<span class="lineNum"> 359 </span> : get(__streambuf_type& __sb, char_type __delim);
<span class="lineNum"> 360 </span> :
<span class="lineNum"> 361 </span> : /**
<span class="lineNum"> 362 </span> : * @brief Extraction into another streambuf.
<span class="lineNum"> 363 </span> : * @param sb A streambuf in which to store data.
<span class="lineNum"> 364 </span> : * @return *this
<span class="lineNum"> 365 </span> : *
<span class="lineNum"> 366 </span> : * Returns @c get(sb,widen('\n')).
<span class="lineNum"> 367 </span> : */
<span class="lineNum"> 368 </span> : __istream_type&
<span class="lineNum"> 369 </span> : get(__streambuf_type& __sb)
<span class="lineNum"> 370 </span> : { return this->get(__sb, this->widen('\n')); }
<span class="lineNum"> 371 </span> :
<span class="lineNum"> 372 </span> : /**
<span class="lineNum"> 373 </span> : * @brief String extraction.
<span class="lineNum"> 374 </span> : * @param s A character array in which to store the data.
<span class="lineNum"> 375 </span> : * @param n Maximum number of characters to extract.
<span class="lineNum"> 376 </span> : * @param delim A "stop" character.
<span class="lineNum"> 377 </span> : * @return *this
<span class="lineNum"> 378 </span> : *
<span class="lineNum"> 379 </span> : * Extracts and stores characters into @a s until one of the
<span class="lineNum"> 380 </span> : * following happens. Note that these criteria are required to be
<span class="lineNum"> 381 </span> : * tested in the order listed here, to allow an input line to exactly
<span class="lineNum"> 382 </span> : * fill the @a s array without setting failbit.
<span class="lineNum"> 383 </span> : *
<span class="lineNum"> 384 </span> : * -# the input sequence reaches end-of-file, in which case eofbit
<span class="lineNum"> 385 </span> : * is set in the stream error state
<span class="lineNum"> 386 </span> : * -# the next character equals @c delim, in which case the character
<span class="lineNum"> 387 </span> : * is extracted (and therefore counted in @c gcount()) but not stored
<span class="lineNum"> 388 </span> : * -# @c n-1 characters are stored, in which case failbit is set
<span class="lineNum"> 389 </span> : * in the stream error state
<span class="lineNum"> 390 </span> : *
<span class="lineNum"> 391 </span> : * If no characters are extracted, failbit is set. (An empty line of
<span class="lineNum"> 392 </span> : * input should therefore not cause failbit to be set.)
<span class="lineNum"> 393 </span> : *
<span class="lineNum"> 394 </span> : * In any case, a null character is stored in the next location in
<span class="lineNum"> 395 </span> : * the array.
<span class="lineNum"> 396 </span> : */
<span class="lineNum"> 397 </span> : __istream_type&
<span class="lineNum"> 398 </span> : getline(char_type* __s, streamsize __n, char_type __delim);
<span class="lineNum"> 399 </span> :
<span class="lineNum"> 400 </span> : /**
<span class="lineNum"> 401 </span> : * @brief String extraction.
<span class="lineNum"> 402 </span> : * @param s A character array in which to store the data.
<span class="lineNum"> 403 </span> : * @param n Maximum number of characters to extract.
<span class="lineNum"> 404 </span> : * @return *this
<span class="lineNum"> 405 </span> : *
<span class="lineNum"> 406 </span> : * Returns @c getline(s,n,widen('\n')).
<span class="lineNum"> 407 </span> : */
<span class="lineNum"> 408 </span> : __istream_type&
<span class="lineNum"> 409 </span> : getline(char_type* __s, streamsize __n)
<span class="lineNum"> 410 </span> : { return this->getline(__s, __n, this->widen('\n')); }
<span class="lineNum"> 411 </span> :
<span class="lineNum"> 412 </span> : /**
<span class="lineNum"> 413 </span> : * @brief Discarding characters
<span class="lineNum"> 414 </span> : * @param n Number of characters to discard.
<span class="lineNum"> 415 </span> : * @param delim A "stop" character.
<span class="lineNum"> 416 </span> : * @return *this
<span class="lineNum"> 417 </span> : *
<span class="lineNum"> 418 </span> : * Extracts characters and throws them away until one of the
<span class="lineNum"> 419 </span> : * following happens:
<span class="lineNum"> 420 </span> : * - if @a n @c != @c std::numeric_limits<int>::max(), @a n
<span class="lineNum"> 421 </span> : * characters are extracted
<span class="lineNum"> 422 </span> : * - the input sequence reaches end-of-file
<span class="lineNum"> 423 </span> : * - the next character equals @a delim (in this case, the character
<span class="lineNum"> 424 </span> : * is extracted); note that this condition will never occur if
<span class="lineNum"> 425 </span> : * @a delim equals @c traits::eof().
<span class="lineNum"> 426 </span> : *
<span class="lineNum"> 427 </span> : * NB: Provide three overloads, instead of the single function
<span class="lineNum"> 428 </span> : * (with defaults) mandated by the Standard: this leads to a
<span class="lineNum"> 429 </span> : * better performing implementation, while still conforming to
<span class="lineNum"> 430 </span> : * the Standard.
<span class="lineNum"> 431 </span> : */
<span class="lineNum"> 432 </span> : __istream_type&
<span class="lineNum"> 433 </span> : ignore();
<span class="lineNum"> 434 </span> :
<span class="lineNum"> 435 </span> : __istream_type&
<span class="lineNum"> 436 </span> : ignore(streamsize __n);
<span class="lineNum"> 437 </span> :
<span class="lineNum"> 438 </span> : __istream_type&
<span class="lineNum"> 439 </span> : ignore(streamsize __n, int_type __delim);
<span class="lineNum"> 440 </span> :
<span class="lineNum"> 441 </span> : /**
<span class="lineNum"> 442 </span> : * @brief Looking ahead in the stream
<span class="lineNum"> 443 </span> : * @return The next character, or eof().
<span class="lineNum"> 444 </span> : *
<span class="lineNum"> 445 </span> : * If, after constructing the sentry object, @c good() is false,
<span class="lineNum"> 446 </span> : * returns @c traits::eof(). Otherwise reads but does not extract
<span class="lineNum"> 447 </span> : * the next input character.
<span class="lineNum"> 448 </span> : */
<span class="lineNum"> 449 </span> : int_type
<span class="lineNum"> 450 </span> : peek();
<span class="lineNum"> 451 </span> :
<span class="lineNum"> 452 </span> : /**
<span class="lineNum"> 453 </span> : * @brief Extraction without delimiters.
<span class="lineNum"> 454 </span> : * @param s A character array.
<span class="lineNum"> 455 </span> : * @param n Maximum number of characters to store.
<span class="lineNum"> 456 </span> : * @return *this
<span class="lineNum"> 457 </span> : *
<span class="lineNum"> 458 </span> : * If the stream state is @c good(), extracts characters and stores
<span class="lineNum"> 459 </span> : * them into @a s until one of the following happens:
<span class="lineNum"> 460 </span> : * - @a n characters are stored
<span class="lineNum"> 461 </span> : * - the input sequence reaches end-of-file, in which case the error
<span class="lineNum"> 462 </span> : * state is set to @c failbit|eofbit.
<span class="lineNum"> 463 </span> : *
<span class="lineNum"> 464 </span> : * @note This function is not overloaded on signed char and
<span class="lineNum"> 465 </span> : * unsigned char.
<span class="lineNum"> 466 </span> : */
<span class="lineNum"> 467 </span> : __istream_type&
<span class="lineNum"> 468 </span> : read(char_type* __s, streamsize __n);
<span class="lineNum"> 469 </span> :
<span class="lineNum"> 470 </span> : /**
<span class="lineNum"> 471 </span> : * @brief Extraction until the buffer is exhausted, but no more.
<span class="lineNum"> 472 </span> : * @param s A character array.
<span class="lineNum"> 473 </span> : * @param n Maximum number of characters to store.
<span class="lineNum"> 474 </span> : * @return The number of characters extracted.
<span class="lineNum"> 475 </span> : *
<span class="lineNum"> 476 </span> : * Extracts characters and stores them into @a s depending on the
<span class="lineNum"> 477 </span> : * number of characters remaining in the streambuf's buffer,
<span class="lineNum"> 478 </span> : * @c rdbuf()->in_avail(), called @c A here:
<span class="lineNum"> 479 </span> : * - if @c A @c == @c -1, sets eofbit and extracts no characters
<span class="lineNum"> 480 </span> : * - if @c A @c == @c 0, extracts no characters
<span class="lineNum"> 481 </span> : * - if @c A @c > @c 0, extracts @c min(A,n)
<span class="lineNum"> 482 </span> : *
<span class="lineNum"> 483 </span> : * The goal is to empty the current buffer, and to not request any
<span class="lineNum"> 484 </span> : * more from the external input sequence controlled by the streambuf.
<span class="lineNum"> 485 </span> : */
<span class="lineNum"> 486 </span> : streamsize
<span class="lineNum"> 487 </span> : readsome(char_type* __s, streamsize __n);
<span class="lineNum"> 488 </span> :
<span class="lineNum"> 489 </span> : /**
<span class="lineNum"> 490 </span> : * @brief Unextracting a single character.
<span class="lineNum"> 491 </span> : * @param c The character to push back into the input stream.
<span class="lineNum"> 492 </span> : * @return *this
<span class="lineNum"> 493 </span> : *
<span class="lineNum"> 494 </span> : * If @c rdbuf() is not null, calls @c rdbuf()->sputbackc(c).
<span class="lineNum"> 495 </span> : *
<span class="lineNum"> 496 </span> : * If @c rdbuf() is null or if @c sputbackc() fails, sets badbit in
<span class="lineNum"> 497 </span> : * the error state.
<span class="lineNum"> 498 </span> : *
<span class="lineNum"> 499 </span> : * @note Since no characters are extracted, the next call to
<span class="lineNum"> 500 </span> : * @c gcount() will return 0, as required by DR 60.
<span class="lineNum"> 501 </span> : */
<span class="lineNum"> 502 </span> : __istream_type&
<span class="lineNum"> 503 </span> : putback(char_type __c);
<span class="lineNum"> 504 </span> :
<span class="lineNum"> 505 </span> : /**
<span class="lineNum"> 506 </span> : * @brief Unextracting the previous character.
<span class="lineNum"> 507 </span> : * @return *this
<span class="lineNum"> 508 </span> : *
<span class="lineNum"> 509 </span> : * If @c rdbuf() is not null, calls @c rdbuf()->sungetc(c).
<span class="lineNum"> 510 </span> : *
<span class="lineNum"> 511 </span> : * If @c rdbuf() is null or if @c sungetc() fails, sets badbit in
<span class="lineNum"> 512 </span> : * the error state.
<span class="lineNum"> 513 </span> : *
<span class="lineNum"> 514 </span> : * @note Since no characters are extracted, the next call to
<span class="lineNum"> 515 </span> : * @c gcount() will return 0, as required by DR 60.
<span class="lineNum"> 516 </span> : */
<span class="lineNum"> 517 </span> : __istream_type&
<span class="lineNum"> 518 </span> : unget();
<span class="lineNum"> 519 </span> :
<span class="lineNum"> 520 </span> : /**
<span class="lineNum"> 521 </span> : * @brief Synchronizing the stream buffer.
<span class="lineNum"> 522 </span> : * @return 0 on success, -1 on failure
<span class="lineNum"> 523 </span> : *
<span class="lineNum"> 524 </span> : * If @c rdbuf() is a null pointer, returns -1.
<span class="lineNum"> 525 </span> : *
<span class="lineNum"> 526 </span> : * Otherwise, calls @c rdbuf()->pubsync(), and if that returns -1,
<span class="lineNum"> 527 </span> : * sets badbit and returns -1.
<span class="lineNum"> 528 </span> : *
<span class="lineNum"> 529 </span> : * Otherwise, returns 0.
<span class="lineNum"> 530 </span> : *
<span class="lineNum"> 531 </span> : * @note This function does not count the number of characters
<span class="lineNum"> 532 </span> : * extracted, if any, and therefore does not affect the next
<span class="lineNum"> 533 </span> : * call to @c gcount().
<span class="lineNum"> 534 </span> : */
<span class="lineNum"> 535 </span> : int
<span class="lineNum"> 536 </span> : sync();
<span class="lineNum"> 537 </span> :
<span class="lineNum"> 538 </span> : /**
<span class="lineNum"> 539 </span> : * @brief Getting the current read position.
<span class="lineNum"> 540 </span> : * @return A file position object.
<span class="lineNum"> 541 </span> : *
<span class="lineNum"> 542 </span> : * If @c fail() is not false, returns @c pos_type(-1) to indicate
<span class="lineNum"> 543 </span> : * failure. Otherwise returns @c rdbuf()->pubseekoff(0,cur,in).
<span class="lineNum"> 544 </span> : *
<span class="lineNum"> 545 </span> : * @note This function does not count the number of characters
<span class="lineNum"> 546 </span> : * extracted, if any, and therefore does not affect the next
<span class="lineNum"> 547 </span> : * call to @c gcount().
<span class="lineNum"> 548 </span> : */
<span class="lineNum"> 549 </span> : pos_type
<span class="lineNum"> 550 </span> : tellg();
<span class="lineNum"> 551 </span> :
<span class="lineNum"> 552 </span> : /**
<span class="lineNum"> 553 </span> : * @brief Changing the current read position.
<span class="lineNum"> 554 </span> : * @param pos A file position object.
<span class="lineNum"> 555 </span> : * @return *this
<span class="lineNum"> 556 </span> : *
<span class="lineNum"> 557 </span> : * If @c fail() is not true, calls @c rdbuf()->pubseekpos(pos). If
<span class="lineNum"> 558 </span> : * that function fails, sets failbit.
<span class="lineNum"> 559 </span> : *
<span class="lineNum"> 560 </span> : * @note This function does not count the number of characters
<span class="lineNum"> 561 </span> : * extracted, if any, and therefore does not affect the next
<span class="lineNum"> 562 </span> : * call to @c gcount().
<span class="lineNum"> 563 </span> : */
<span class="lineNum"> 564 </span> : __istream_type&
<span class="lineNum"> 565 </span> : seekg(pos_type);
<span class="lineNum"> 566 </span> :
<span class="lineNum"> 567 </span> : /**
<span class="lineNum"> 568 </span> : * @brief Changing the current read position.
<span class="lineNum"> 569 </span> : * @param off A file offset object.
<span class="lineNum"> 570 </span> : * @param dir The direction in which to seek.
<span class="lineNum"> 571 </span> : * @return *this
<span class="lineNum"> 572 </span> : *
<span class="lineNum"> 573 </span> : * If @c fail() is not true, calls @c rdbuf()->pubseekoff(off,dir).
<span class="lineNum"> 574 </span> : * If that function fails, sets failbit.
<span class="lineNum"> 575 </span> : *
<span class="lineNum"> 576 </span> : * @note This function does not count the number of characters
<span class="lineNum"> 577 </span> : * extracted, if any, and therefore does not affect the next
<span class="lineNum"> 578 </span> : * call to @c gcount().
<span class="lineNum"> 579 </span> : */
<span class="lineNum"> 580 </span> : __istream_type&
<span class="lineNum"> 581 </span> : seekg(off_type, ios_base::seekdir);
<span class="lineNum"> 582 </span> : //@}
<span class="lineNum"> 583 </span> :
<span class="lineNum"> 584 </span> : protected:
<span class="lineNum"> 585 </span><span class="lineNoCov"> 0 : basic_istream()</span>
<span class="lineNum"> 586 </span><span class="lineNoCov"> 0 : : _M_gcount(streamsize(0))</span>
<span class="lineNum"> 587 </span><span class="lineNoCov"> 0 : { this->init(0); }</span>
<span class="lineNum"> 588 </span> :
<span class="lineNum"> 589 </span> : template<typename _ValueT>
<span class="lineNum"> 590 </span> : __istream_type&
<span class="lineNum"> 591 </span> : _M_extract(_ValueT& __v);
<span class="lineNum"> 592 </span> : };
<span class="lineNum"> 593 </span> :
<span class="lineNum"> 594 </span> : // Explicit specialization declarations, defined in src/istream.cc.
<span class="lineNum"> 595 </span> : template<>
<span class="lineNum"> 596 </span> : basic_istream<char>&
<span class="lineNum"> 597 </span> : basic_istream<char>::
<span class="lineNum"> 598 </span> : getline(char_type* __s, streamsize __n, char_type __delim);
<span class="lineNum"> 599 </span> :
<span class="lineNum"> 600 </span> : template<>
<span class="lineNum"> 601 </span> : basic_istream<char>&
<span class="lineNum"> 602 </span> : basic_istream<char>::
<span class="lineNum"> 603 </span> : ignore(streamsize __n);
<span class="lineNum"> 604 </span> :
<span class="lineNum"> 605 </span> : template<>
<span class="lineNum"> 606 </span> : basic_istream<char>&
<span class="lineNum"> 607 </span> : basic_istream<char>::
<span class="lineNum"> 608 </span> : ignore(streamsize __n, int_type __delim);
<span class="lineNum"> 609 </span> :
<span class="lineNum"> 610 </span> : #ifdef _GLIBCXX_USE_WCHAR_T
<span class="lineNum"> 611 </span> : template<>
<span class="lineNum"> 612 </span> : basic_istream<wchar_t>&
<span class="lineNum"> 613 </span> : basic_istream<wchar_t>::
<span class="lineNum"> 614 </span> : getline(char_type* __s, streamsize __n, char_type __delim);
<span class="lineNum"> 615 </span> :
<span class="lineNum"> 616 </span> : template<>
<span class="lineNum"> 617 </span> : basic_istream<wchar_t>&
<span class="lineNum"> 618 </span> : basic_istream<wchar_t>::
<span class="lineNum"> 619 </span> : ignore(streamsize __n);
<span class="lineNum"> 620 </span> :
<span class="lineNum"> 621 </span> : template<>
<span class="lineNum"> 622 </span> : basic_istream<wchar_t>&
<span class="lineNum"> 623 </span> : basic_istream<wchar_t>::
<span class="lineNum"> 624 </span> : ignore(streamsize __n, int_type __delim);
<span class="lineNum"> 625 </span> : #endif
<span class="lineNum"> 626 </span> :
<span class="lineNum"> 627 </span> : /**
<span class="lineNum"> 628 </span> : * @brief Performs setup work for input streams.
<span class="lineNum"> 629 </span> : *
<span class="lineNum"> 630 </span> : * Objects of this class are created before all of the standard
<span class="lineNum"> 631 </span> : * extractors are run. It is responsible for "exception-safe prefix and
<span class="lineNum"> 632 </span> : * suffix operations," although only prefix actions are currently required
<span class="lineNum"> 633 </span> : * by the standard. Additional actions may be added by the
<span class="lineNum"> 634 </span> : * implementation, and we list them in
<span class="lineNum"> 635 </span> : * http://gcc.gnu.org/onlinedocs/libstdc++/17_intro/howto.html#5
<span class="lineNum"> 636 </span> : * under [27.6] notes.
<span class="lineNum"> 637 </span> : */
<span class="lineNum"> 638 </span> : template<typename _CharT, typename _Traits>
<span class="lineNum"> 639 </span> : class basic_istream<_CharT, _Traits>::sentry
<span class="lineNum"> 640 </span> : {
<span class="lineNum"> 641 </span> : public:
<span class="lineNum"> 642 </span> : /// Easy access to dependant types.
<span class="lineNum"> 643 </span> : typedef _Traits traits_type;
<span class="lineNum"> 644 </span> : typedef basic_streambuf<_CharT, _Traits> __streambuf_type;
<span class="lineNum"> 645 </span> : typedef basic_istream<_CharT, _Traits> __istream_type;
<span class="lineNum"> 646 </span> : typedef typename __istream_type::__ctype_type __ctype_type;
<span class="lineNum"> 647 </span> : typedef typename _Traits::int_type __int_type;
<span class="lineNum"> 648 </span> :
<span class="lineNum"> 649 </span> : /**
<span class="lineNum"> 650 </span> : * @brief The constructor performs all the work.
<span class="lineNum"> 651 </span> : * @param is The input stream to guard.
<span class="lineNum"> 652 </span> : * @param noskipws Whether to consume whitespace or not.
<span class="lineNum"> 653 </span> : *
<span class="lineNum"> 654 </span> : * If the stream state is good (@a is.good() is true), then the
<span class="lineNum"> 655 </span> : * following actions are performed, otherwise the sentry state is
<span class="lineNum"> 656 </span> : * false ("not okay") and failbit is set in the stream state.
<span class="lineNum"> 657 </span> : *
<span class="lineNum"> 658 </span> : * The sentry's preparatory actions are:
<span class="lineNum"> 659 </span> : *
<span class="lineNum"> 660 </span> : * -# if the stream is tied to an output stream, @c is.tie()->flush()
<span class="lineNum"> 661 </span> : * is called to synchronize the output sequence
<span class="lineNum"> 662 </span> : * -# if @a noskipws is false, and @c ios_base::skipws is set in
<span class="lineNum"> 663 </span> : * @c is.flags(), the sentry extracts and discards whitespace
<span class="lineNum"> 664 </span> : * characters from the stream. The currently imbued locale is
<span class="lineNum"> 665 </span> : * used to determine whether each character is whitespace.
<span class="lineNum"> 666 </span> : *
<span class="lineNum"> 667 </span> : * If the stream state is still good, then the sentry state becomes
<span class="lineNum"> 668 </span> : * true ("okay").
<span class="lineNum"> 669 </span> : */
<span class="lineNum"> 670 </span> : explicit
<span class="lineNum"> 671 </span> : sentry(basic_istream<_CharT, _Traits>& __is, bool __noskipws = false);
<span class="lineNum"> 672 </span> :
<span class="lineNum"> 673 </span> : /**
<span class="lineNum"> 674 </span> : * @brief Quick status checking.
<span class="lineNum"> 675 </span> : * @return The sentry state.
<span class="lineNum"> 676 </span> : *
<span class="lineNum"> 677 </span> : * For ease of use, sentries may be converted to booleans. The
<span class="lineNum"> 678 </span> : * return value is that of the sentry state (true == okay).
<span class="lineNum"> 679 </span> : */
<span class="lineNum"> 680 </span> : operator bool() const
<span class="lineNum"> 681 </span> : { return _M_ok; }
<span class="lineNum"> 682 </span> :
<span class="lineNum"> 683 </span> : private:
<span class="lineNum"> 684 </span> : bool _M_ok;
<span class="lineNum"> 685 </span> : };
<span class="lineNum"> 686 </span> :
<span class="lineNum"> 687 </span> : // [27.6.1.2.3] character extraction templates
<span class="lineNum"> 688 </span> : //@{
<span class="lineNum"> 689 </span> : /**
<span class="lineNum"> 690 </span> : * @brief Character extractors
<span class="lineNum"> 691 </span> : * @param in An input stream.
<span class="lineNum"> 692 </span> : * @param c A character reference.
<span class="lineNum"> 693 </span> : * @return in
<span class="lineNum"> 694 </span> : *
<span class="lineNum"> 695 </span> : * Behaves like one of the formatted arithmetic extractors described in
<span class="lineNum"> 696 </span> : * std::basic_istream. After constructing a sentry object with good
<span class="lineNum"> 697 </span> : * status, this function extracts a character (if one is available) and
<span class="lineNum"> 698 </span> : * stores it in @a c. Otherwise, sets failbit in the input stream.
<span class="lineNum"> 699 </span> : */
<span class="lineNum"> 700 </span> : template<typename _CharT, typename _Traits>
<span class="lineNum"> 701 </span> : basic_istream<_CharT, _Traits>&
<span class="lineNum"> 702 </span> : operator>>(basic_istream<_CharT, _Traits>& __in, _CharT& __c);
<span class="lineNum"> 703 </span> :
<span class="lineNum"> 704 </span> : template<class _Traits>
<span class="lineNum"> 705 </span> : inline basic_istream<char, _Traits>&
<span class="lineNum"> 706 </span> : operator>>(basic_istream<char, _Traits>& __in, unsigned char& __c)
<span class="lineNum"> 707 </span> : { return (__in >> reinterpret_cast<char&>(__c)); }
<span class="lineNum"> 708 </span> :
<span class="lineNum"> 709 </span> : template<class _Traits>
<span class="lineNum"> 710 </span> : inline basic_istream<char, _Traits>&
<span class="lineNum"> 711 </span> : operator>>(basic_istream<char, _Traits>& __in, signed char& __c)
<span class="lineNum"> 712 </span> : { return (__in >> reinterpret_cast<char&>(__c)); }
<span class="lineNum"> 713 </span> : //@}
<span class="lineNum"> 714 </span> :
<span class="lineNum"> 715 </span> : //@{
<span class="lineNum"> 716 </span> : /**
<span class="lineNum"> 717 </span> : * @brief Character string extractors
<span class="lineNum"> 718 </span> : * @param in An input stream.
<span class="lineNum"> 719 </span> : * @param s A pointer to a character array.
<span class="lineNum"> 720 </span> : * @return in
<span class="lineNum"> 721 </span> : *
<span class="lineNum"> 722 </span> : * Behaves like one of the formatted arithmetic extractors described in
<span class="lineNum"> 723 </span> : * std::basic_istream. After constructing a sentry object with good
<span class="lineNum"> 724 </span> : * status, this function extracts up to @c n characters and stores them
<span class="lineNum"> 725 </span> : * into the array starting at @a s. @c n is defined as:
<span class="lineNum"> 726 </span> : *
<span class="lineNum"> 727 </span> : * - if @c width() is greater than zero, @c n is width()
<span class="lineNum"> 728 </span> : * - otherwise @c n is "the number of elements of the largest array of
<span class="lineNum"> 729 </span> : * @c char_type that can store a terminating @c eos." [27.6.1.2.3]/6
<span class="lineNum"> 730 </span> : *
<span class="lineNum"> 731 </span> : * Characters are extracted and stored until one of the following happens:
<span class="lineNum"> 732 </span> : * - @c n-1 characters are stored
<span class="lineNum"> 733 </span> : * - EOF is reached
<span class="lineNum"> 734 </span> : * - the next character is whitespace according to the current locale
<span class="lineNum"> 735 </span> : * - the next character is a null byte (i.e., @c charT() )
<span class="lineNum"> 736 </span> : *
<span class="lineNum"> 737 </span> : * @c width(0) is then called for the input stream.
<span class="lineNum"> 738 </span> : *
<span class="lineNum"> 739 </span> : * If no characters are extracted, sets failbit.
<span class="lineNum"> 740 </span> : */
<span class="lineNum"> 741 </span> : template<typename _CharT, typename _Traits>
<span class="lineNum"> 742 </span> : basic_istream<_CharT, _Traits>&
<span class="lineNum"> 743 </span> : operator>>(basic_istream<_CharT, _Traits>& __in, _CharT* __s);
<span class="lineNum"> 744 </span> :
<span class="lineNum"> 745 </span> : // Explicit specialization declaration, defined in src/istream.cc.
<span class="lineNum"> 746 </span> : template<>
<span class="lineNum"> 747 </span> : basic_istream<char>&
<span class="lineNum"> 748 </span> : operator>>(basic_istream<char>& __in, char* __s);
<span class="lineNum"> 749 </span> :
<span class="lineNum"> 750 </span> : template<class _Traits>
<span class="lineNum"> 751 </span> : inline basic_istream<char, _Traits>&
<span class="lineNum"> 752 </span> : operator>>(basic_istream<char, _Traits>& __in, unsigned char* __s)
<span class="lineNum"> 753 </span> : { return (__in >> reinterpret_cast<char*>(__s)); }
<span class="lineNum"> 754 </span> :
<span class="lineNum"> 755 </span> : template<class _Traits>
<span class="lineNum"> 756 </span> : inline basic_istream<char, _Traits>&
<span class="lineNum"> 757 </span> : operator>>(basic_istream<char, _Traits>& __in, signed char* __s)
<span class="lineNum"> 758 </span> : { return (__in >> reinterpret_cast<char*>(__s)); }
<span class="lineNum"> 759 </span> : //@}
<span class="lineNum"> 760 </span> :
<span class="lineNum"> 761 </span> : // 27.6.1.5 Template class basic_iostream
<span class="lineNum"> 762 </span> : /**
<span class="lineNum"> 763 </span> : * @brief Merging istream and ostream capabilities.
<span class="lineNum"> 764 </span> : *
<span class="lineNum"> 765 </span> : * This class multiply inherits from the input and output stream classes
<span class="lineNum"> 766 </span> : * simply to provide a single interface.
<span class="lineNum"> 767 </span> : */
<span class="lineNum"> 768 </span> : template<typename _CharT, typename _Traits>
<span class="lineNum"> 769 </span> : class basic_iostream
<span class="lineNum"> 770 </span> : : public basic_istream<_CharT, _Traits>,
<span class="lineNum"> 771 </span> : public basic_ostream<_CharT, _Traits>
<span class="lineNum"> 772 </span> : {
<span class="lineNum"> 773 </span> : public:
<span class="lineNum"> 774 </span> : // _GLIBCXX_RESOLVE_LIB_DEFECTS
<span class="lineNum"> 775 </span> : // 271. basic_iostream missing typedefs
<span class="lineNum"> 776 </span> : // Types (inherited):
<span class="lineNum"> 777 </span> : typedef _CharT char_type;
<span class="lineNum"> 778 </span> : typedef typename _Traits::int_type int_type;
<span class="lineNum"> 779 </span> : typedef typename _Traits::pos_type pos_type;
<span class="lineNum"> 780 </span> : typedef typename _Traits::off_type off_type;
<span class="lineNum"> 781 </span> : typedef _Traits traits_type;
<span class="lineNum"> 782 </span> :
<span class="lineNum"> 783 </span> : // Non-standard Types:
<span class="lineNum"> 784 </span> : typedef basic_istream<_CharT, _Traits> __istream_type;
<span class="lineNum"> 785 </span> : typedef basic_ostream<_CharT, _Traits> __ostream_type;
<span class="lineNum"> 786 </span> :
<span class="lineNum"> 787 </span> : /**
<span class="lineNum"> 788 </span> : * @brief Constructor does nothing.
<span class="lineNum"> 789 </span> : *
<span class="lineNum"> 790 </span> : * Both of the parent classes are initialized with the same
<span class="lineNum"> 791 </span> : * streambuf pointer passed to this constructor.
<span class="lineNum"> 792 </span> : */
<span class="lineNum"> 793 </span> : explicit
<span class="lineNum"> 794 </span> : basic_iostream(basic_streambuf<_CharT, _Traits>* __sb)
<span class="lineNum"> 795 </span> : : __istream_type(__sb), __ostream_type(__sb) { }
<span class="lineNum"> 796 </span> :
<span class="lineNum"> 797 </span> : /**
<span class="lineNum"> 798 </span> : * @brief Destructor does nothing.
<span class="lineNum"> 799 </span> : */
<span class="lineNum"> 800 </span> : virtual
<span class="lineNum"> 801 </span><span class="lineNoCov"> 0 : ~basic_iostream() { }</span>
<span class="lineNum"> 802 </span> :
<span class="lineNum"> 803 </span> : protected:
<span class="lineNum"> 804 </span><span class="lineNoCov"> 0 : basic_iostream()</span>
<span class="lineNum"> 805 </span><span class="lineNoCov"> 0 : : __istream_type(), __ostream_type() { }</span>
<span class="lineNum"> 806 </span> : };
<span class="lineNum"> 807 </span> :
<span class="lineNum"> 808 </span> : // [27.6.1.4] standard basic_istream manipulators
<span class="lineNum"> 809 </span> : /**
<span class="lineNum"> 810 </span> : * @brief Quick and easy way to eat whitespace
<span class="lineNum"> 811 </span> : *
<span class="lineNum"> 812 </span> : * This manipulator extracts whitespace characters, stopping when the
<span class="lineNum"> 813 </span> : * next character is non-whitespace, or when the input sequence is empty.
<span class="lineNum"> 814 </span> : * If the sequence is empty, @c eofbit is set in the stream, but not
<span class="lineNum"> 815 </span> : * @c failbit.
<span class="lineNum"> 816 </span> : *
<span class="lineNum"> 817 </span> : * The current locale is used to distinguish whitespace characters.
<span class="lineNum"> 818 </span> : *
<span class="lineNum"> 819 </span> : * Example:
<span class="lineNum"> 820 </span> : * @code
<span class="lineNum"> 821 </span> : * MyClass mc;
<span class="lineNum"> 822 </span> : *
<span class="lineNum"> 823 </span> : * std::cin >> std::ws >> mc;
<span class="lineNum"> 824 </span> : * @endcode
<span class="lineNum"> 825 </span> : * will skip leading whitespace before calling operator>> on cin and your
<span class="lineNum"> 826 </span> : * object. Note that the same effect can be achieved by creating a
<span class="lineNum"> 827 </span> : * std::basic_istream::sentry inside your definition of operator>>.
<span class="lineNum"> 828 </span> : */
<span class="lineNum"> 829 </span> : template<typename _CharT, typename _Traits>
<span class="lineNum"> 830 </span> : basic_istream<_CharT, _Traits>&
<span class="lineNum"> 831 </span> : ws(basic_istream<_CharT, _Traits>& __is);
<span class="lineNum"> 832 </span> :
<span class="lineNum"> 833 </span> : _GLIBCXX_END_NAMESPACE
<span class="lineNum"> 834 </span> :
<span class="lineNum"> 835 </span> : #ifndef _GLIBCXX_EXPORT_TEMPLATE
<span class="lineNum"> 836 </span> : # include <bits/istream.tcc>
<span class="lineNum"> 837 </span> : #endif
<span class="lineNum"> 838 </span> :
<span class="lineNum"> 839 </span> : #endif /* _GLIBCXX_ISTREAM */
</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>
|
