Doxygen will only process files with a @file documentation comment. Up to now, none of our test code has such a comment, preventing the cross-links to unit tests from working. This is unfortunate, since unit tests, and even the code comments there, can be considered as the most useful form of technical documentation. Thus I'll start an initiative to fill in those missing comments automatically
145 lines
4.3 KiB
C++
145 lines
4.3 KiB
C++
/*
|
|
TestHelperVariadic(Test) - verify variadic template diagnostics helper
|
|
|
|
Copyright (C) Lumiera.org
|
|
2014, Hermann Vosseler <Ichthyostega@web.de>
|
|
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation; either version 2 of
|
|
the License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
|
|
* *****************************************************/
|
|
|
|
/** @file test-helper-variadic-test.cpp
|
|
** unit test §§TODO§§
|
|
*/
|
|
|
|
|
|
#include "lib/test/run.hpp"
|
|
#include "lib/test/test-helper.hpp"
|
|
|
|
|
|
#include <iostream>
|
|
#include <utility>
|
|
#include <string>
|
|
#include <cmath>
|
|
|
|
using std::string;
|
|
using std::cout;
|
|
|
|
|
|
namespace lib {
|
|
namespace test{
|
|
namespace test{
|
|
|
|
namespace { // test fixture...
|
|
|
|
class Interface
|
|
{
|
|
public:
|
|
Interface(){}
|
|
Interface(Interface const& o) { cout << "COPY.CT from "<<&o<<" !!!\n"; }
|
|
Interface(Interface const&& o) { cout << "MOVE.CT from "<<&o<<" !!!\n"; }
|
|
|
|
Interface& operator= (Interface const& o) { cout << "COPY= from "<<&o<<" !!!\n"; return *this; }
|
|
Interface& operator= (Interface const&& o) { cout << "MOVE= from "<<&o<<" !!!\n"; return *this; }
|
|
|
|
virtual ~Interface() { }
|
|
};
|
|
|
|
class Impl
|
|
: public Interface
|
|
{
|
|
string s_;
|
|
|
|
public:
|
|
Impl(string ss ="ZOMG") : s_(ss) { }
|
|
};
|
|
|
|
|
|
inline double
|
|
makeRvalue()
|
|
{
|
|
return atan2(0,-0.0);
|
|
}
|
|
|
|
|
|
}//(End) test fixture
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/****************************************************************************//**
|
|
* @test document usage of the diagnostics helper for variadic templates.
|
|
* Errors in variadic template instantiations are sometimes hard to spot,
|
|
* due to the intricacies of template argument matching and the
|
|
* reference collapsing rules. Our diagnostics facility is itself a
|
|
* variadic function template, which, when supplied with an argument pack,
|
|
* will build a diagnostic string describing the arguments.
|
|
* @warning care has to be taken to pass the template arguments properly,
|
|
* since template argument matching might mess up the reference kind
|
|
* (rvalue, lvalue) of the passed types. Thus, either use std::forward,
|
|
* or spell out the template argument(s) explicitly on invocation
|
|
*
|
|
* @see showVariadicTypes()
|
|
* @see TestHelper_test
|
|
*/
|
|
class TestHelperVariadic_test : public Test
|
|
{
|
|
|
|
virtual void
|
|
run (Arg)
|
|
{
|
|
double d = makeRvalue();
|
|
double& dr = d;
|
|
|
|
Impl obj;
|
|
Interface const& ref = obj;
|
|
|
|
cout << "--no-arg--\n" << showVariadicTypes() <<"\n";
|
|
cout << "--value--\n" << showVariadicTypes<double>(d) <<"\n";
|
|
cout << "--reference--\n" << showVariadicTypes<double&>(d) <<"\n";
|
|
cout << "--move--\n" << showVariadicTypes<double&&>(d) <<"\n";
|
|
|
|
forwardFunction("two values", "foo", 42L); // passed as REF, MOV
|
|
forwardFunction("matched", d,dr,std::move(dr)); // passed as REF, REF, MOV
|
|
|
|
forwardFunction<Interface const&>("baseclass", ref);
|
|
}
|
|
|
|
|
|
/** this dummy simulates a typical variadic call
|
|
* which takes all arguments as '&&' for the purpose of "perfect forwarding"
|
|
*/
|
|
template<typename... ARGS>
|
|
void
|
|
forwardFunction (string id, ARGS&&... args)
|
|
{
|
|
// in reality here you'd invoke some factory(<std::forward<ARGS>(args)...)
|
|
//
|
|
cout << "--"<<id<<"--\n"
|
|
<< showVariadicTypes<ARGS&&...>(args...)
|
|
<< "\n"
|
|
;
|
|
}
|
|
|
|
};
|
|
|
|
|
|
/** Register this test class... */
|
|
LAUNCHER (TestHelperVariadic_test, "unit common");
|
|
|
|
|
|
}}} // namespace lib::test::test
|