d13e86c75186e8693abc24d757202c83184e11fa
2 // Utility subroutines for the C++ library testsuite.
4 // Copyright (C) 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
6 // This file is part of the GNU ISO C++ Library. This library is free
7 // software; you can redistribute it and/or modify it under the
8 // terms of the GNU General Public License as published by the
9 // Free Software Foundation; either version 2, or (at your option)
12 // This library is distributed in the hope that it will be useful,
13 // but WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 // GNU General Public License for more details.
17 // You should have received a copy of the GNU General Public License along
18 // with this library; see the file COPYING. If not, write to the Free
19 // Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307,
22 // As a special exception, you may use this file as part of a free software
23 // library without restriction. Specifically, if other files instantiate
24 // templates or use macros or inline functions from this file, or you compile
25 // this file and link it with other files to produce an executable, this
26 // file does not by itself cause the resulting executable to be covered by
27 // the GNU General Public License. This exception does not however
28 // invalidate any other reasons why the executable file might be covered by
29 // the GNU General Public License.
31 // This file provides the following:
33 // 1) VERIFY(), via DEBUG_ASSERT, from Brent Verner <brent@rcfile.org>.
34 // This file is included in the various testsuite programs to provide
35 // #define(able) assert() behavior for debugging/testing. It may be
36 // a suitable location for other furry woodland creatures as well.
38 // 2) set_memory_limits()
39 // set_memory_limits() uses setrlimit() to restrict dynamic memory
40 // allocation. We provide a default memory limit if none is passed by the
41 // calling application. The argument to set_memory_limits() is the
42 // limit in megabytes (a floating-point number). If _GLIBCPP_MEM_LIMITS is
43 // not #defined before including this header, then no limiting is attempted.
46 // This is a POD with a static data member, gnu_counting_struct::count,
47 // which starts at zero, increments on instance construction, and decrements
48 // on instance destruction. "assert_count(n)" can be called to VERIFY()
49 // that the count equals N.
51 // 4) copy_tracker, from Stephen M. Webb <stephen@bregmasoft.com>.
52 // A class with nontrivial ctor/dtor that provides the ability to track the
53 // number of copy ctors and dtors, and will throw on demand during copy.
55 // 5) pod_char, pod_int, , abstract character classes and
56 // char_traits specializations for testing instantiations.
58 #ifndef _GLIBCPP_TESTSUITE_HOOKS_H
59 #define _GLIBCPP_TESTSUITE_HOOKS_H
61 #include <bits/c++config.h>
62 #include <bits/functexcept.h>
66 # define VERIFY(fn) assert(fn)
68 # define VERIFY(fn) test &= (fn)
72 namespace __gnu_cxx_test
74 // All macros are defined in GLIBCPP_CONFIGURE_TESTSUITE and imported
77 // Set memory limits if possible, if not set to 0.
78 #ifndef _GLIBCPP_MEM_LIMITS
79 # define MEMLIMIT_MB 0
82 # define MEMLIMIT_MB 16.0
86 set_memory_limits(float __size
= MEMLIMIT_MB
);
89 // Check mangled name demangles (using __cxa_demangle) as expected.
91 verify_demangle(const char* mangled
, const char* wanted
);
94 // Simple callback structure for variable numbers of tests (all with
95 // same signature). Assume all unit tests are of the signature
97 typedef void (*test_func
) (void);
98 typedef std::list
<test_func
> func_callback
;
100 // Run select unit tests after setting global locale.
102 run_tests_wrapped_locale(const char*, const func_callback
&);
104 // Run select unit tests after setting environment variables.
106 run_tests_wrapped_env(const char*, const char*, const func_callback
&);
120 struct pod_unsigned_int
139 // Specifically and glaringly-obviously marked 'signed' so that when
140 // COUNT mistakenly goes negative, we can track the patterns of
141 // deletions more easily.
142 typedef signed int size_type
;
143 static size_type count
;
144 counter() { ++count
; }
145 counter (const counter
&) { ++count
; }
146 ~counter() { --count
; }
149 #define assert_count(n) VERIFY(__gnu_cxx_test::counter::count == n)
151 // A (static) class for counting copy constructors and possibly throwing an
152 // exception on a desired count.
153 class copy_constructor
157 count() { return count_
; }
163 if (count_
== throw_on_
)
164 __throw_exception_again
"copy constructor exception";
175 throw_on(unsigned int count
) { throw_on_
= count
; }
178 static unsigned int count_
;
179 static unsigned int throw_on_
;
182 // A (static) class for counting assignment operator calls and
183 // possibly throwing an exception on a desired count.
184 class assignment_operator
188 count() { return count_
; }
194 if (count_
== throw_on_
)
195 __throw_exception_again
"assignment operator exception";
206 throw_on(unsigned int count
) { throw_on_
= count
; }
209 static unsigned int count_
;
210 static unsigned int throw_on_
;
213 // A (static) class for tracking calls to an object's destructor.
218 count() { return _M_count
; }
221 mark_call() { _M_count
++; }
224 reset() { _M_count
= 0; }
227 static unsigned int _M_count
;
230 // An class of objects that can be used for validating various
231 // behaviours and guarantees of containers and algorithms defined in
232 // the standard library.
236 // Creates a copy-tracking object with the given ID number. If
237 // "throw_on_copy" is set, an exception will be thrown if an
238 // attempt is made to copy this object.
239 copy_tracker(int id
= next_id_
--, bool throw_on_copy
= false)
240 : id_(id
) , throw_on_copy_(throw_on_copy
) { }
242 // Copy-constructs the object, marking a call to the copy
243 // constructor and forcing an exception if indicated.
244 copy_tracker(const copy_tracker
& rhs
)
245 : id_(rhs
.id()), throw_on_copy_(rhs
.throw_on_copy_
)
247 int kkk
= throw_on_copy_
;
249 copy_constructor::throw_on(copy_constructor::count() + 1);
250 copy_constructor::mark_call();
253 // Assigns the value of another object to this one, tracking the
254 // number of times this member function has been called and if the
255 // other object is supposed to throw an exception when it is
256 // copied, well, make it so.
258 operator=(const copy_tracker
& rhs
)
261 if (rhs
.throw_on_copy_
)
262 assignment_operator::throw_on(assignment_operator::count() + 1);
263 assignment_operator::mark_call();
267 { destructor::mark_call(); }
270 id() const { return id_
; }
274 const bool throw_on_copy_
;
280 copy_constructor::reset();
281 assignment_operator::reset();
285 // for backwards-compatibility
288 { return copy_constructor::count(); }
290 // for backwards-compatibility
293 { return destructor::count(); }
300 operator==(const copy_tracker
& lhs
, const copy_tracker
& rhs
)
301 { return lhs
.id() == rhs
.id(); }
302 }; // namespace __gnu_cxx_test
306 template<class _CharT
>
309 // char_traits specialization
311 struct char_traits
<__gnu_cxx_test::pod_char
>
313 typedef __gnu_cxx_test::pod_char char_type
;
314 typedef __gnu_cxx_test::pod_int int_type
;
315 typedef long pos_type
;
316 typedef unsigned long off_type
;
317 typedef __gnu_cxx_test::state state_type
;
320 assign(char_type
& __c1
, const char_type
& __c2
);
323 eq(const char_type
& __c1
, const char_type
& __c2
);
326 lt(const char_type
& __c1
, const char_type
& __c2
);
329 compare(const char_type
* __s1
, const char_type
* __s2
, size_t __n
);
332 length(const char_type
* __s
);
334 static const char_type
*
335 find(const char_type
* __s
, size_t __n
, const char_type
& __a
);
338 move(char_type
* __s1
, const char_type
* __s2
, size_t __n
);
341 copy(char_type
* __s1
, const char_type
* __s2
, size_t __n
);
344 assign(char_type
* __s
, size_t __n
, char_type __a
);
347 to_char_type(const int_type
& __c
);
350 to_int_type(const char_type
& __c
);
353 eq_int_type(const int_type
& __c1
, const int_type
& __c2
);
359 not_eof(const int_type
& __c
);
363 #endif // _GLIBCPP_TESTSUITE_HOOKS_H