CC_CALLBACK原理及應用

c++ 11 基礎 :

    std::function

        類模版 std::function是一種通用、多態的函數封裝。std::function的實例能夠對任何能夠調用的目標進行存儲、複製、和調用操做，這些目標包括函數、lambda表達式、綁定表達式、以及其它函數對象等。

用法示例：

①保存自由函數

void printA(int a)
{
    cout<<a<<endl;
}

 std::function<void(int a)> func;
 func = printA;
 func(2);

運行輸出： 2

②保存lambda表達式

std::function<void()> func_1 = [](){cout<<"hello world"<<endl;};
    func_1();

運行輸出：hello world

③保存成員函數

struct Foo {
    Foo(int num) : num_(num) {}
    void print_add(int i) const { cout << num_+i << '\n'; }
    int num_;
};

 // 保存成員函數
    std::function<void(const Foo&, int)> f_add_display = &Foo::print_add;
    Foo foo(2);
    f_add_display(foo, 1);

    運行輸出： 3

    bind        bind是一組用於函數綁定的模板。在對某個函數進行綁定時，能夠指定部分參數或所有參數，也能夠不指定任何參數，還能夠調整各個參數間的順序。對於未指定的參 數，能夠使用佔位符_一、_二、_3來表示。_1表示綁定後的函數的第1個參數，_2表示綁定後的函數的第2個參數，其餘依次類推。

下面經過程序例子瞭解一下用法：

#include <iostream>
using namespace std;
class A
{
public:
    void fun_3(int k,int m)
    {
        cout<<k<<" "<<m<<endl;
    }
};

void fun(int x,int y,int z)
{
    cout<<x<<"  "<<y<<"  "<<z<<endl;
}

void fun_2(int &a,int &b)
{
    a++;
    b++;
    cout<<a<<"  "<<b<<endl;
}

int main(int argc, const char * argv[])
{
    auto f1 = bind(fun,1,2,3); //表示綁定函數 fun 的第一，二，三個參數值爲： 1 2 3
    f1(); //print:1  2  3
    
    auto f2 = bind(fun, placeholders::_1,placeholders::_2,3);
    //表示綁定函數 fun 的第三個參數爲 3，而fun 的第一，二個參數分別有調用 f2 的第一，二個參數指定
    f2(1,2);//print:1  2  3
    
    auto f3 = bind(fun,placeholders::_2,placeholders::_1,3);
    //表示綁定函數 fun 的第三個參數爲 3，而fun 的第一，二個參數分別有調用 f3 的第二，一個參數指定
    //注意： f2  和  f3 的區別。
    f3(1,2);//print:2  1  3
    
    
    int n = 2;
    int m = 3;
    
    auto f4 = bind(fun_2, n,placeholders::_1);
    f4(m); //print:3  4

    cout<<m<<endl;//print:4  說明：bind對於不事先綁定的參數，經過std::placeholders傳遞的參數是經過引用傳遞的
    cout<<n<<endl;//print:2  說明：bind對於預先綁定的函數參數是經過值傳遞的
    
    
    A a;
    auto f5 = bind(&A::fun_3, a,placeholders::_1,placeholders::_2);
    f5(10,20);//print:10 20
    
    std::function<void(int,int)> fc = std::bind(&A::fun_3, a,std::placeholders::_1,std::placeholders::_2);
    fc(10,20);//print:10 20
    
    return 0;
}

    CC_CALLBACK

        1、經過 HelloWorldScene 中的 closeItem 開始

在cocos2d-x 2.x 版本中：

CCMenuItemImage *pCloseItem = CCMenuItemImage::create(
                                        "CloseNormal.png",
                                        "CloseSelected.png",
                                        this,
                                        menu_selector(HelloWorld::menuCloseCallback));

在cocos2d-x 3.0 版本中：

auto closeItem = MenuItemImage::create(
                                           "CloseNormal.png",
                                           "CloseSelected.png",
                                           CC_CALLBACK_1(HelloWorld::menuCloseCallback, this));

void HelloWorld::menuCloseCallback(Object* pSender)
{
    Director::getInstance()->end();

#if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
    exit(0);
#endif
}

注意到在3.0版本中使用到 CC_CALLBACK_1 這樣一個宏定義。

// new callbacks based on C++11
#define CC_CALLBACK_0(__selector__,__target__, ...) std::bind(&__selector__,__target__, ##__VA_ARGS__)
#define CC_CALLBACK_1(__selector__,__target__, ...) std::bind(&__selector__,__target__, std::placeholders::_1, ##__VA_ARGS__)
#define CC_CALCC_CALLBACK_1(HelloWorld::menuCloseCallback,this)LBACK_2(__selector__,__target__, ...) std::bind(&__selector__,__target__, std::placeholders::_1, std::placeholders::_2, ##__VA_ARGS__)
#define CC_CALLBACK_3(__selector__,__target__, ...) std::bind(&__selector__,__target__, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3 ##__VA_ARGS__)

這裏主要注意兩點：一是 std::bind，二是##_VA_ARGS_; ##_VA_ARGS_是可變參數宏

原來還有 CC_CALLBACK_0 1 2 3;而其中又有什麼區別呢？

一、首先咱們看看3.0版本中MenuItemImage的create方法：

MenuItemImage * MenuItemImage::create(const std::string& normalImage, const std::string& selectedImage, const ccMenuCallback& callback)

其中的回調參數是 ccMenuCallback

typedef std::function<void(Object*)> ccMenuCallback

來這裏使用到了 C++ 中的 function 語法。

注意到 在 CC_CALLBACK_  的宏定義的中使用到的是 C++ 的 bind 語法，怎麼不一致了呢？ -- 見下面第四點 function

二、看回 CC_CALLBACK_  的宏定義

原來 CC_CALLBACK_  的宏定義中後面的 0 1 2 3分別表示的是 不事先指定回調函數參數的個數。

例如說 CC_CALLBACK_ 1 表示的是，回調函數中不事先指定參數是一個，而事先指定的回調函數的參數 能夠任意多個。

並且要注意到其中 不指定回調函數參數  和  指定回調函數參數  的順序，注意不事先指定的在前，事先指定的在後。

下面經過例子說明這一點：

假設回調函數：

// a selector callback
    void menuCloseCallback(Object* pSender,int a,int b);

void HelloWorld::menuCloseCallback(Object* pSender,int a,int b)
{
    std::cout<<a<<"  "<<b<<std::endl;
    Director::getInstance()->end();

#if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
    exit(0);
#endif
}

注意到在回調函數中輸出 a b

auto closeItem = MenuItemImage::create(
                                           "CloseNormal.png",
                                           "CloseSelected.png",
                                           CC_CALLBACK_1(HelloWorld::menuCloseCallback,this,1,2));

注意中其中 指定了兩個參數 1 2 

運行，在 點擊closeItem  的時候，就會輸出這兩個事先指定的參數 1  2。

那麼，不事先指定的參數是在何時傳入的呢？

void MenuItem::activate()
{
    if (_enabled)
    {
        if( _callback )
        {
            _callback(this);
        }
        
        if (kScriptTypeNone != _scriptType)
        {
            BasicScriptData data(this);
            ScriptEvent scriptEvent(kMenuClickedEvent,&data);
            ScriptEngineManager::getInstance()->getScriptEngine()->sendEvent(&scriptEvent);
        }
    }
}

    注意到其中的  _callback(this);  對了，這個時候就傳入了 這個不事先指定的回調函數參數。

這樣，closeItem 的回調函數的 void HelloWorld::menuCloseCallback(Object* pSender,int a,int b) 的三個參數都知道了。

第一個 不事先指定，在menu item調用 activate 的時候，_callback(this) 傳入，this 也便是這個 menu item；第2、三個參數是事先指定的 1,2。

已經知道  CC_CALLBACK_  的宏定義是 std::bind 那麼咱們能夠直接使用std::bind。

以下：

auto closeItem = MenuItemImage::create(
                                           "CloseNormal.png",
                                           "CloseSelected.png",
                                           std::bind(&HelloWorld::menuCloseCallback, this,std::placeholders::_1,1,2));