virtual-copy-support-test.cpp

Go to the documentation of this file.

/*
  VirtualCopySupport(Test)  -  copy and clone type-erased objects

  Copyright (C)         Lumiera.org
    2015,               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.

* *****************************************************/

#include "lib/test/run.hpp"
#include "lib/format-string.hpp"
#include "lib/test/test-helper.hpp"
#include "lib/meta/virtual-copy-support.hpp"
#include "lib/format-string.hpp"
#include "lib/format-cout.hpp"
#include "lib/util.hpp"

#include <string>
#include <type_traits>

using util::_Fmt;
using util::isnil;
using std::string;

using LERR_(LOGIC);
using LERR_(WRONG_TYPE);


namespace lib  {
namespace meta {
namespace test {
  
  namespace { // Test fixture...
    
    int _CheckSum_ = 0;
    
    class Interface;
    
    
    class CopyInterface
      {
      public:
        virtual void  copyInto (void*     )  const { /* NOP */ };
        virtual void  moveInto (void*     )        { /* NOP */ };
        virtual void  copyInto (Interface&)  const { /* NOP */ };
        virtual void  moveInto (Interface&)        { /* NOP */ };
      };
    
    
    class Interface
      : public CopyInterface
      {
      public:
        virtual ~Interface()  { }
        virtual operator string()  const =0;
        virtual bool empty()       const =0;
      };
    
    template<uint i>
    class Sub
      : public Interface
      {
        static_assert (0 < i, "invalid construction");
        
        char storage_[i];
        
        char&
        access()
          {
            return storage_[i-1];
          }
        char const&
        access()  const
          {
            return storage_[i-1];
          }
        
      public: /* == Implementation of the Interface == */
        
        virtual operator string()  const override
          {
            return _Fmt("Sub|%s|%d|-%s")
                      % util::typeStr(this)
                      % i
                      % access();
          }
        
        virtual bool
        empty()  const
          {
            return not access();
          }
        
        
      public: /* == full set of copy and assignment operations == */
        
       ~Sub()
          {
            _CheckSum_ -= access();
          }
        Sub()
          {
            access() = 'A' + rand() % 23;
            _CheckSum_ += access();
          }
        Sub (Sub const& osub)
          {
            access() = osub.access();
            _CheckSum_ += access();
          }
        Sub (Sub&& rsub)
          {
            access() = 0;
            std::swap(access(),rsub.access());
          }
        Sub&
        operator= (Sub const& osub)
          {
            if (!util::isSameObject (*this, osub))
              {
                _CheckSum_ -= access();
                access() = osub.access();
                _CheckSum_ += access();
              }
            return *this;
          }
        Sub&
        operator= (Sub&& rsub)
          {
            _CheckSum_ -= access();
            access() = 0;
            std::swap(access(),rsub.access());
            return *this;
          }
      };
    
    
    /* == create various flavours of copyable / noncopyable objects == */
    
    template<char c>
    class Regular
      : public Sub<c>
      { };
    
    template<char c>
    class UnAssignable
      : public Sub<c>
      {
        void operator= (UnAssignable const&); // private and unimplemented
      public:
        UnAssignable()                    = default;
        UnAssignable(UnAssignable&&)      = default;
        UnAssignable(UnAssignable const&) = default;
      };
    
    template<char c>
    class OnlyMovable
      : public UnAssignable<c>
      {
      public:
        OnlyMovable (OnlyMovable const&) = delete;
        OnlyMovable()                    = default;
        OnlyMovable(OnlyMovable&&)       = default;
      };
    
    template<char c>
    class Noncopyable
      : public OnlyMovable<c>
      {
      public:
        Noncopyable (Noncopyable&&) = delete;
        Noncopyable ()              = default;
      };
    
    
    
    /* == concrete implementation subclass with virtual copy support == */
    
    template<class IMP>
    class Opaque                          //-----Interface| CRTP-Impl  | direct Baseclass
      : public CopySupport<IMP>::template Policy<Interface, Opaque<IMP>, IMP>
      {
      public:
          static Opaque&
          downcast (Interface& bas)
            {
              Opaque* impl = dynamic_cast<Opaque*> (&bas);
              
              if (!impl)
                throw error::Logic{"virtual copy works only on instances "
                                   "of the same concrete implementation class"
                                  , LERR_(WRONG_TYPE)};
              else
               return *impl;
            }
      };
    
    // == Test subject(s)==========================
    using RegularImpl  = Opaque<Regular<'a'>>;
    using ClonableImpl = Opaque<UnAssignable<'b'>>;
    using MovableImpl  = Opaque<OnlyMovable<'c'>>;
    using ImobileImpl  = Opaque<Noncopyable<'d'>>;
    
  }//(End)Test fixture
  
  
  
  
  
  
  
  /**********************************************************************************************/
  class VirtualCopySupport_test : public Test
    {
      virtual void
      run (Arg)
        {
          CHECK(0 == _CheckSum_);
          
          verify_TestFixture();
          
          CHECK(0 == _CheckSum_);
          
          verify_fullVirtualCopySupport();
          verify_noAssignementSupport();
          verify_onlyMovableSupport();
          verify_disabledCopySupport();
          
          CHECK(0 == _CheckSum_);
        }
      
      
      void
      verify_TestFixture()
        {
          /* == full copy, move and assignment == */
          Regular<'A'> a;
          Regular<'A'> aa(a);
          Regular<'A'> a1;
          
          cout << a  <<endl
               << aa <<endl
               << a1 <<endl;
          
          a1 = a;
          
          CHECK (string(a) == string(aa));
          CHECK (string(a) == string(a1));
          CHECK (!isnil(a1));
          
          a = std::move(a1);
          
          CHECK (isnil(a1));
          CHECK (string(a) == string(aa));
          
          
          /* == interface vs. concrete class == */
          Regular<'B'> b;
          Interface& ii = b;
          
          string prevID(b);
          ii = a;             // Copy operation of Base-Interface is NOP
          CHECK (string(b) == prevID);
          
          
          /* == assignment inhibited == */
          UnAssignable<'C'> c;
          UnAssignable<'C'> cc(c);
          
          CHECK (string(c) == string(cc));
          
          prevID = cc;
          UnAssignable<'C'> ccc(std::move(cc));
          
          cout << cc  <<endl
               << ccc <<endl;
          
          CHECK (string(ccc) == prevID);
          CHECK (string(cc) != prevID);
          CHECK (!isnil(ccc));
          CHECK (isnil (cc));   // killed by moving away
          
          // c = cc;  // does not compile
          
          
          /* == only move construction allowed == */
          OnlyMovable<'D'> d;
          OnlyMovable<'D'> dd (std::move(d));
          
          cout << d  <<endl
               << dd <<endl;
          
          CHECK (string(dd) != string(d));
          CHECK (!isnil(dd));
          CHECK (isnil(d));
          
          // OnlyMovable<'D'> d1 (dd);     // does not compile
          // d = dd;                       // does not compile;
          
          
          /* == all copy/assignment inhibited == */
          Noncopyable<'E'> e;
          // Noncopyable<'E'> ee (e);                // does not compile
          // Noncopyable<'E'> eee (std::move (e));   // does not compile
          // e = Noncopyable<'E'>();                 // does not compile
          
          CHECK (!isnil (e));
        }
      
      
      
      
      
      
      void
      verify_fullVirtualCopySupport()
        {
          RegularImpl a,aa,aaa;
          Interface& i(a);
          Interface& ii(aa);
          Interface& iii(aaa);
          
          char storage[sizeof(RegularImpl)];
          Interface& iiii (*reinterpret_cast<Interface*> (&storage));
          
          string prevID = a;
          CHECK (!isnil (a));
          
          i.moveInto(&storage);
          CHECK (string(iiii) == prevID);
          CHECK (!isnil(iiii));
          CHECK ( isnil(i));
          
          ii.copyInto(i);
          CHECK (!isnil(i));
          CHECK (!isnil(ii));
          CHECK (string(i) == string(ii));
          
          prevID = iii;
          iii.moveInto(ii);
          CHECK (!isnil(ii));
          CHECK ( isnil(iii));
          CHECK (string(ii) == prevID);
          
          // Verify that type mismatch in assignment is detected...
          Opaque<Regular<'!'>> divergent;
          Interface& evil(divergent);
          VERIFY_ERROR (WRONG_TYPE, evil.copyInto(i));
          VERIFY_ERROR (WRONG_TYPE, evil.moveInto(i));
          
          
          cout << "==fullVirtualCopySupport=="<<endl
               << i    <<endl
               << ii   <<endl
               << iii  <<endl
               << iiii <<endl;
          
          //need to clean-up the placement-new instance explicitly
          iiii.~Interface();
        }
      
      
      void
      verify_noAssignementSupport()
        {
          ClonableImpl b,bb,bbb;
          Interface& i(b);
          Interface& ii(bb);
          Interface& iii(bbb);
          
          char storage[sizeof(ClonableImpl)];
          Interface& iiii (*reinterpret_cast<Interface*> (&storage));
          
          string prevID = b;
          CHECK (!isnil (b));
          
          i.moveInto(&storage);
          CHECK (string(iiii) == prevID);
          CHECK (!isnil(iiii));
          CHECK ( isnil(i));
          
          iiii.~Interface(); //clean-up previously placed instance
          
          prevID = ii;
          ii.copyInto(&storage);
          CHECK (!isnil(ii));
          CHECK (!isnil(iiii));
          CHECK ( isnil(i));
          CHECK (string(iiii) == prevID);
          CHECK (string(ii) == prevID);
          
          prevID = iii;
          VERIFY_ERROR (LOGIC, iii.copyInto(ii));
          VERIFY_ERROR (LOGIC, iii.moveInto(ii));
          CHECK (string(iii) == prevID);
          CHECK (!isnil(iii));
          
          cout << "==noAssignementSupport=="<<endl
               << i    <<endl
               << ii   <<endl
               << iii  <<endl
               << iiii <<endl;
          
          //clean-up placement-new instance
          iiii.~Interface();
        }
      
      
      void
      verify_onlyMovableSupport()
        {
          MovableImpl c,cc;
          Interface& i(c);
          Interface& ii(cc);
          
          char storage[sizeof(MovableImpl)];
          Interface& iiii (*reinterpret_cast<Interface*> (&storage));
          
          string prevID = i;
          CHECK (!isnil (i));
          
          i.moveInto(&storage);
          CHECK (string(iiii) == prevID);
          CHECK (!isnil(iiii));
          CHECK ( isnil(i));
          
          prevID = ii;
          VERIFY_ERROR (LOGIC, ii.copyInto(&storage));
          VERIFY_ERROR (LOGIC, ii.copyInto(i));
          VERIFY_ERROR (LOGIC, ii.moveInto(i));
          CHECK (string(ii) == prevID);
          CHECK (!isnil(ii));
          CHECK ( isnil(i));
          
          cout << "==onlyMovableSupport=="<<endl
               << i    <<endl
               << ii   <<endl
               << iiii <<endl;
          
          //clean-up placement-new instance
          iiii.~Interface();
        }
      
      
      void
      verify_disabledCopySupport()
        {
          ImobileImpl d,dd;
          Interface& i(d);
          Interface& ii(dd);
          char storage[sizeof(ImobileImpl)];
          
          CHECK (!isnil (i));
          
          string prevID = ii;
          VERIFY_ERROR (LOGIC, ii.copyInto(&storage));
          VERIFY_ERROR (LOGIC, ii.moveInto(&storage));
          VERIFY_ERROR (LOGIC, ii.copyInto(i));
          VERIFY_ERROR (LOGIC, ii.moveInto(i));
          CHECK (string(ii) == prevID);
          CHECK (!isnil(ii));
          CHECK (!isnil (i));
          
          cout << "==disabledCopySupport=="<<endl
               << i  <<endl
               << ii <<endl;
          
          //no clean-up,
          //since we never created anything in the storage buffer
        }
    };
  
  
  LAUNCHER (VirtualCopySupport_test, "unit common");
  
  
  
}}} // namespace lib::meta::test