Context Navigation

iostream.hfa@ b19b362

Visit:

Last change on this file since b19b362 was b19b362, checked in by Peter A. Buhr <pabuhr@…>, 3 days ago
add quote output manipulator for printing char, char *, string surrounded by quote characters
Property mode set to `100644`
File size: 24.9 KB

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

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

Download in other formats:

Original Format