callback_r_15.h

Go to the documentation of this file.

/*
 * *** ATTENTION!  DO NOT MODIFY THIS FILE DIRECTLY! ***
 * 
 * It has automatically been generated from callback_r_x.tmpl.h
 * by param_expander.py on Tue Oct  7 01:22:01 2025.
 */
 
/** @file
 *  @author Bram de Greve (bram@cocamware.com)
 *  @author Tom De Muer (tom@cocamware.com)
 *
 *  *** BEGIN LICENSE INFORMATION ***
 *  
 *  The contents of this file are subject to the Common Public Attribution License 
 *  Version 1.0 (the "License"); you may not use this file except in compliance with 
 *  the License. You may obtain a copy of the License at 
 *  http://lass.sourceforge.net/cpal-license. The License is based on the 
 *  Mozilla Public License Version 1.1 but Sections 14 and 15 have been added to cover 
 *  use of software over a computer network and provide for limited attribution for 
 *  the Original Developer. In addition, Exhibit A has been modified to be consistent 
 *  with Exhibit B.
 *  
 *  Software distributed under the License is distributed on an "AS IS" basis, WITHOUT 
 *  WARRANTY OF ANY KIND, either express or implied. See the License for the specific 
 *  language governing rights and limitations under the License.
 *  
 *  The Original Code is LASS - Library of Assembled Shared Sources.
 *  
 *  The Initial Developer of the Original Code is Bram de Greve and Tom De Muer.
 *  The Original Developer is the Initial Developer.
 *  
 *  All portions of the code written by the Initial Developer are:
 *  Copyright (C) 2004-2025 the Initial Developer.
 *  All Rights Reserved.
 *  
 *  Contributor(s):
 *
 *  Alternatively, the contents of this file may be used under the terms of the 
 *  GNU General Public License Version 2 or later (the GPL), in which case the 
 *  provisions of GPL are applicable instead of those above.  If you wish to allow use
 *  of your version of this file only under the terms of the GPL and not to allow 
 *  others to use your version of this file under the CPAL, indicate your decision by 
 *  deleting the provisions above and replace them with the notice and other 
 *  provisions required by the GPL License. If you do not delete the provisions above,
 *  a recipient may use your version of this file under either the CPAL or the GPL.
 *  
 *  *** END LICENSE INFORMATION ***
 */
 
 
 
/** @class lass::util::CallbackR15
 *  @ingroup Callback
 *  @brief callback with 15 parameter15 and with returnvalue.
 *  @date 2002
 *  @author Bram de Greve [Bramz] (contact: bram@cocamware.com)
 *
 *  It's a single object that can hold a reference to a free function or an
 *  object/(const) method pair.  Once the callback is constructed, it works
 *  completely transparent.  All it shows to the client is a function that
 *  takes 15 parameter(s) and gives a returnvalue.
 */
 
 
 
#ifndef LASS_GUARDIAN_OF_INCLUSION_UTIL_CALLBACK_R_15_H
#define LASS_GUARDIAN_OF_INCLUSION_UTIL_CALLBACK_R_15_H
 
 
 
// --- OLD INTERFACES ----------------------------------------------------------
 
#include "util_common.h"
#include "shared_ptr.h"
#include "callback_common.h"
#include "impl/dispatcher_r_15.h"
 
 
 
 
// --- NEW INTERFACES ----------------------------------------------------------
 
namespace lass
{
namespace util
{
 
 
// THE CALLBACK:
// This is the actuall class you use to hold callbacks:
 
template
<
    typename R, 
    typename P1, typename P2, typename P3, typename P4, typename P5, typename P6, typename P7, typename P8, typename P9, typename P10, typename P11, typename P12, typename P13, typename P14, typename P15
>
class CallbackR15
{
public:
 
    typedef CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15> TSelf;
    typedef SharedPtr< impl::DispatcherR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15> > TDispatcherPtr;
 
    // STRUCTORS
 
    /** Default constructor, construct empty callback.
     */
    CallbackR15()
    {
    }
 
    /** Construct function callback
     */
    template <typename FunctionType>
    CallbackR15(FunctionType iFunction):
        dispatcher_(new impl::DispatcherR15Function<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15, FunctionType>(iFunction))
    {
    }
 
    /** Construct object/method callback.
     */
    template <typename ObjectPtr, typename Method>
    CallbackR15(ObjectPtr iObject, Method iMethod):
        dispatcher_(new impl::DispatcherR15Method<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15, ObjectPtr, Method>(iObject, iMethod))
    {
    }
 
    /** copy constructor
     */
    CallbackR15(const TSelf& iOther):
        dispatcher_(iOther.dispatcher_)
    {
    }
 
    /** move constructor
     */
    CallbackR15(TSelf&& iOther) noexcept:
        dispatcher_(std::move(iOther.dispatcher_))
    {
    }
 
 
    // OPERATORS
 
    /** assignment operator
     */
    TSelf& operator=(const TSelf& iOther)
    {
        TSelf temp(iOther);
        swap(temp);
        return *this;
    }
 
    /** assignment operator
     */
    TSelf& operator=(TSelf&& iOther) noexcept
    {
        dispatcher_ = std::move(iOther.dispatcher_);
        return *this;
    }
 
    /** THE operator.  Executes the callback.
     */
    R operator()(typename util::CallTraits<P1>::TParam iP1, typename util::CallTraits<P2>::TParam iP2, typename util::CallTraits<P3>::TParam iP3, typename util::CallTraits<P4>::TParam iP4, typename util::CallTraits<P5>::TParam iP5, typename util::CallTraits<P6>::TParam iP6, typename util::CallTraits<P7>::TParam iP7, typename util::CallTraits<P8>::TParam iP8, typename util::CallTraits<P9>::TParam iP9, typename util::CallTraits<P10>::TParam iP10, typename util::CallTraits<P11>::TParam iP11, typename util::CallTraits<P12>::TParam iP12, typename util::CallTraits<P13>::TParam iP13, typename util::CallTraits<P14>::TParam iP14, typename util::CallTraits<P15>::TParam iP15) const
    {
        if (isEmpty())
        {
            LASS_THROW_EX(EmptyCallback, "You've tried to call an empty CallbackR15.  Can't return a value.");
        }
        return dispatcher_->call(iP1, iP2, iP3, iP4, iP5, iP6, iP7, iP8, iP9, iP10, iP11, iP12, iP13, iP14, iP15);
    }
 
 
    // METHODS
 
    /** Reset to empty callback.
     */
    void reset()
    {
        dispatcher_.reset();
    }
 
    /** Returns true if no callback dispatcher is assigned to this object.
     */
    bool isEmpty() const
    {
        return dispatcher_.isEmpty();
    }
 
    /** return this->isEmpty()
     */
    bool operator!() const
    {
        return dispatcher_.isEmpty(); 
    }
 
    /** return !this->isEmpty())
     */
    explicit operator bool() const
    {
        return !dispatcher_.isEmpty();
    }
 
    /** Swaps the dispatcher of this callback with the dispatcher of another.
     */
    void swap(TSelf& iOther)
    {
        dispatcher_.swap(iOther.dispatcher_);
    }
 
    /** return true if two callbacks call the same function/method,
     *  NEEDS RTTI!
     */
    bool operator==(const TSelf& iOther) const
    {
        if (dispatcher_ == iOther.dispatcher_)
        {
            return true;
        }
        return dispatcher_ && dispatcher_->isEquivalent(iOther.dispatcher_.get());
    }
 
    const TDispatcherPtr& dispatcher() const
    {
        return dispatcher_;
    }
 
private:
 
    TDispatcherPtr dispatcher_;
};
 
 
 
/** return true if two callbacks are different
 *  @relates CallbackR15
 */
template<typename R, typename P1, typename P2, typename P3, typename P4, typename P5, typename P6, typename P7, typename P8, typename P9, typename P10, typename P11, typename P12, typename P13, typename P14, typename P15>
inline bool operator!=(const CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15>& iA, const CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15>& iB)
{
    return !(iA == iB);
}
 
 
/** make a CallbackR15 from a function
 *  @relates CallbackR15
 */
template <typename R, typename P1, typename P2, typename P3, typename P4, typename P5, typename P6, typename P7, typename P8, typename P9, typename P10, typename P11, typename P12, typename P13, typename P14, typename P15> inline
CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15> makeCallback(R (*iFunction)(P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15))
{
    return CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15>(iFunction);
}
 
 
 
/** make a CallbackR15 from a function
 *  @relates CallbackR15
 */
template <typename R, typename P1, typename P2, typename P3, typename P4, typename P5, typename P6, typename P7, typename P8, typename P9, typename P10, typename P11, typename P12, typename P13, typename P14, typename P15> inline
const CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15>& makeCallback(const CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15>& iCallback)
{
    return iCallback;
}
 
 
 
/** make a CallbackR15 from a object and method
 *  @relates CallbackR15
 */
template <typename ObjectPtr, typename Object, typename R, typename P1, typename P2, typename P3, typename P4, typename P5, typename P6, typename P7, typename P8, typename P9, typename P10, typename P11, typename P12, typename P13, typename P14, typename P15> inline
CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15> makeCallback(ObjectPtr iObject, R (Object::*iMethod)(P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15))
{
    return CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15>(iObject, iMethod);
}
 
 
 
/** make a CallbackR15 from a object and const method
 *  @relates CallbackR15
 */
template <typename ObjectPtr, typename Object, typename R, typename P1, typename P2, typename P3, typename P4, typename P5, typename P6, typename P7, typename P8, typename P9, typename P10, typename P11, typename P12, typename P13, typename P14, typename P15> inline
CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15> makeCallback(ObjectPtr iObject, R (Object::*iMethod)(P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15) const)
{
    return CallbackR15<R, P1, P2, P3, P4, P5, P6, P7, P8, P9, P10, P11, P12, P13, P14, P15>(iObject, iMethod);
}
 
 
 
}
 
}
 
#define LASS_PRIM_HAVE_PY_EXPORT_TRAITS_CALLBACK_R15
#ifdef LASS_GUARDIAN_OF_INCLUSION_UTIL_CALLBACK_PYTHON_H
#   include "../python/callback_python.h"
#endif
 
#endif // Guardian of Inclusion
 
// EOF