source: libcfa/src/iostream.hfa @ 2f34fde

//
// Cforall Version 1.0.0 Copyright (C) 2015 University of Waterloo
//
// The contents of this file are covered under the licence agreement in the
// file "LICENCE" distributed with Cforall.
//
// iostream.hfa --
//
// Author           : Peter A. Buhr
// Created On       : Wed May 27 17:56:53 2015
// Last Modified By : Peter A. Buhr
// Last Modified On : Mon Aug 14 17:35:40 2023
// Update Count     : 508
//

#pragma once

#include "iterator.hfa"
#include "Exception.hfa"


// *********************************** ostream ***********************************


forall( ostype & )
trait basic_ostream {
        // private
        bool sepPrt$( ostype & );                                                       // get separator state (on/off)
        void sepReset$( ostype & );                                                     // set separator state to default state
        void sepReset$( ostype &, bool );                                       // set separator and default state
        const char * sepGetCur$( ostype & );                            // get current separator string
        void sepSetCur$( ostype &, const char [] );                     // set current separator string
        bool getNL$( ostype & );                                                        // check newline
        void setNL$( ostype &, bool );                                          // saw newline
        bool getANL$( ostype & );                                                       // get auto newline (on/off)
        bool getPrt$( ostype & );                                                       // get fmt called in output cascade
        void setPrt$( ostype &, bool );                                         // set fmt called in output cascade
        // public
        void nlOn( ostype & );                                                          // turn auto-newline state on
        void nlOff( ostype & );                                                         // turn auto-newline state off

        void sep( ostype & );                                                           // turn separator state on
        void nosep( ostype & );                                                         // turn separator state off
        bool sepOn( ostype & );                                                         // set default state to on, and return previous state
        bool sepOff( ostype & );                                                        // set default state to off, and return previous state
        const char * sepGet( ostype & );                                        // get separator string
        void sepSet( ostype &, const char [] );                         // set separator to string (15 character maximum)
        const char * sepGetTuple( ostype & );                           // get tuple separator string
        void sepSetTuple( ostype &, const char [] );            // set tuple separator to string (15 character maximum)

        void ends( ostype & );                                                          // end of output statement
        int fmt( ostype &, const char format[], ... ) __attribute__(( format(printf, 2, 3) ));
}; // basic_ostream

forall( ostype & | basic_ostream( ostype ) )
trait ostream {
        bool fail( ostype & );                                                          // operation failed?
        void clear( ostype & );
        int flush( ostype & );
        void open( ostype &, const char name[], const char mode[] );
        void close( ostype & );
        ostype & write( ostype &, const char [], size_t );
}; // ostream

// forall( T )
// trait writeable {
//      forall( ostype & | ostream( ostype ) ) ostype & ?|?( ostype &, T );
// }; // writeable

forall( T, ostype & | ostream( ostype ) )
trait writeable {
        ostype & ?|?( ostype &, T );
}; // writeable

// implement writable for intrinsic types

#define OSTYPE_VOID( T ) void ?|?( ostype &, T )
#define OSTYPE_VOID_IMPL( T ) \
        void ?|?( ostype & os, T t ) { \
                (ostype &)(os | t); ends( os ); \
        } // ?|?

forall( ostype & | basic_ostream( ostype ) ) {
        ostype & ?|?( ostype &, bool );
        OSTYPE_VOID( bool );

        ostype & ?|?( ostype &, char );
        OSTYPE_VOID( char );
        ostype & ?|?( ostype &, signed char );
        OSTYPE_VOID( signed char );
        ostype & ?|?( ostype &, unsigned char );
        OSTYPE_VOID( unsigned char );

        ostype & ?|?( ostype &, short int );
        OSTYPE_VOID( short int );
        ostype & ?|?( ostype &, unsigned short int );
        OSTYPE_VOID( unsigned short int );
        ostype & ?|?( ostype &, int );
        OSTYPE_VOID( int );
        ostype & ?|?( ostype &, unsigned int );
        OSTYPE_VOID( unsigned int );
        ostype & ?|?( ostype &, long int );
        OSTYPE_VOID( long int );
        ostype & ?|?( ostype &, long long int );
        OSTYPE_VOID( long long int );
        ostype & ?|?( ostype &, unsigned long int );
        OSTYPE_VOID( unsigned long int );
        ostype & ?|?( ostype &, unsigned long long int );
        OSTYPE_VOID( unsigned long long int );
        #if defined( __SIZEOF_INT128__ )
        ostype & ?|?( ostype &, int128 );
        OSTYPE_VOID( int128 );
        ostype & ?|?( ostype &, unsigned int128 );
        OSTYPE_VOID( unsigned int128 );
        #endif // __SIZEOF_INT128__

        ostype & ?|?( ostype &, float );
        OSTYPE_VOID( float );
        ostype & ?|?( ostype &, double );
        OSTYPE_VOID( double );
        ostype & ?|?( ostype &, long double );
        OSTYPE_VOID( long double );

        ostype & ?|?( ostype &, float _Complex );
        OSTYPE_VOID( float _Complex );
        ostype & ?|?( ostype &, double _Complex );
        OSTYPE_VOID( double _Complex );
        ostype & ?|?( ostype &, long double _Complex );
        OSTYPE_VOID( long double _Complex );

        ostype & ?|?( ostype &, const char [] );
        OSTYPE_VOID( const char [] );
        // ostype & ?|?( ostype &, const char16_t [] );
        #if ! ( __ARM_ARCH_ISA_ARM == 1 && __ARM_32BIT_STATE == 1 ) // char32_t == wchar_t => ambiguous
        // ostype & ?|?( ostype &, const char32_t [] );
        #endif // ! ( __ARM_ARCH_ISA_ARM == 1 && __ARM_32BIT_STATE == 1 )
        // ostype & ?|?( ostype &, const wchar_t [] );
        ostype & ?|?( ostype &, const void * );
        OSTYPE_VOID( const void * );

        // FIX-ME: does not work so using macros
        // forall( T | { ostype & ?|?( ostype &, T ); } )
        // void ?|?( ostype & os, T );

        // manipulators
        ostype & ?|?( ostype &, ostype & (*)( ostype & ) );
        OSTYPE_VOID( ostype & (*)( ostype & ) );

        ostype & nl( ostype & );
        ostype & nonl( ostype & );
        ostype & nlOn( ostype & );
        ostype & nlOff( ostype & );

        ostype & sepVal( ostype & );
        ostype & sepTupleVal( ostype & );
        ostype & sep( ostype & );
        ostype & nosep( ostype & );
        ostype & sepOn( ostype & );
        ostype & sepOff( ostype & );
} // distribution

// tuples
forall( ostype &, T, Params... | writeable( T, ostype ) | { ostype & ?|?( ostype &, Params ); } ) {
        ostype & ?|?( ostype & os, T arg, Params rest );
        void ?|?( ostype & os, T arg, Params rest );
} // distribution

// writes the range [begin, end) to the given stream
forall( ostype &, elt_type | writeable( elt_type, ostype ), iterator_type | iterator( iterator_type, elt_type ) ) {
        void write( iterator_type begin, iterator_type end, ostype & os );
        void write_reverse( iterator_type begin, iterator_type end, ostype & os );
} // distribution

// *********************************** manipulators ***********************************

struct _Ostream_Flags {
        unsigned char eng:1;                                                            // engineering notation
        unsigned char neg:1;                                                            // val is negative
        unsigned char pc:1;                                                                     // precision specified
        unsigned char left:1;                                                           // left justify
        unsigned char nobsdp:1;                                                         // base prefix / decimal point
        unsigned char sign:1;                                                           // plus / minus sign
        unsigned char pad0:1;                                                           // zero pad
};

forall( T )
struct _Ostream_Manip {
        T val;                                                                                          // polymorphic base-type
        int wd, pc;                                                                                     // width, precision: signed for computations
        char base;                                                                                      // numeric base / floating-point style
        union {
                unsigned char all;
                _Ostream_Flags flags;
        };
}; // _Ostream_Manip

// *********************************** integral ***********************************

// See 6.7.9. 19) The initialization shall occur in initializer list order, each initializer provided for a particular
// subobject overriding any previously listed initializer for the same subobject; ***all subobjects that are not
// initialized explicitly shall be initialized implicitly the same as objects that have static storage duration.***

#define INTEGRAL_FMT_DECL( T, CODE ) \
static inline { \
        _Ostream_Manip(T) bin( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, 'b', { .all : 0 } }; } \
        _Ostream_Manip(T) oct( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, 'o', { .all : 0 } }; } \
        _Ostream_Manip(T) hex( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, 'x', { .all : 0 } }; } \
        _Ostream_Manip(T) wd( unsigned int w, T val ) { return (_Ostream_Manip(T))@{ val, w, 0, CODE, { .all : 0 } }; } \
        _Ostream_Manip(T) wd( unsigned int w, unsigned int pc, T val ) { return (_Ostream_Manip(T))@{ val, w, pc, CODE, { .flags.pc : true } }; } \
        _Ostream_Manip(T) & wd( unsigned int w, _Ostream_Manip(T) & fmt ) { fmt.wd = w; return fmt; } \
        _Ostream_Manip(T) & wd( unsigned int w, unsigned int pc, _Ostream_Manip(T) & fmt ) { fmt.wd = w; fmt.pc = pc; fmt.flags.pc = true; return fmt; } \
        _Ostream_Manip(T) & left( _Ostream_Manip(T) & fmt ) { fmt.flags.left = true; return fmt; } \
        _Ostream_Manip(T) & upcase( _Ostream_Manip(T) & fmt ) { if ( fmt.base == 'x' || fmt.base == 'b' ) fmt.base -= 32; /* upper case */ return fmt; } \
        _Ostream_Manip(T) & nobase( _Ostream_Manip(T) & fmt ) { fmt.flags.nobsdp = true; return fmt; } \
        _Ostream_Manip(T) & pad0( _Ostream_Manip(T) & fmt ) { fmt.flags.pad0 = true; return fmt; } \
        _Ostream_Manip(T) sign( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, CODE, { .flags.sign : true } }; } \
        _Ostream_Manip(T) & sign( _Ostream_Manip(T) & fmt ) { fmt.flags.sign = true; return fmt; } \
} /* distribution */ \
forall( ostype & | basic_ostream( ostype ) ) { \
        ostype & ?|?( ostype & os, _Ostream_Manip(T) f ); \
        OSTYPE_VOID( _Ostream_Manip(T) ); \
} // ?|?

INTEGRAL_FMT_DECL( signed char, 'd' )
INTEGRAL_FMT_DECL( unsigned char, 'u' )
INTEGRAL_FMT_DECL( signed short int, 'd' )
INTEGRAL_FMT_DECL( unsigned short int, 'u' )
INTEGRAL_FMT_DECL( signed int, 'd' )
INTEGRAL_FMT_DECL( unsigned int, 'u' )
INTEGRAL_FMT_DECL( signed long int, 'd' )
INTEGRAL_FMT_DECL( unsigned long int, 'u' )
INTEGRAL_FMT_DECL( signed long long int, 'd' )
INTEGRAL_FMT_DECL( unsigned long long int, 'u' )
#if defined( __SIZEOF_INT128__ )
INTEGRAL_FMT_DECL( int128, 'd' )
INTEGRAL_FMT_DECL( unsigned int128, 'u' )
#endif // __SIZEOF_INT128__

// *********************************** floating point ***********************************

// Default suffix for values with no fraction is "."
#define FLOATING_POINT_FMT_DECL( T ) \
static inline { \
        _Ostream_Manip(T) hex( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, 'a', { .all : 0 } }; } \
        _Ostream_Manip(T) sci( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, 'e', { .all : 0 } }; } \
        _Ostream_Manip(T) eng( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, 'g', { .flags.eng : true } }; } \
        _Ostream_Manip(T) wd( unsigned int w, T val ) { return (_Ostream_Manip(T))@{ val, w, 0, 'g', { .all : 0 } }; } \
        _Ostream_Manip(T) wd( unsigned int w, unsigned int pc, T val ) { return (_Ostream_Manip(T))@{ val, w, pc, 'f', { .flags.pc : true } }; } \
        _Ostream_Manip(T) ws( unsigned int w, unsigned int pc, T val ) { return (_Ostream_Manip(T))@{ val, w, pc, 'g', { .flags.pc : true } }; } \
        _Ostream_Manip(T) & wd( unsigned int w, _Ostream_Manip(T) & fmt ) { if ( fmt.flags.eng ) fmt.base = 'f'; fmt.wd = w; return fmt; } \
        _Ostream_Manip(T) & wd( unsigned int w, unsigned int pc, _Ostream_Manip(T) & fmt ) { if ( fmt.flags.eng ) fmt.base = 'f'; fmt.wd = w; fmt.pc = pc; fmt.flags.pc = true; return fmt; } \
        _Ostream_Manip(T) & ws( unsigned int w, unsigned int pc, _Ostream_Manip(T) & fmt ) { fmt.wd = w; fmt.pc = pc; fmt.flags.pc = true; return fmt; } \
        _Ostream_Manip(T) & left( _Ostream_Manip(T) & fmt ) { fmt.flags.left = true; return fmt; } \
        _Ostream_Manip(T) upcase( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, 'G', { .all : 0 } }; } \
        _Ostream_Manip(T) & upcase( _Ostream_Manip(T) & fmt ) { fmt.base -= 32; /* upper case */ return fmt; } \
        _Ostream_Manip(T) & pad0( _Ostream_Manip(T) & fmt ) { fmt.flags.pad0 = true; return fmt; } \
        _Ostream_Manip(T) sign( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, 'g', { .flags.sign : true } }; } \
        _Ostream_Manip(T) & sign( _Ostream_Manip(T) & fmt ) { fmt.flags.sign = true; return fmt; } \
        _Ostream_Manip(T) nodp( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, 'g', { .flags.nobsdp : true } }; } \
        _Ostream_Manip(T) & nodp( _Ostream_Manip(T) & fmt ) { fmt.flags.nobsdp = true; return fmt; } \
        _Ostream_Manip(T) unit( T val ) { return (_Ostream_Manip(T))@{ val, 1, 0, 'g', { .flags.nobsdp : true } }; } \
        _Ostream_Manip(T) & unit( _Ostream_Manip(T) & fmt ) { fmt.flags.nobsdp = true; return fmt; } \
} /* distribution */ \
forall( ostype & | basic_ostream( ostype ) ) { \
        ostype & ?|?( ostype & os, _Ostream_Manip(T) f ); \
        OSTYPE_VOID( _Ostream_Manip(T) ); \
} // ?|?

FLOATING_POINT_FMT_DECL( double )
FLOATING_POINT_FMT_DECL( long double )

// *********************************** character ***********************************

static inline {
        _Ostream_Manip(char) bin( char c ) { return (_Ostream_Manip(char))@{ c, 1, 0, 'b', { .all : 0 } }; }
        _Ostream_Manip(char) oct( char c ) { return (_Ostream_Manip(char))@{ c, 1, 0, 'o', { .all : 0 } }; }
        _Ostream_Manip(char) hex( char c ) { return (_Ostream_Manip(char))@{ c, 1, 0, 'x', { .all : 0 } }; }
        _Ostream_Manip(char) wd( unsigned int w, char c ) { return (_Ostream_Manip(char))@{ c, w, 0, 'c', { .all : 0 } }; }
        _Ostream_Manip(char) & wd( unsigned int w, _Ostream_Manip(char) & fmt ) { fmt.wd = w; return fmt; }
        _Ostream_Manip(char) & left( _Ostream_Manip(char) & fmt ) { fmt.flags.left = true; return fmt; }
        _Ostream_Manip(char) & upcase( _Ostream_Manip(char) & fmt ) { if ( fmt.base == 'x' || fmt.base == 'b' ) fmt.base -= 32; /* upper case */ return fmt; }
        _Ostream_Manip(char) & nobase( _Ostream_Manip(char) & fmt ) { fmt.flags.nobsdp = true; return fmt; }
} // distribution
forall( ostype & | basic_ostream( ostype ) ) {
        ostype & ?|?( ostype & os, _Ostream_Manip(char) f );
        OSTYPE_VOID( _Ostream_Manip(char) ); \
} // ?|?

// *********************************** C string ***********************************

static inline {
        _Ostream_Manip(const char *) bin( const char s[] ) { return (_Ostream_Manip(const char *))@{ s, 1, 0, 'b', { .all : 0 } }; }
        _Ostream_Manip(const char *) oct( const char s[] ) { return (_Ostream_Manip(const char *))@{ s, 1, 0, 'o', { .all : 0 } }; }
        _Ostream_Manip(const char *) hex( const char s[] ) { return (_Ostream_Manip(const char *))@{ s, 1, 0, 'x', { .all : 0 } }; }
        _Ostream_Manip(const char *) wd( unsigned int w, const char s[] ) { return (_Ostream_Manip(const char *))@{ s, w, 0, 's', { .all : 0 } }; }
        _Ostream_Manip(const char *) wd( unsigned int w, unsigned int pc, const char s[] ) { return (_Ostream_Manip(const char *))@{ s, w, pc, 's', { .flags.pc : true } }; }
        _Ostream_Manip(const char *) & wd( unsigned int w, _Ostream_Manip(const char *) & fmt ) { fmt.wd = w; return fmt; }
        _Ostream_Manip(const char *) & wd( unsigned int w, unsigned int pc, _Ostream_Manip(const char *) & fmt ) { fmt.wd = w; fmt.pc = pc; fmt.flags.pc = true; return fmt; }
        _Ostream_Manip(const char *) & left( _Ostream_Manip(const char *) & fmt ) { fmt.flags.left = true; return fmt; }
        _Ostream_Manip(const char *) & nobase( _Ostream_Manip(const char *) & fmt ) { fmt.flags.nobsdp = true; return fmt; }
} // distribution
forall( ostype & | basic_ostream( ostype ) ) {
        ostype & ?|?( ostype & os, _Ostream_Manip(const char *) f );
        OSTYPE_VOID( _Ostream_Manip(const char *) ); \
} // ?|?


// *********************************** istream ***********************************


#define ISTYPE_VOID( T ) void ?|?( istype &, T )
#define ISTYPE_VOID_IMPL( T ) \
        void ?|?( istype & is, T t ) { \
                (istype &)(is | t); ends( is ); \
        } // ?|?

forall( istype & )
trait basic_istream {
        // private
        bool getANL$( istype & );                                                       // get scan newline (on/off)
        // public
        void nlOn( istype & );                                                          // read newline
        void nlOff( istype & );                                                         // scan newline
        void ends( istype & os );                                                       // end of output statement
        int fmt( istype &, const char format[], ... ) __attribute__(( format(scanf, 2, 3) ));
        istype & ungetc( istype &, char );
        bool eof( istype & );
}; // basic_istream

forall( istype & | basic_istream( istype ) )
trait istream {
        bool fail( istype & );
        void clear( istype & );
        void open( istype & is, const char name[] );
        void close( istype & is );
        istype & read( istype &, char [], size_t );
}; // istream

forall( T )
trait readable {
        forall( istype & | istream( istype ) ) istype & ?|?( istype &, T );
}; // readable

forall( istype & | basic_istream( istype ) ) {
        istype & ?|?( istype &, bool & );
        ISTYPE_VOID( bool & );

        istype & ?|?( istype &, char & );
        ISTYPE_VOID( char & );
        istype & ?|?( istype &, signed char & );
        ISTYPE_VOID( signed char & );
        istype & ?|?( istype &, unsigned char & );
        ISTYPE_VOID( unsigned char & );

        istype & ?|?( istype &, short int & );
        ISTYPE_VOID( short int & );
        istype & ?|?( istype &, unsigned short int & );
        ISTYPE_VOID( unsigned short int & );
        istype & ?|?( istype &, int & );
        ISTYPE_VOID( int & );
        istype & ?|?( istype &, unsigned int & );
        ISTYPE_VOID( unsigned int & );
        istype & ?|?( istype &, long int & );
        ISTYPE_VOID( long int & );
        istype & ?|?( istype &, unsigned long int & );
        ISTYPE_VOID( unsigned long int & );
        istype & ?|?( istype &, long long int & );
        ISTYPE_VOID( long long int & );
        istype & ?|?( istype &, unsigned long long int & );
        ISTYPE_VOID( unsigned long long int & );
        #if defined( __SIZEOF_INT128__ )
        istype & ?|?( istype &, int128 & );
        ISTYPE_VOID( int128 & );
        istype & ?|?( istype &, unsigned int128 & );
        ISTYPE_VOID( unsigned int128 & );
        #endif // __SIZEOF_INT128__

        istype & ?|?( istype &, float & );
        ISTYPE_VOID( float & );
        istype & ?|?( istype &, double & );
        ISTYPE_VOID( double & );
        istype & ?|?( istype &, long double & );
        ISTYPE_VOID( long double & );

        istype & ?|?( istype &, float _Complex & );
        ISTYPE_VOID( float _Complex & );
        istype & ?|?( istype &, double _Complex & );
        ISTYPE_VOID( double _Complex & );
        istype & ?|?( istype &, long double _Complex & );
        ISTYPE_VOID( long double _Complex & );

//      istype & ?|?( istype &, const char [] );
//      istype & ?|?( istype &, char [] );
//      ISTYPE_VOID( char [] );

        // manipulators
        istype & ?|?( istype &, istype & (*)( istype & ) );
        ISTYPE_VOID( istype & (*)( istype & ) );
        istype & nl( istype & is );
        istype & nlOn( istype & );
        istype & nlOff( istype & );
} // distribution


// *********************************** exceptions ***********************************


ExceptionDecl( cstring_length );


// *********************************** manipulators ***********************************

struct _Istream_Cstr {
        char * s;
        union {
                const char * scanset;
                char delimit;
        };
        int wd;                                                                                         // width
        union {
                unsigned char all;
                struct {
                        unsigned char ignore:1;                                         // do not change input argument
                        unsigned char inex:1;                                           // include/exclude characters in scanset
                        unsigned char delimit:1;                                        // delimit character
                        unsigned char rwd:1;                                            // read width
                } flags;
        };
}; // _Istream_Cstr

static inline {
        _Istream_Cstr skip( const char scanset[] ) { return (_Istream_Cstr){ 0p, {scanset}, -1, {.all : 0} }; }
        _Istream_Cstr skip( unsigned int wd ) { return (_Istream_Cstr){ 0p, {0p}, wd, {.all : 0} }; }
        _Istream_Cstr & getline( _Istream_Cstr & fmt ) { fmt.delimit = '\n'; fmt.flags.delimit = true; return fmt; }
        _Istream_Cstr & getline( const char delimit, _Istream_Cstr & fmt ) { fmt.delimit = delimit; fmt.flags.delimit = true; return fmt; }
//      _Istream_Cstr incl( const char scanset[], char s[] ) { return (_Istream_Cstr){ s, {scanset}, -1, { .flags.inex : false } }; }
//      _Istream_Cstr incl( const char scanset[], unsigned int wd, char s[] ) { return (_Istream_Cstr){ s, {scanset}, wd, {.flags.inex : false} }; }
        _Istream_Cstr & incl( const char scanset[], _Istream_Cstr & fmt ) { fmt.scanset = scanset; fmt.flags.inex = false; return fmt; }
//      _Istream_Cstr excl( const char scanset[], char s[] ) { return (_Istream_Cstr){ s, {scanset}, -1, { .flags.inex : true } }; }
//      _Istream_Cstr excl( const char scanset[], unsigned int wd, char s[] ) { return (_Istream_Cstr){ s, {scanset}, wd, {.flags.inex : true} }; }
        _Istream_Cstr & excl( const char scanset[], _Istream_Cstr & fmt ) { fmt.scanset = scanset; fmt.flags.inex = true; return fmt; }
        _Istream_Cstr ignore( char s[] ) { return (_Istream_Cstr)@{ s, {0p}, -1, {.flags.ignore : true} }; }
        _Istream_Cstr & ignore( _Istream_Cstr & fmt ) { fmt.flags.ignore = true; return fmt; }
        _Istream_Cstr wdi( unsigned int wd, char s[] ) { return (_Istream_Cstr)@{ s, {0p}, wd, {.all : 0} }; }
        _Istream_Cstr wdi( unsigned int wd, unsigned int rwd, char s[] ) {
                if ( wd <= rwd ) throw (cstring_length){ &cstring_length_vt };
                return (_Istream_Cstr)@{ s, {0p}, rwd, {.flags.rwd : true} };
        }
//      _Istream_Cstr & wdi( unsigned int wd, _Istream_Cstr & fmt ) { fmt.wd = wd; return fmt; }
} // distribution
forall( istype & | basic_istream( istype ) ) {
        istype & ?|?( istype & is, _Istream_Cstr f );
        ISTYPE_VOID( _Istream_Cstr );
}

struct _Istream_Char {
        bool ignore;                                                                            // do not change input argument
}; // _Istream_Char

static inline {
        _Istream_Char ignore( const char ) { return (_Istream_Char)@{ true }; }
        _Istream_Char & ignore( _Istream_Char & fmt ) { fmt.ignore = true; return fmt; }
} // distribution
forall( istype & | basic_istream( istype ) ) {
        istype & ?|?( istype & is, _Istream_Char f );
        ISTYPE_VOID( _Istream_Char );
}

forall( T & | sized( T ) )
struct _Istream_Manip {
        T & val;                                                                                        // polymorphic base-type
        int wd;                                                                                         // width
        bool ignore;                                                                            // do not change input argument
}; // _Istream_Manip

#define INPUT_FMT_DECL( T ) \
static inline { \
        _Istream_Manip(T) ignore( const T & val ) { return (_Istream_Manip(T))@{ (T &)val, -1, true }; } \
        _Istream_Manip(T) & ignore( _Istream_Manip(T) & fmt ) { fmt.ignore = true; return fmt; } \
        _Istream_Manip(T) wdi( unsigned int wd, T & val ) { return (_Istream_Manip(T))@{ val, wd, false }; } \
        _Istream_Manip(T) & wdi( unsigned int wd, _Istream_Manip(T) & fmt ) { fmt.wd = wd; return fmt; } \
} /* distribution */ \
forall( istype & | basic_istream( istype ) ) { \
        istype & ?|?( istype & is, _Istream_Manip(T) f ); \
        ISTYPE_VOID( _Istream_Manip(T) ); \
} // ?|?

INPUT_FMT_DECL( signed char )
INPUT_FMT_DECL( unsigned char )
INPUT_FMT_DECL( signed short int )
INPUT_FMT_DECL( unsigned short int )
INPUT_FMT_DECL( signed int )
INPUT_FMT_DECL( unsigned int )
INPUT_FMT_DECL( signed long int )
INPUT_FMT_DECL( unsigned long int )
INPUT_FMT_DECL( signed long long int )
INPUT_FMT_DECL( unsigned long long int )

INPUT_FMT_DECL( float )
INPUT_FMT_DECL( double )
INPUT_FMT_DECL( long double )

INPUT_FMT_DECL( float _Complex )
INPUT_FMT_DECL( double _Complex )
INPUT_FMT_DECL( long double _Complex )


// *********************************** time ***********************************


#include <time_t.hfa>                                                                   // Duration (constructors) / Time (constructors)

forall( ostype & | ostream( ostype ) ) {
        ostype & ?|?( ostype & os, Duration dur );
        OSTYPE_VOID( Duration );
        ostype & ?|?( ostype & os, Time time );
        OSTYPE_VOID( Time );
} // distribution

// Local Variables: //
// tab-width: 4 //
// End: //