ReactiveCocoa 中有許多看似神奇的巨集,實際上都是由一層層規則組裝而成。本文從巨集的基本概念出發,逐步拆解 ReactiveCocoa 中常見的元巨集與應用巨集。
巨集是一種在預編譯階段進行的文字替換機制。它能將 frequent 的操作序列自動化,也能建立更高層的抽象。C 語言的巨集多半是簡單替換,而更進階的巨集系統則能表達更複雜的程式碼變形。

預處理結果
在 Xcode 中,可以透過 Assistant 的 Preprocess 檢視巨集展開後的樣子。不同編譯階段可能得到不同結果,因此查看時要選擇正確的目標條件。

預編譯種類
ReactiveCocoa 定義了一組元巨集,作為後續複雜巨集的基礎。理解這些元巨集,才能看懂 weakify、strongify 等常用巨集。

元巨集
metamacro_stringify 用來把參數轉成字串。它之所以常包一層,是為了確保在巢狀巨集展開時仍能正確處理。metamacro_concat 則用來把兩個參數拼接成新的識別字,常用於動態產生巨集名稱。
metamacro_argcount 能在預編譯期取得可變參數個數。它會搭配 metamacro_at,把參數位置與一組反向排列的數字對齊,就像用一把虛擬的尺子量出參數數量。

參數個數示意
metamacro_foreach 與 metamacro_foreach_cxt 能對每個可變參數套用同一個巨集,並以指定分隔符隔開。weakify 正是利用這個特性,一次對多個變數建立弱引用。

weakify 的展開基礎
metamacro_foreach_cxt_recursive 則是遞歸版本,適用於一般展開可能失敗的情境。metamacro_foreach_concat 則會把每個參數拼接至同一個基底名稱後。
metamacro_for_cxt 會重複執行指定次數的巨集。metamacro_head 與 metamacro_tail 分別取出第一個參數與其餘參數;metamacro_take 與 metamacro_drop 則用來截取或丟棄前 N 個參數。

take 的遞歸概念

drop 的遞歸概念
metamacro_dec 與 metamacro_inc 透過位移序列完成加減一;metamacro_if_eq 則用來比較兩個數字是否相等,並據此選擇不同分支。metamacro_is_even 與 metamacro_not 則處理簡單的布林判斷。
在掌握元巨集後,就能理解 ReactiveCocoa 中常見的應用巨集。

常用巨集
這三個巨集常用來處理循環引用。weakify 會建立弱引用變數,strongify 會在需要時建立強引用,unsafeify 則建立不安全的未保留引用。使用時前面通常要加上 @ 符號,因為巨集內部包含需要 Objective-C 語法支援的結構。

strongify 的展開結果
RACTuplePack 用來把多個值打包成 RACTuple;RACTupleUnpack 則用來把 RACTuple 拆回多個變數。兩者都大量使用 foreach 巨集,並在展開時處理 nil 值與變數命名。
RACObserve 的核心,是透過 keypath 巨集取得安全的鍵路徑字串,再呼叫 rac_valuesForKeyPath。keypath 會依參數個數選擇不同展開方式,並利用短路判斷與字串處理,確保輸出的路徑正確。
RAC 用來把訊號綁定到物件屬性;RACChannelTo 則建立雙向通道,讓兩個物件屬性可以互相同步。兩者都會依參數個數決定是否帶入 nil 的預設值。
onExit 用來定義區塊結束時要執行的清理程式碼。無論是正常離開、提前返回,還是透過 goto 等方式跳出,清理區塊都會被執行。它適合用來釋放資源或解除鎖定。
巨集的本質,是把重複邏輯提前到預編譯階段完成。當這些規則被設計得夠清楚,開發者就能用更短的程式碼表達更穩定的意圖。ReactiveCocoa 的巨集之所以看似魔法,正是因為它把複雜的展開過程隱藏在簡潔的呼叫背後。
