source: src/Common/utility.h @ 7d49b72

ADTaaron-thesisarm-ehast-experimentalcleanup-dtorsdeferred_resndemanglerenumforall-pointer-decayjacob/cs343-translationjenkins-sandboxnew-astnew-ast-unique-exprnew-envno_listpersistent-indexerpthread-emulationqualifiedEnumresolv-newwith_gc
Last change on this file since 7d49b72 was 6d267ca, checked in by Rob Schluntz <rschlunt@…>, 7 years ago

Add unsafe_group_iterate

  • Property mode set to 100644
File size: 10.6 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// utility.h --
8//
9// Author           : Richard C. Bilson
10// Created On       : Mon May 18 07:44:20 2015
11// Last Modified By : Andrew Beach
12// Last Modified On : Fri May 5 11:03:00 2017
13// Update Count     : 32
14//
15
16#ifndef _UTILITY_H
17#define _UTILITY_H
18
19#include <cctype>
20#include <algorithm>
21#include <iostream>
22#include <iterator>
23#include <list>
24#include <memory>
25#include <sstream>
26#include <string>
27#include <type_traits>
28
29#include <cassert>
30template< typename T >
31static inline T * maybeClone( const T *orig ) {
32        if ( orig ) {
33                return orig->clone();
34        } else {
35                return 0;
36        } // if
37}
38
39template< typename T, typename U >
40struct maybeBuild_t {
41        static T * doit( const U *orig ) {
42                if ( orig ) {
43                        return orig->build();
44                } else {
45                        return 0;
46                } // if
47        }
48};
49
50template< typename T, typename U >
51static inline T * maybeBuild( const U *orig ) {
52        return maybeBuild_t<T,U>::doit(orig);
53}
54
55template< typename T, typename U >
56static inline T * maybeMoveBuild( const U *orig ) {
57        T* ret = maybeBuild<T>(orig);
58        delete orig;
59        return ret;
60}
61
62template< typename Input_iterator >
63void printEnums( Input_iterator begin, Input_iterator end, const char * const *name_array, std::ostream &os ) {
64        for ( Input_iterator i = begin; i != end; ++i ) {
65                os << name_array[ *i ] << ' ';
66        } // for
67}
68
69template< typename Container >
70void deleteAll( Container &container ) {
71        for ( typename Container::iterator i = container.begin(); i != container.end(); ++i ) {
72                delete *i;
73        } // for
74}
75
76template< typename Container >
77void printAll( const Container &container, std::ostream &os, int indent = 0 ) {
78        for ( typename Container::const_iterator i = container.begin(); i != container.end(); ++i ) {
79                if ( *i ) {
80                        os << std::string( indent,  ' ' );
81                        (*i)->print( os, indent + 2 );
82                        // need an endl after each element because it's not easy to know when each individual item should end
83                        os << std::endl;
84                } // if
85        } // for
86}
87
88template< typename SrcContainer, typename DestContainer >
89void cloneAll( const SrcContainer &src, DestContainer &dest ) {
90        typename SrcContainer::const_iterator in = src.begin();
91        std::back_insert_iterator< DestContainer > out( dest );
92        while ( in != src.end() ) {
93                *out++ = (*in++)->clone();
94        } // while
95}
96
97template< typename Container >
98void assertAll( const Container &container ) {
99        int count = 0;
100        for ( typename Container::const_iterator i = container.begin(); i != container.end(); ++i ) {
101                if ( !(*i) ) {
102                        std::cerr << count << " is null" << std::endl;
103                } // if
104        } // for
105}
106
107template < typename T >
108std::list<T> tail( std::list<T> l ) {
109        if ( ! l.empty() ) {
110                std::list<T> ret(++(l.begin()), l.end());
111                return ret;
112        } // if
113}
114
115template < typename T >
116std::list<T> flatten( std::list < std::list<T> > l) {
117        typedef std::list <T> Ts;
118
119        Ts ret;
120
121        switch ( l.size() ) {
122          case 0:
123                return ret;
124          case 1:
125                return l.front();
126          default:
127                ret = flatten(tail(l));
128                ret.insert(ret.begin(), l.front().begin(), l.front().end());
129                return ret;
130        } // switch
131}
132
133template < typename T >
134void toString_single( std::ostream & os, const T & value ) {
135        os << value;
136}
137
138template < typename T, typename... Params >
139void toString_single( std::ostream & os, const T & value, const Params & ... params ) {
140        os << value;
141        toString_single( os, params ... );
142}
143
144template < typename ... Params >
145std::string toString( const Params & ... params ) {
146        std::ostringstream os;
147        toString_single( os, params... );
148        return os.str();
149}
150
151// replace element of list with all elements of another list
152template< typename T >
153void replace( std::list< T > &org, typename std::list< T >::iterator pos, std::list< T > &with ) {
154        typename std::list< T >::iterator next = pos; advance( next, 1 );
155
156        //if ( next != org.end() ) {
157        org.erase( pos );
158        org.splice( next, with );
159        //}
160
161        return;
162}
163
164// replace range of a list with a single element
165template< typename T >
166void replace( std::list< T > &org, typename std::list< T >::iterator begin, typename std::list< T >::iterator end, const T & with ) {
167        org.insert( begin, with );
168        org.erase( begin, end );
169}
170
171template< typename... Args >
172auto filter(Args&&... args) -> decltype(std::copy_if(std::forward<Args>(args)...)) {
173  return std::copy_if(std::forward<Args>(args)...);
174}
175
176template< typename... Args >
177auto zip(Args&&... args) -> decltype(zipWith(std::forward<Args>(args)..., std::make_pair)) {
178  return zipWith(std::forward<Args>(args)..., std::make_pair);
179}
180
181template< class InputIterator1, class InputIterator2, class OutputIterator, class BinFunction >
182void zipWith( InputIterator1 b1, InputIterator1 e1, InputIterator2 b2, InputIterator2 e2, OutputIterator out, BinFunction func ) {
183        while ( b1 != e1 && b2 != e2 )
184                *out++ = func(*b1++, *b2++);
185}
186
187// it's nice to actually be able to increment iterators by an arbitrary amount
188template< class InputIt, class Distance >
189InputIt operator+( InputIt it, Distance n ) {
190        advance(it, n);
191        return it;
192}
193
194template< typename T >
195void warn_single( const T & arg ) {
196        std::cerr << arg << std::endl;
197}
198
199template< typename T, typename... Params >
200void warn_single(const T & arg, const Params & ... params ) {
201        std::cerr << arg;
202        warn_single( params... );
203}
204
205template< typename... Params >
206void warn( const Params & ... params ) {
207        std::cerr << "Warning: ";
208        warn_single( params... );
209}
210
211// -----------------------------------------------------------------------------
212// Ref Counted Singleton class
213// Objects that inherit from this class will have at most one reference to it
214// but if all references die, the object will be deleted.
215
216template< typename ThisType >
217class RefCountSingleton {
218  public:
219        static std::shared_ptr<ThisType> get() {
220                if( global_instance.expired() ) {
221                        std::shared_ptr<ThisType> new_instance = std::make_shared<ThisType>();
222                        global_instance = new_instance;
223                        return std::move(new_instance);
224                }
225                return global_instance.lock();
226        }
227  private:
228        static std::weak_ptr<ThisType> global_instance;
229};
230
231template< typename ThisType >
232std::weak_ptr<ThisType> RefCountSingleton<ThisType>::global_instance;
233
234// -----------------------------------------------------------------------------
235// RAII object to regulate "save and restore" behaviour, e.g.
236// void Foo::bar() {
237//   ValueGuard<int> guard(var); // var is a member of type Foo
238//   var = ...;
239// } // var's original value is restored
240template< typename T >
241struct ValueGuard {
242        T old;
243        T& ref;
244
245        ValueGuard(T& inRef) : old(inRef), ref(inRef) {}
246        ~ValueGuard() { ref = old; }
247};
248
249template< typename T >
250struct ValueGuardPtr {
251        T old;
252        T* ref;
253
254        ValueGuardPtr(T * inRef) : old( inRef ? *inRef : T() ), ref(inRef) {}
255        ~ValueGuardPtr() { if( ref ) *ref = old; }
256};
257
258template< typename T >
259struct ValueGuardPtr< std::list< T > > {
260        std::list< T > old;
261        std::list< T >* ref;
262
263        ValueGuardPtr( std::list< T > * inRef) : old(), ref(inRef) {
264                if( ref ) { swap( *ref, old ); }
265        }
266        ~ValueGuardPtr() { if( ref ) { swap( *ref, old ); } }
267};
268
269// -----------------------------------------------------------------------------
270// Helper struct and function to support
271// for ( val : reverseIterate( container ) ) {}
272// syntax to have a for each that iterates backwards
273
274template< typename T >
275struct reverse_iterate_t {
276        T& ref;
277
278        reverse_iterate_t( T & ref ) : ref(ref) {}
279
280        typedef typename T::reverse_iterator iterator;
281        iterator begin() { return ref.rbegin(); }
282        iterator end() { return ref.rend(); }
283};
284
285template< typename T >
286reverse_iterate_t< T > reverseIterate( T & ref ) {
287        return reverse_iterate_t< T >( ref );
288}
289
290template< typename OutType, typename Range, typename Functor >
291OutType map_range( const Range& range, Functor&& functor ) {
292        OutType out;
293
294        std::transform(
295                begin( range ),
296                end( range ),
297                std::back_inserter( out ),
298                std::forward< Functor >( functor )
299        );
300
301        return out;
302}
303
304// -----------------------------------------------------------------------------
305// Helper struct and function to support
306// for ( val : group_iterate( container1, container2, ... ) ) {}
307// syntax to have a for each that iterates multiple containers of the same length
308// TODO: update to use variadic arguments
309
310template< typename T1, typename T2 >
311struct group_iterate_t {
312        group_iterate_t( bool skipBoundsCheck, const T1 & v1, const T2 & v2 ) : args(v1, v2) {
313                assertf(skipBoundsCheck || v1.size() == v2.size(), "group iteration requires containers of the same size: <%u, %u>.", v1.size(), v2.size());
314        };
315
316        struct iterator {
317                typedef typename std::remove_reference<T1>::type T1val;
318                typedef typename std::remove_reference<T2>::type T2val;
319                typedef std::tuple<typename T1val::value_type &, typename T2val::value_type &> value_type;
320                typedef typename T1val::iterator T1Iter;
321                typedef typename T2val::iterator T2Iter;
322                typedef std::tuple<T1Iter, T2Iter> IterTuple;
323                IterTuple it;
324                iterator( T1Iter i1, T2Iter i2 ) : it( i1, i2 ) {}
325                iterator operator++() {
326                        return iterator( ++std::get<0>(it), ++std::get<1>(it) );
327                }
328                bool operator!=( const iterator &other ) const { return it != other.it; }
329                value_type operator*() const { return std::tie( *std::get<0>(it), *std::get<1>(it) ); }
330        };
331        iterator begin() { return iterator( std::get<0>(args).begin(), std::get<1>(args).begin() ); }
332        iterator end() { return iterator( std::get<0>(args).end(), std::get<1>(args).end() ); }
333
334private:
335        std::tuple<T1, T2> args;
336};
337
338/// performs bounds check to ensure that all arguments are of the same length.
339template< typename... Args >
340group_iterate_t<Args...> group_iterate( Args &&... args ) {
341        return group_iterate_t<Args...>(false, std::forward<Args>( args )...);
342}
343
344/// does not perform a bounds check - requires user to ensure that iteration terminates when appropriate.
345template< typename... Args >
346group_iterate_t<Args...> unsafe_group_iterate( Args &&... args ) {
347        return group_iterate_t<Args...>(true, std::forward<Args>( args )...);
348}
349
350struct CodeLocation {
351        int linenumber;
352        std::string filename;
353
354        /// Create a new unset CodeLocation.
355        CodeLocation()
356                : linenumber( -1 )
357                , filename("")
358        {}
359
360        /// Create a new CodeLocation with the given values.
361        CodeLocation( const char* filename, int lineno )
362                : linenumber( lineno )
363                , filename(filename ? filename : "")
364        {}
365
366        CodeLocation( const CodeLocation& rhs ) = default;
367
368        bool isSet () const {
369                return -1 != linenumber;
370        }
371
372        bool isUnset () const {
373                return !isSet();
374        }
375
376        void unset () {
377                linenumber = -1;
378                filename = "";
379        }
380
381        // Use field access for set.
382};
383
384inline std::string to_string( const CodeLocation& location ) {
385        return location.isSet() ? location.filename + ":" + std::to_string(location.linenumber) + " " : "";
386}
387
388#endif // _UTILITY_H
389
390// Local Variables: //
391// tab-width: 4 //
392// mode: c++ //
393// compile-command: "make install" //
394// End: //
Note: See TracBrowser for help on using the repository browser.