本文是學習學習他人的部落格的心得（具體詳見“樓主見解”），如果源網站可訪問的話，建議直接訪問源網站：

樓主見解：

主要講解訊號的流程，不想了解流程，不看也罷。

主要講解g_signal_new函式的使用，以及具體引數的意義

原型：

guint g_signal_new (const gchar        *signal_name,
                    GType               itype,
                    GSignalFlags        signal_flags,
                    guint               class_offset,
                    GSignalAccumulator  accumulator,
                    gpointer            accu_data,
                    GSignalCMarshaller  c_marshaller,
                    GType               return_type,
                    guint               n_params,
                    ...);
 

’呼叫：

  g_signal_new ("hello",
                      G_TYPE_FROM_CLASS (klass),
                      G_SIGNAL_RUN_FIRST,
                      G_STRUCT_OFFSET (SignalDemoClass, default_handler),
                      NULL,
                      NULL,
                      g_cclosure_marshal_VOID__STRING,
                      G_TYPE_NONE,
                      1, 
                      G_TYPE_STRING);
 

說明：

• 第 1 個引數是字串“hello”，它表示訊號。
• 第 2 個引數是 SignalDemo 類的型別 ID，可以使用 G_TYPE_FROM_CLASS 巨集從 SignalDemoClass 結構體中獲取，也可直接使用 signal-demo.h 中定義的巨集 SIGNAL_TYPE_DEMO。
• 第 3 個引數可暫時略過。
• 第 4 個引數比較關鍵，它是一個記憶體偏移量，主要用於從 SignalDemoClass 結構體中找到 default_handler 指標的位置，可以使用 G_STRUCT_OFFSET 巨集來獲取，也可以直接根據 signal-demo.h 中的 SignalDemoClass 結構體的定義，使用 sizeof (GObjectClass) 來得到記憶體偏移量，因為 default_handler 指標之前只有一個 GObjectClass 結構體成員。
• 第 5 個和第 6 個引數暫時略過。
• 第 7 個引數設定閉包的  marshal。在文件“函式指標、回撥函式與 GObject 閉包” 中，描述了 GObject 的閉包的概念與結構，我們可以將它視為回撥函式 + 上下文環境而構成的一種資料結構，或者再簡單一點，將其視為回撥函式。另外，在那篇文件中，我們也對 marshal 的概念進行了一些粗淺的解釋。事實上 marshal 主要是用來“翻譯”閉包的引數和返回值型別的，它將翻譯的結果傳遞給閉包。之所以不直接呼叫閉包，而是在其外加了一層 marshal 的包裝，主要是方便 GObject 庫與其他語言的繫結。例如，我們可以寫一個 pyg_closure_marshal_VOID__STRING 函式，其中可以呼叫 python 語言編寫的“閉包”並將其計算結果傳遞給 GValue 容器，然後再從 GValue 容器中提取計算結果。
• 第 8 個引數指定 marshal 函式的返回值型別。由於本例的第 7 個引數所指定的 marshal 是 g_cclosure_marshal_VOID__STRING 函式的返回值是 void，而 void 型別在 GObject 庫的型別管理系統是 G_TYPE_NONE 型別。
• 第 9 個引數指定 g_signal_new 函式向 marshal 函式傳遞的引數個數，由於本例使用的 marshal 函式是 g_cclosure_marshal_VOID__STRING 函式，g_signal_new 函式只向其傳遞 1 個引數。
• 第 10 個引數是可變引數，其數量由第 8 個引數決定，用於指定 g_signal_new 函式向 marshal 函式傳遞的引數型別。由於本例使用的 marshal 函式是 g_cclosure_marshal_VOID__STRING 函式，並且 g_signal_new 函式只向其傳遞一個引數，所以傳入的引數型別為 G_TYPE_STRING（GObject 庫型別管理系統中的字串型別）。

GObject 訊號機制——訊號註冊

上一篇文件“GObject 的訊號機制”只是挖了一個坑便結束了，本篇嘗試填坑，不過也不敢有所保證。因為我也不確定會不會因為被 GObject 的訊號內幕再次搞暈。

我們先老老實實的閱讀 GObject 參考手冊的“Concepts / Signal”部分，儘量多獲得一些面上的認識。手冊中最關鍵的一句話是：每一個訊號在註冊的時候都要與某種資料型別（包括 GObject 庫中的內建型別或 GObject 子類型別）存在關聯，這種資料型別的使用者需要實現訊號與閉包的連線，這樣在訊號被髮射時，閉包會被呼叫。這句話，意味著我們要使用 GObject 訊號機制，那麼就必須要完成兩個步驟：第一個步驟是訊號註冊，主要解決訊號與資料型別的關聯問題；第二個步驟是訊號連線，主要處理訊號與閉包的連線問題。本文主要考察訊號註冊的大致過程。

訊號可以與 GObject 庫的型別管理機制中“可例項化”的資料型別進行關聯，但是 GObject 參考手冊建議我們最好是隻在 GObject 子類型別中使用訊號，因為訊號跟類/物件在邏輯上比較相符。

有 三個函式可以實現訊號註冊，即 g_signal_newv、g_signal_new_valist 以及 g_signal_new，其中 g_signal_new_valist 與 g_signal_new 函式皆基於 g_signal_newv 函式實現，但是 g_signal_new 函式的名字看上去最平易近人。我們不理睬它們內部是如何實現的，只需要理解它們所接受的引數的含義即可。所以，我們可以從分析 g_signal_new 函式的引數來理解有關訊號註冊的一些概念。

g_signal_new 函式的宣告如下：

g_signal_new 函式的引數較多，其中每個引數多少都有點深不可測的背景，所以直接理解是非常困難的。我們需要構建例項，從而獲得最直觀的理解。

首先，我們定義一個 GObject 的子類——SignalDemo 類，其標頭檔案 signal-demo.h 內容如下：

SignalDemo 類的原始檔 signal-demo.c 內容如下：

基於此前所寫的 GObject 學習筆記系列，上述程式碼不難理解，無非就是定義了一個 SignalDemo 類，其類結構體中包含了一個函式指標 default_handler，並在類結構體初始化函式中使該指標指向函式 signal_demo_default_handler。

下面我們開始為 SignalDemo 類註冊一個“hello”訊號，只需修改一下 SignalDemo 類的類結構體初始化函式，即：

此時，觀察一下 g_signal_new 函式的引數：

• 第 1 個引數是字串“hello”，它表示訊號。
• 第 2 個引數是 SignalDemo 類的型別 ID，可以使用 G_TYPE_FROM_CLASS 巨集從 SignalDemoClass 結構體中獲取，也可直接使用 signal-demo.h 中定義的巨集 SIGNAL_TYPE_DEMO。
• 第 3 個引數可暫時略過。
• 第 4 個引數比較關鍵，它是一個記憶體偏移量，主要用於從 SignalDemoClass 結構體中找到 default_handler 指標的位置，可以使用 G_STRUCT_OFFSET 巨集來獲取，也可以直接根據 signal-demo.h 中的 SignalDemoClass 結構體的定義，使用 sizeof (GObjectClass) 來得到記憶體偏移量，因為 default_handler 指標之前只有一個 GObjectClass 結構體成員。
• 第 5 個和第 6 個引數暫時略過。
• 第 7 個引數設定閉包的  marshal。在文件“函式指標、回撥函式與 GObject 閉包” 中，描述了 GObject 的閉包的概念與結構，我們可以將它視為回撥函式 + 上下文環境而構成的一種資料結構，或者再簡單一點，將其視為回撥函式。另外，在那篇文件中，我們也對 marshal 的概念進行了一些粗淺的解釋。事實上 marshal 主要是用來“翻譯”閉包的引數和返回值型別的，它將翻譯的結果傳遞給閉包。之所以不直接呼叫閉包，而是在其外加了一層 marshal 的包裝，主要是方便 GObject 庫與其他語言的繫結。例如，我們可以寫一個 pyg_closure_marshal_VOID__STRING 函式，其中可以呼叫 python 語言編寫的“閉包”並將其計算結果傳遞給 GValue 容器，然後再從 GValue 容器中提取計算結果。
• 第 8 個引數指定 marshal 函式的返回值型別。由於本例的第 7 個引數所指定的 marshal 是 g_cclosure_marshal_VOID__STRING 函式的返回值是 void，而 void 型別在 GObject 庫的型別管理系統是 G_TYPE_NONE 型別。
• 第 9 個引數指定 g_signal_new 函式向 marshal 函式傳遞的引數個數，由於本例使用的 marshal 函式是 g_cclosure_marshal_VOID__STRING 函式，g_signal_new 函式只向其傳遞 1 個引數。
• 第 10 個引數是可變引數，其數量由第 8 個引數決定，用於指定 g_signal_new 函式向 marshal 函式傳遞的引數型別。由於本例使用的 marshal 函式是 g_cclosure_marshal_VOID__STRING 函式，並且 g_signal_new 函式只向其傳遞一個引數，所以傳入的引數型別為 G_TYPE_STRING（GObject 庫型別管理系統中的字串型別）。

注意，在上述的 g_signal_new 函式的第 7 個引數的解釋中，我提到了閉包。事實上，g_signal_new 函式並沒有閉包型別的引數，但是它在內部的確是構建了一個閉包，而且是通過它的第 4 個引數實現的。因為 g_signal_new 函式在其內部呼叫了 g_signal_type_cclosure_new 函式，後者所做的工作就是從一個給定的類結構體中通過記憶體偏移地址獲得回撥函式指標，然後構建閉包返於 g_signal_new 函式。既然 g_signal_new 函式的內部是需要閉包的，那麼它的第 7～10 個引數自然都是為那個閉包做準備的。

需要注意，g_cclosure_marshal_VOID__STRING 所約定的回撥函式型別為：

這表明 g_cclosure_marshal_VOID__STRING 需要使用者向其回撥函式傳入 3 個引數，其中前兩個引數是回撥函式的必要引數，而第 3 個引數，即 userdata，是為使用者留的“後門”，使用者可以通過這個引數傳入自己所需要的任意資料。由於 GObject 閉包約定了回撥函式的第 1 個引數必須是物件本身，所以 g_cclosure_marshal_VOID__STRING 函式實際上要求使用者向其傳入 2 個引數，但是在本例中 g_signal_new 只向其傳遞了 1 個型別為 G_TYPE_STRING 型別的引數，這有些蹊蹺。

這 是因為 g_signal_new 函式所構建閉包只是讓訊號所關聯的資料型別能夠有一次可以自我表現的機會，即可以在訊號被觸發的時候，能夠自動呼叫該資料型別的某個方法，例如 SignalDemo 類結構體的 default_handler 指標所指向的函式。也就是說，SignalDemo 類自身是沒有必要向閉包傳遞那個“userdata”引數的，只是訊號的使用者有這種需求。這就是 g_signal_new 的引數中只表明它向閉包傳遞了 1 個 G_TYPE_STRING 型別引數的緣故。

上面講的有些凌亂。現在總結一下：g_signal_new 函式內部所構建的閉包，它在被呼叫的時候，肯定是被傳入了 3 個引數，它們被訊號所關聯的閉包分成了以下層次：

• 第 1 個引數是訊號的預設閉包（訊號註冊階段出現）和訊號使用者提供的閉包（訊號連線階段出現）所必需的，但是這個引數是隱式存在的，由 g_signal_new 暗自向閉包傳遞。
• 第 2 個引數是顯式的，同時也是訊號的預設閉包和訊號使用者提供的閉包所必須的，這個引數由訊號的發射函式（例如 g_signal_emit_by_name）向閉包傳遞。
• 第 3 個引數也是顯式的，且只被訊號使用者提供的閉包所關注，這個引數由訊號的連線函式（例如 g_signal_connect）向閉包傳遞。

若要真正明白上述內容，我們必須去構建 SignalDemo 類的使用者，即 main.c 原始檔，內容如下：

編譯 signal-demo.c 與 main.c：

程式執行結果如下：

結合程式的執行結果，再回顧一下第 1 個例項中的那些亂七八糟的內容，現在應該清晰了許多。

現在，我們再來看一下在第 1 個例項中被我們忽略的 g_signal_new 函式的第  3 個引數，我們將其設為 G_SIGNAL_RUN_FIRST。實際上，這個引數是列舉型別，是訊號預設閉包的呼叫階段的標識，可以是下面 7 種形式中 1 種，也可以是多種組合。

這個引數被設為 G_SIGNAL_RUN_FIRST，表示訊號的預設閉包要先於訊號使用者的閉包被呼叫，這個觀察一下上面的 test 程式的輸出結果便可知悉。如果我們將這個引數設為 G_SIGNAL_RUN_LAST，則表示訊號的預設閉包要遲於訊號使用者的閉包而被呼叫。對於這個引數的理解暫且到此為止，後面在講述訊號連線的時候 還會再次談到它。

小結

現在，對訊號註冊的主要過程已有所瞭解，但是依 g_signal_new 函式的第 5 個與第 6 個引數，對於它們，我現在還不知道如何為其構建例項，以後再說吧。若你讀到此處並且知道它們的用法，還望不吝賜教。