有些 API 天生就需要接受不定數量的參數,例如一次設定多個漸層色。Objective-C 透過 C 語言的變參數機制支援這種寫法,搭配 NS_REQUIRES_NIL_TERMINATION 還能在編譯期檢查是否以 nil 結尾。
宣告階段加上這個標記:
- (void)setGradientColor:(UIColor *)beginColor
transitionColor:(UIColor *)transitionColor, ...
NS_REQUIRES_NIL_TERMINATION;
// NS_REQUIRES_NIL_TERMINATION 的作用是在編譯期檢查呼叫時是否以 nil 結尾,漏寫會直接產生警告。
實作時透過 va_list 系列巨集逐一取出參數:
- (void)setGradientColor:(UIColor *)beginColor transitionColor:(UIColor *)transitionColor, ... {
[self.gradientColors addObject:(id)beginColor.CGColor];
// 定義一個指向可選參數列表的指標
va_list args;
// 取得第一個可選參數的地址,
// 此時參數列表指標指向函式參數列表中的第一個可選參數
va_start(args, transitionColor);
if (transitionColor) {
[self.gradientColors addObject:(id)transitionColor.CGColor];
// 遍歷參數列表,並讓指標移動到下一個參數
UIColor *nextArg;
while ((nextArg = va_arg(args, UIColor *))) {
[self.gradientColors addObject:(id)nextArg.CGColor];
}
}
// 結束可變參數的取得,清空參數列表
va_end(args);
}
呼叫方式:
[drawCircleView setGradientColor:[UIColor purpleColor]
transitionColor:[UIColor redColor],
[UIColor blueColor], nil];
三個重點值得牢記:va_start 的第二個參數必須是列表中「最後一個具名參數」,va_arg 的型別要與實際傳入一致,而 va_end 一定要呼叫,否則在某些平台上會造成堆疊狀態錯亂。另外,這種寫法完全沒有型別檢查,呼叫方傳錯型別只會在執行期崩潰,因此僅適合用在參數同質性高的場景。