Context Navigation

iostream.hfa @ 96ef156

Last change on this file since 96ef156 was 96ef156, checked in by Michael Brooks <mlbrooks@…>, 5 days ago
Fix IO stream to be warning-free.
Property mode set to `100644`
File size: 23.5 KB

Line
1	//
2	// Cforall Version 1.0.0 Copyright (C) 2015 University of Waterloo
3	//
4	// The contents of this file are covered under the licence agreement in the
5	// file "LICENCE" distributed with Cforall.
6	//
7	// iostream.hfa --
8	//
9	// Author : Peter A. Buhr
10	// Created On : Wed May 27 17:56:53 2015
11	// Last Modified By : Peter A. Buhr
12	// Last Modified On : Sun Oct 13 10:49:40 2024
13	// Update Count : 765
14	//
15
16	#pragma once
17
18	#include "iterator.hfa"
19	#include "Exception.hfa"
20
21	// ********************************* ostream *********************************
22
23	forall( ostype & )
24	trait basic_ostream {
25	// private
26	bool sepPrt$( ostype & ); // get separator state (on/off)
27	void sepReset$( ostype & ); // set separator state to default state
28	void sepReset$( ostype &, bool ); // set separator and default state
29	const char * sepGetCur$( ostype & ); // get current separator string
30	void sepSetCur$( ostype &, const char [] ); // set current separator string
31	bool getNL$( ostype & ); // get newline
32	bool setNL$( ostype &, bool ); // set newline
33	bool getANL$( ostype & ); // get auto newline (on/off)
34	bool setANL$( ostype &, bool ); // set auto newline (on/off), and return previous state
35	bool getPrt$( ostype & ); // get fmt called in output cascade
36	bool setPrt$( ostype &, bool ); // set fmt called in output cascade
37	// public
38	void nlOn( ostype & ); // turn auto-newline state on
39	void nlOff( ostype & ); // turn auto-newline state off
40
41	void sep( ostype & ); // turn separator state on
42	void nosep( ostype & ); // turn separator state off
43	bool sepOn( ostype & ); // set default state to on, and return previous state
44	bool sepOff( ostype & ); // set default state to off, and return previous state
45	const char * sepGet( ostype & ); // get separator string
46	void sepSet( ostype &, const char [] ); // set separator to string (15 character maximum)
47	const char * sepGetTuple( ostype & ); // get tuple separator string
48	void sepSetTuple( ostype &, const char [] ); // set tuple separator to string (15 character maximum)
49
50	void ends( ostype & ); // end of output statement
51	int fmt( ostype &, const char format[], ... ) __attribute__(( format(printf, 2, 3) ));
52	}; // basic_ostream
53
54	forall( ostype & \| basic_ostream( ostype ) )
55	trait ostream {
56	bool fail( ostype & ); // operation failed?
57	void clear( ostype & );
58	int flush( ostype & );
59	void open( ostype &, const char name[], const char mode[] );
60	void close( ostype & );
61	ostype & write( ostype &, const char [], size_t );
62	}; // ostream
63
64	// forall( T )
65	// trait writeable {
66	// forall( ostype & \| ostream( ostype ) ) ostype & ?\|?( ostype &, T );
67	// }; // writeable
68
69	forall( T, ostype & \| ostream( ostype ) )
70	trait writeable {
71	ostype & ?\|?( ostype &, T );
72	}; // writeable
73
74	// implement writable for intrinsic types
75
76	#define OSTYPE_VOID( T ) void ?\|?( ostype &, T )
77	#define OSTYPE_VOID_IMPL( os, T ) \
78	void ?\|?( ostype & os, T t ) { \
79	(ostype &)(os \| t); ends( os ); \
80	} // ?\|?
81
82	forall( ostype & \| basic_ostream( ostype ) ) {
83	ostype & ?\|?( ostype &, bool );
84	OSTYPE_VOID( bool );
85
86	ostype & ?\|?( ostype &, char );
87	OSTYPE_VOID( char );
88	ostype & ?\|?( ostype &, signed char );
89	OSTYPE_VOID( signed char );
90	ostype & ?\|?( ostype &, unsigned char );
91	OSTYPE_VOID( unsigned char );
92
93	ostype & ?\|?( ostype &, short int );
94	OSTYPE_VOID( short int );
95	ostype & ?\|?( ostype &, unsigned short int );
96	OSTYPE_VOID( unsigned short int );
97	ostype & ?\|?( ostype &, int );
98	OSTYPE_VOID( int );
99	ostype & ?\|?( ostype &, unsigned int );
100	OSTYPE_VOID( unsigned int );
101	ostype & ?\|?( ostype &, long int );
102	OSTYPE_VOID( long int );
103	ostype & ?\|?( ostype &, long long int );
104	OSTYPE_VOID( long long int );
105	ostype & ?\|?( ostype &, unsigned long int );
106	OSTYPE_VOID( unsigned long int );
107	ostype & ?\|?( ostype &, unsigned long long int );
108	OSTYPE_VOID( unsigned long long int );
109	#if defined( __SIZEOF_INT128__ )
110	ostype & ?\|?( ostype &, int128 );
111	OSTYPE_VOID( int128 );
112	ostype & ?\|?( ostype &, unsigned int128 );
113	OSTYPE_VOID( unsigned int128 );
114	#endif // __SIZEOF_INT128__
115
116	ostype & ?\|?( ostype &, float );
117	OSTYPE_VOID( float );
118	ostype & ?\|?( ostype &, double );
119	OSTYPE_VOID( double );
120	ostype & ?\|?( ostype &, long double );
121	OSTYPE_VOID( long double );
122
123	ostype & ?\|?( ostype &, float _Complex );
124	OSTYPE_VOID( float _Complex );
125	ostype & ?\|?( ostype &, double _Complex );
126	OSTYPE_VOID( double _Complex );
127	ostype & ?\|?( ostype &, long double _Complex );
128	OSTYPE_VOID( long double _Complex );
129
130	ostype & ?\|?( ostype &, const char [] );
131	OSTYPE_VOID( const char [] );
132	// ostype & ?\|?( ostype &, const char16_t [] );
133	#if ! ( __ARM_ARCH_ISA_ARM == 1 && __ARM_32BIT_STATE == 1 ) // char32_t == wchar_t => ambiguous
134	// ostype & ?\|?( ostype &, const char32_t [] );
135	#endif // ! ( __ARM_ARCH_ISA_ARM == 1 && __ARM_32BIT_STATE == 1 )
136	// ostype & ?\|?( ostype &, const wchar_t [] );
137	ostype & ?\|?( ostype &, const void * );
138	OSTYPE_VOID( const void * );
139
140	// FIX-ME: does not work so using macros
141	// forall( T \| { ostype & ?\|?( ostype &, T ); } )
142	// void ?\|?( ostype & os, T );
143
144	// manipulators
145	ostype & ?\|?( ostype &, ostype & (*)( ostype & ) );
146	OSTYPE_VOID( ostype & (*)( ostype & ) );
147
148	ostype & nl( ostype & );
149	ostype & nonl( ostype & );
150	ostype & nlOn( ostype & );
151	ostype & nlOff( ostype & );
152
153	ostype & sepVal( ostype & );
154	ostype & sepTupleVal( ostype & );
155	ostype & sep( ostype & );
156	ostype & nosep( ostype & );
157	ostype & sepOn( ostype & );
158	ostype & sepOff( ostype & );
159	} // distribution
160
161	// tuples
162	forall( ostype &, T, List ... \| writeable( T, ostype ) \| { ostype & ?\|?( ostype &, List ); } ) {
163	ostype & ?\|?( ostype & os, T arg, List rest );
164	void ?\|?( ostype & os, T arg, List rest );
165	} // distribution
166
167	// writes the range [begin, end) to the given stream
168	forall( ostype &, elt_type \| writeable( elt_type, ostype ), iterator_type \| iterator( iterator_type, elt_type ) ) {
169	void write( iterator_type begin, iterator_type end, ostype & os );
170	void write_reverse( iterator_type begin, iterator_type end, ostype & os );
171	} // distribution
172
173	// ********************************* manipulators *********************************
174
175	struct _Ostream_Flags {
176	unsigned char eng:1; // engineering notation
177	unsigned char neg:1; // val is negative
178	unsigned char pc:1; // precision specified
179	unsigned char left:1; // left justify
180	unsigned char nobsdp:1; // base prefix / decimal point
181	unsigned char sign:1; // plus / minus sign
182	unsigned char pad0:1; // zero pad
183	};
184
185	// FIXME: Should be an anonymous inner union of _Ostream_Manip.
186	// Hoisting manually to work around warning of #294.
187	union _Ostream_Manip_Mode {
188	unsigned char all;
189	_Ostream_Flags flags;
190	};
191
192	forall( T )
193	struct _Ostream_Manip {
194	T val; // polymorphic base-type
195	int wd, pc; // width, precision: signed for computations
196	char base; // numeric base / floating-point style
197	inline _Ostream_Manip_Mode;
198	}; // _Ostream_Manip
199
200	// ********************************* integral *********************************
201
202	#define INTEGRAL_FMT_DECL( T, CODE ) \
203	static inline { \
204	_Ostream_Manip(T) bin( T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = 1, .pc = 0, .base = 'b', { .all = 0 } }; } \
205	_Ostream_Manip(T) oct( T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = 1, .pc = 0, .base = 'o', { .all = 0 } }; } \
206	_Ostream_Manip(T) hex( T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = 1, .pc = 0, .base = 'x', { .all = 0 } }; } \
207	_Ostream_Manip(T) wd( unsigned int wd, T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = wd, .pc = 0, .base = CODE, { .all = 0 } }; } \
208	_Ostream_Manip(T) wd( unsigned int wd, unsigned int pc, T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = wd, .pc = pc, .base = CODE, { .flags.pc = true } }; } \
209	_Ostream_Manip(T) & wd( unsigned int wd, _Ostream_Manip(T) & fmt ) { fmt.wd = wd; return fmt; } \
210	_Ostream_Manip(T) & wd( unsigned int wd, unsigned int pc, _Ostream_Manip(T) & fmt ) { fmt.wd = wd; fmt.pc = pc; fmt.flags.pc = true; return fmt; } \
211	_Ostream_Manip(T) & left( _Ostream_Manip(T) & fmt ) { fmt.flags.left = true; return fmt; } \
212	_Ostream_Manip(T) & upcase( _Ostream_Manip(T) & fmt ) { if ( fmt.base == 'x' \|\| fmt.base == 'b' ) fmt.base -= 32; /* upper case */ return fmt; } \
213	_Ostream_Manip(T) & nobase( _Ostream_Manip(T) & fmt ) { fmt.flags.nobsdp = true; return fmt; } \
214	_Ostream_Manip(T) & pad0( _Ostream_Manip(T) & fmt ) { fmt.flags.pad0 = true; return fmt; } \
215	_Ostream_Manip(T) sign( T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = 1, .pc = 0, .base = CODE, { .flags.sign = true } }; } \
216	_Ostream_Manip(T) & sign( _Ostream_Manip(T) & fmt ) { fmt.flags.sign = true; return fmt; } \
217	} /* distribution */ \
218	forall( ostype & \| basic_ostream( ostype ) ) { \
219	ostype & ?\|?( ostype & os, _Ostream_Manip(T) f ); \
220	OSTYPE_VOID( _Ostream_Manip(T) ); \
221	} // ?\|?
222
223	INTEGRAL_FMT_DECL( signed char, 'd' )
224	INTEGRAL_FMT_DECL( unsigned char, 'u' )
225	INTEGRAL_FMT_DECL( signed short int, 'd' )
226	INTEGRAL_FMT_DECL( unsigned short int, 'u' )
227	INTEGRAL_FMT_DECL( signed int, 'd' )
228	INTEGRAL_FMT_DECL( unsigned int, 'u' )
229	INTEGRAL_FMT_DECL( signed long int, 'd' )
230	INTEGRAL_FMT_DECL( unsigned long int, 'u' )
231	INTEGRAL_FMT_DECL( signed long long int, 'd' )
232	INTEGRAL_FMT_DECL( unsigned long long int, 'u' )
233	#if defined( __SIZEOF_INT128__ )
234	INTEGRAL_FMT_DECL( int128, 'd' )
235	INTEGRAL_FMT_DECL( unsigned int128, 'u' )
236	#endif // __SIZEOF_INT128__
237
238	// ********************************* floating point *********************************
239
240	// Default suffix for values with no fraction is "."
241	#define FLOATING_POINT_FMT_DECL( T ) \
242	static inline { \
243	_Ostream_Manip(T) hex( T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = 1, .pc = 0, .base = 'a', { .all = 0 } }; } \
244	_Ostream_Manip(T) sci( T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = 1, .pc = 0, .base = 'e', { .all = 0 } }; } \
245	_Ostream_Manip(T) eng( T val ) { return (_Ostream_Manip(T))@{ .val = val, 1, -1, .base = 'g', { .flags.eng = true } }; } \
246	_Ostream_Manip(T) wd( unsigned int wd, T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = wd, .pc = 0, .base = 'g', { .all = 0 } }; } \
247	_Ostream_Manip(T) wd( unsigned int wd, unsigned int pc, T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = wd, .pc = pc, .base = 'f', { .flags.pc = true } }; } \
248	_Ostream_Manip(T) ws( unsigned int wd, unsigned int pc, T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = wd, .pc = pc, .base = 'g', { .flags.pc = true } }; } \
249	_Ostream_Manip(T) & wd( unsigned int wd, _Ostream_Manip(T) & fmt ) { if ( fmt.flags.eng ) fmt.base = 'f'; fmt.wd = wd; return fmt; } \
250	_Ostream_Manip(T) & wd( unsigned int wd, unsigned int pc, _Ostream_Manip(T) & fmt ) { \
251	if ( fmt.flags.eng ) fmt.base = 'f'; fmt.wd = wd; fmt.pc = pc; fmt.flags.pc = true; return fmt; } \
252	_Ostream_Manip(T) & ws( unsigned int wd, unsigned int pc, _Ostream_Manip(T) & fmt ) { fmt.wd = wd; fmt.pc = pc; fmt.flags.pc = true; return fmt; } \
253	_Ostream_Manip(T) & left( _Ostream_Manip(T) & fmt ) { fmt.flags.left = true; return fmt; } \
254	_Ostream_Manip(T) upcase( T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = 1, .pc = 0, .base = 'G', { .all = 0 } }; } \
255	_Ostream_Manip(T) & upcase( _Ostream_Manip(T) & fmt ) { fmt.base -= 32; /* upper case */ return fmt; } \
256	_Ostream_Manip(T) & pad0( _Ostream_Manip(T) & fmt ) { fmt.flags.pad0 = true; return fmt; } \
257	_Ostream_Manip(T) sign( T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = 1, .pc = 0, .base = 'g', { .flags.sign = true } }; } \
258	_Ostream_Manip(T) & sign( _Ostream_Manip(T) & fmt ) { fmt.flags.sign = true; return fmt; } \
259	_Ostream_Manip(T) nodp( T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = 1, .pc = 0, .base = 'g', { .flags.nobsdp = true } }; } \
260	_Ostream_Manip(T) & nodp( _Ostream_Manip(T) & fmt ) { fmt.flags.nobsdp = true; return fmt; } \
261	_Ostream_Manip(T) unit( T val ) { return (_Ostream_Manip(T))@{ .val = val, .wd = 1, .pc = 0, .base = 'g', { .flags.nobsdp = true } }; } \
262	_Ostream_Manip(T) & unit( _Ostream_Manip(T) & fmt ) { fmt.flags.nobsdp = true; return fmt; } \
263	} /* distribution */ \
264	forall( ostype & \| basic_ostream( ostype ) ) { \
265	ostype & ?\|?( ostype & os, _Ostream_Manip(T) f ); \
266	OSTYPE_VOID( _Ostream_Manip(T) ); \
267	} // ?\|?
268
269	FLOATING_POINT_FMT_DECL( double )
270	FLOATING_POINT_FMT_DECL( long double )
271
272	// ********************************* character *********************************
273
274	static inline {
275	_Ostream_Manip(char) bin( char c ) { return (_Ostream_Manip(char))@{ .val = c, .wd = 1, .pc = 0, .base = 'b', { .all = 0 } }; }
276	_Ostream_Manip(char) oct( char c ) { return (_Ostream_Manip(char))@{ .val = c, .wd = 1, .pc = 0, .base = 'o', { .all = 0 } }; }
277	_Ostream_Manip(char) hex( char c ) { return (_Ostream_Manip(char))@{ .val = c, .wd = 1, .pc = 0, .base = 'x', { .all = 0 } }; }
278	_Ostream_Manip(char) wd( unsigned int wd, char c ) { return (_Ostream_Manip(char))@{ c, wd, 0, .base = 'c', { .all = 0 } }; }
279	_Ostream_Manip(char) & wd( unsigned int wd, _Ostream_Manip(char) & fmt ) { fmt.wd = wd; return fmt; }
280	_Ostream_Manip(char) & left( _Ostream_Manip(char) & fmt ) { fmt.flags.left = true; return fmt; }
281	_Ostream_Manip(char) & upcase( _Ostream_Manip(char) & fmt ) { if ( fmt.base == 'x' \|\| fmt.base == 'b' ) fmt.base -= 32; /* upper case */ return fmt; }
282	_Ostream_Manip(char) & nobase( _Ostream_Manip(char) & fmt ) { fmt.flags.nobsdp = true; return fmt; }
283	} // distribution
284	forall( ostype & \| basic_ostream( ostype ) ) {
285	ostype & ?\|?( ostype & os, _Ostream_Manip(char) f );
286	OSTYPE_VOID( _Ostream_Manip(char) ); \
287	} // ?\|?
288
289	// ********************************* C string *********************************
290
291	static inline {
292	_Ostream_Manip(const char ) bin( const char s[] ) { return (_Ostream_Manip(const char ))@{ .val = s, .wd = 1, .pc = 0, .base = 'b', { .all = 0 } }; }
293	_Ostream_Manip(const char ) oct( const char s[] ) { return (_Ostream_Manip(const char ))@{ .val = s, .wd = 1, .pc = 0, .base = 'o', { .all = 0 } }; }
294	_Ostream_Manip(const char ) hex( const char s[] ) { return (_Ostream_Manip(const char ))@{ .val = s, .wd = 1, .pc = 0, .base = 'x', { .all = 0 } }; }
295	_Ostream_Manip(const char ) wd( unsigned int wd, const char s[] ) { return (_Ostream_Manip(const char ))@{ s, wd, 0, .base = 's', { .all = 0 } }; }
296	_Ostream_Manip(const char ) wd( unsigned int wd, unsigned int pc, const char s[] ) { return (_Ostream_Manip(const char ))@{ s, .wd = wd, .pc = pc, .base = 's', { .flags.pc = true } }; }
297	_Ostream_Manip(const char ) & wd( unsigned int wd, _Ostream_Manip(const char ) & fmt ) { fmt.wd = wd; return fmt; }
298	_Ostream_Manip(const char ) & wd( unsigned int wd, unsigned int pc, _Ostream_Manip(const char ) & fmt ) { fmt.wd = wd; fmt.pc = pc; fmt.flags.pc = true; return fmt; }
299	_Ostream_Manip(const char ) & left( _Ostream_Manip(const char ) & fmt ) { fmt.flags.left = true; return fmt; }
300	_Ostream_Manip(const char ) & nobase( _Ostream_Manip(const char ) & fmt ) { fmt.flags.nobsdp = true; return fmt; }
301	} // distribution
302	forall( ostype & \| basic_ostream( ostype ) ) {
303	ostype & ?\|?( ostype & os, _Ostream_Manip(const char *) f );
304	OSTYPE_VOID( _Ostream_Manip(const char *) ); \
305	} // ?\|?
306
307	// ********************************* istream *********************************
308
309	forall( istype & )
310	trait basic_istream {
311	// private
312	bool getANL$( istype & ); // get scan newline (on/off)
313	bool setANL$( istype &, bool ); // set scan newline (on/off)
314	// public
315	void nlOn( istype & ); // read newline
316	void nlOff( istype & ); // scan newline
317	int fmt( istype &, const char format[], ... ) __attribute__(( format(scanf, 2, 3) ));
318	istype & ungetc( char, istype & );
319	bool eof( istype & );
320	void clear( istype & );
321	}; // basic_istream
322
323	forall( istype & \| basic_istream( istype ) )
324	trait istream {
325	bool fail( istype & );
326	void open( istype & is, const char name[], const char mode[] );
327	void open( istype & is, const char name[] );
328	void close( istype & is );
329	istype & read( istype &, char [], size_t );
330	}; // istream
331
332	forall( T )
333	trait readable {
334	forall( istype & \| istream( istype ) ) istype & ?\|?( istype &, T );
335	}; // readable
336
337	forall( istype & \| basic_istream( istype ) ) {
338	istype & ?\|?( istype &, bool & );
339
340	istype & ?\|?( istype &, char & );
341	istype & ?\|?( istype &, signed char & );
342	istype & ?\|?( istype &, unsigned char & );
343
344	istype & ?\|?( istype &, short int & );
345	istype & ?\|?( istype &, unsigned short int & );
346	istype & ?\|?( istype &, int & );
347	istype & ?\|?( istype &, unsigned int & );
348	istype & ?\|?( istype &, long int & );
349	istype & ?\|?( istype &, unsigned long int & );
350	istype & ?\|?( istype &, long long int & );
351	istype & ?\|?( istype &, unsigned long long int & );
352	#if defined( __SIZEOF_INT128__ )
353	istype & ?\|?( istype &, int128 & );
354	istype & ?\|?( istype &, unsigned int128 & );
355	#endif // __SIZEOF_INT128__
356
357	istype & ?\|?( istype &, float & );
358	istype & ?\|?( istype &, double & );
359	istype & ?\|?( istype &, long double & );
360
361	istype & ?\|?( istype &, float _Complex & );
362	istype & ?\|?( istype &, double _Complex & );
363	istype & ?\|?( istype &, long double _Complex & );
364
365	// This is too restrictive as it prevents building a format in a string and using that format.
366	// inline istype & ?\|?( istype &, char [] ) { // possible error, too restrictive to change
367	// _Static_assert( false, "reading a character array without a maximum length is unsafe. Use input manipulator \"wdi( N, s )\", where \"char s[N]\" or fmt( s )." );
368	// }
369	istype & ?\|?( istype &, const char [] ); // match text
370
371	// manipulators
372	istype & ?\|?( istype &, istype & (*)( istype & ) );
373	istype & nl( istype & is );
374	istype & nlOn( istype & );
375	istype & nlOff( istype & );
376	} // distribution
377
378	// ********************************* exceptions *********************************
379
380	ExceptionDecl( end_of_file ); // read encounters end of file
381	ExceptionDecl( missing_data ); // read finds no appropriate data
382	ExceptionDecl( cstring_length ); // character string size exceeded
383	ExceptionDecl( data_range ); // value too large for numerical type
384
385	// ********************************* manipulators *********************************
386
387	// skip does not compose with other C string manipulators.
388	struct _Istream_Cskip {
389	const char * scanset;
390	unsigned wd; // scan width
391	}; // _Istream_Cskip
392
393	static inline {
394	_Istream_Cskip skip( const char scanset[] ) { return (_Istream_Cskip)@{ .scanset = scanset, .wd = 0 }; }
395	_Istream_Cskip skip( unsigned int wd ) { return (_Istream_Cskip)@{ .scanset = 0p, .wd = wd }; }
396	} // distribution
397
398	struct _Istream_str_base {
399	union {
400	const char * scanset;
401	char delimiters[3]; // [0] => left, [1] => right
402	};
403	int wd; // width
404	union {
405	unsigned char all;
406	struct {
407	unsigned char ignore:1; // do not change input argument
408	unsigned char inex:1; // include/exclude characters in scanset
409	unsigned char delimiter:1; // delimit character(s)
410	unsigned char rwd:1; // read width
411	} flags;
412	};
413	}; // _Istream_str_base
414
415	struct _Istream_Cwidth {
416	char * s;
417	inline _Istream_str_base;
418	}; // _Istream_Cwidth
419
420	// Restrict nesting of input manipulators to those combinations that make sense.
421
422	struct _Istream_Cquoted {
423	_Istream_Cwidth cstr;
424	}; // _Istream_Cquoted
425
426	struct _Istream_Cstr {
427	_Istream_Cwidth cstr;
428	}; // _Istream_Cstr
429
430	static inline {
431	// width must include room for null terminator, (gcc) scanf does not allow a 0 width => wd > 1 (1 char and null) and rd > 0 (1 char);
432	_Istream_Cwidth wdi( unsigned int wd, char s[] ) {
433	if ( wd <= 1 ) throwResume ExceptionInst( cstring_length ); // minimum 1 character and null terminator
434	return (_Istream_Cwidth)@{ .s = s, { {.scanset = 0p}, .wd = wd, {.all = 0} } };
435	}
436	_Istream_Cwidth wdi( unsigned int wd, unsigned int rwd, char s[] ) {
437	if ( wd <= 1 \|\| wd <= rwd ) throwResume ExceptionInst( cstring_length ); // minimum 1 character, null terminator, plus subset
438	return (_Istream_Cwidth)@{ .s = s, { {.scanset = 0p}, .wd = rwd, {.flags.rwd = true} } };
439	}
440	_Istream_Cstr & getline( _Istream_Cwidth & f, const char delimiter = '\n' ) {
441	f.delimiters[0] = delimiter; f.delimiters[1] = '\0'; f.flags.delimiter = true; return (_Istream_Cstr &)f;
442	}
443	_Istream_Cquoted quoted( char & ch, const char Ldelimiter = '\'', const char Rdelimiter = '\0' ) {
444	return (_Istream_Cquoted)@{ { .s = &ch, { {.delimiters = { Ldelimiter, Rdelimiter, '\1' }}, .wd = 1, {.flags.rwd = true} } } };
445	}
446	_Istream_Cquoted & quoted( _Istream_Cwidth & f, const char Ldelimiter = '"', const char Rdelimiter = '\0' ) {
447	f.delimiters[0] = Ldelimiter; f.delimiters[1] = Rdelimiter; f.delimiters[2] = '\0';
448	return (_Istream_Cquoted &)f;
449	}
450	_Istream_Cstr & incl( const char scanset[], _Istream_Cwidth & f ) { f.scanset = scanset; f.flags.inex = false; return (_Istream_Cstr &)f; }
451	_Istream_Cstr & excl( const char scanset[], _Istream_Cwidth & f ) { f.scanset = scanset; f.flags.inex = true; return (_Istream_Cstr &)f; }
452	_Istream_Cstr ignore( const char s[] ) { return (_Istream_Cstr)@{ { .s = (char *)s, { {.scanset = 0p}, .wd = -1, {.flags.ignore = true} } } }; }
453	_Istream_Cstr & ignore( _Istream_Cwidth & f ) { f.flags.ignore = true; return (_Istream_Cstr &)f; }
454	_Istream_Cquoted & ignore( _Istream_Cquoted & f ) { f.cstr.flags.ignore = true; return (_Istream_Cquoted &)f; }
455	_Istream_Cstr & ignore( _Istream_Cstr & f ) { f.cstr.flags.ignore = true; return (_Istream_Cstr &)f; }
456	} // distribution
457
458	forall( istype & \| basic_istream( istype ) ) {
459	istype & ?\|?( istype & is, _Istream_Cskip f );
460	istype & ?\|?( istype & is, _Istream_Cquoted f );
461	istype & ?\|?( istype & is, _Istream_Cstr f );
462	static inline istype & ?\|?( istype & is, _Istream_Cwidth f ) { return is \| (_Istream_Cstr )&f; }
463	} // distribution
464
465	// FIXME: `\| sized(T)` seems to be working around a bug, but it is logically unnecessary.
466	// Including sized(T) causes a warning that is telling us to get rid of it.
467	#pragma GCC diagnostic push
468	#pragma GCC diagnostic ignored "-Wunused-parameter"
469	forall( T & \| sized(T) )
470	struct _Istream_Manip {
471	T & val; // polymorphic base-type
472	int wd; // width
473	bool ignore; // do not change input argument
474	}; // _Istream_Manip
475	#pragma GCC diagnostic pop
476
477	#define INPUT_FMT_DECL( T ) \
478	static inline { \
479	_Istream_Manip(T) wdi( unsigned int wd, T & val ) { return (_Istream_Manip(T))@{ .val = val, .wd = wd, .ignore = false }; } \
480	_Istream_Manip(T) ignore( const T & val ) { return (_Istream_Manip(T))@{ .val = (T &)val, .wd = -1, .ignore = true }; } \
481	_Istream_Manip(T) & ignore( _Istream_Manip(T) & fmt ) { fmt.ignore = true; return fmt; } \
482	} /* distribution */ \
483	forall( istype & \| basic_istream( istype ) ) { \
484	istype & ?\|?( istype & is, _Istream_Manip(T) f ); \
485	} // ?\|?
486
487	INPUT_FMT_DECL( char )
488	INPUT_FMT_DECL( signed char )
489	INPUT_FMT_DECL( unsigned char )
490	INPUT_FMT_DECL( signed short int )
491	INPUT_FMT_DECL( unsigned short int )
492	INPUT_FMT_DECL( signed int )
493	INPUT_FMT_DECL( unsigned int )
494	INPUT_FMT_DECL( signed long int )
495	INPUT_FMT_DECL( unsigned long int )
496	INPUT_FMT_DECL( signed long long int )
497	INPUT_FMT_DECL( unsigned long long int )
498
499	INPUT_FMT_DECL( float )
500	INPUT_FMT_DECL( double )
501	INPUT_FMT_DECL( long double )
502
503	INPUT_FMT_DECL( float _Complex )
504	INPUT_FMT_DECL( double _Complex )
505	INPUT_FMT_DECL( long double _Complex )
506
507	// ********************************* time *********************************
508
509	#include <time_t.hfa> // Duration (constructors) / Time (constructors)
510
511	forall( ostype & \| ostream( ostype ) ) {
512	ostype & ?\|?( ostype & os, Duration dur );
513	OSTYPE_VOID( Duration );
514	ostype & ?\|?( ostype & os, Time time );
515	OSTYPE_VOID( Time );
516	} // distribution
517
518	forall( istype & \| istream( istype ), E \| CfaEnum( E ) \| Serial(E) )
519	istype & ?\|?( istype &, E & );
520
521	forall( ostype & \| ostream( ostype ), E \| CfaEnum( E ) ) {
522	ostype & ?\|?( ostype &, E );
523	OSTYPE_VOID( E );
524	}
525
526	// Local Variables: //
527	// tab-width: 4 //
528	// End: //

Note: See TracBrowser for help on using the repository browser.

Download in other formats:

Original Format