Swift API 設計思考題

參考文檔：[譯] 官方 Swift API 設計規範

1. 說明下面兩個方法爲何第一個聲明瞭參數標籤 at，第二個方法缺省了。

extension List {
  public mutating func remove(at position: Index) -> Element
  public mutating func remove(_ member: Element) -> Element?
}
複製代碼

2. 下面兩種聲明方式哪個是正確的，說明緣由。

func add(_ observer: NSObject, for keyPath: String)
func addObserver(_ observer: NSObject, forKeyPath path: String)
複製代碼

3. 下面哪種聲明方式更好，說明緣由。

x.subViews(havingColor: y)
x.subViews(color: y)
複製代碼

4. 下面哪種聲明方式更好，說明緣由。

let foreground = Color(red: 32, green: 64, blue: 128)
let foreground = Color(havingRGBValuesRed: 32, green: 64, andBlue: 128)
複製代碼

5. 下面兩個方法有什麼區別？

x.sort()
x.sorted()
複製代碼

6. Protocol 有什麼命名規則？
7. 什麼狀況能夠聲明全局函數？
8. 下面聲明的方法缺省了第一個參數標籤有什麼緣由？

extension Shape {
  /// Returns `true` iff `other` is within the area of `self`.
  func contains(_ other: Point) -> Bool { ... }

  /// Returns `true` iff `other` is entirely within the area of `self`.
  func contains(_ other: Shape) -> Bool { ... }
}
複製代碼

9. 下面這樣聲明會帶來什麼問題？

extension Box {
  /// Returns the `Int` stored in `self`, if any, and
  /// `nil` otherwise.
  func value() -> Int? { ... }

  /// Returns the `String` stored in `self`, if any, and
  /// `nil` otherwise.
  func value() -> String? { ... }
}
複製代碼

10. 下面的參數名稱哪個比較好？

func filter(_ predicate: (Element) -> Bool) -> [Generator.Element]
func filter(_ includedInResult: (Element) -> Bool) -> [Generator.Element]
複製代碼

11. 下面聲明錯誤的地方在哪裏？

extension String {
/// ...description...
	public func compare(_ options: CompareOptions = [], other: String, range: Range? = nil, locale: Locale? = nil ) -> Ordering
}
複製代碼

12. 下面的函數爲何不須要聲明參數標籤？

min(number1, number2)
zip(sequence1, sequence2)
複製代碼

13. 下面兩個初始化方法爲何一個有參數標籤，一個沒有？

extension UInt32 {
/// Creates an instance having the specified value.
init(_ value: Int16)           
/// Creates an instance having the lowest 32 bits of source.
init(truncating source: UInt64) 
}
複製代碼

14. 下面兩個方法的聲明哪個比較好？

// a 移動到某個點上
a.move(toX: b, y: c)
a.moveTo(x: b, y: c)
複製代碼

15. 下面兩個方法的聲明哪個比較好？

extension UIView {
	func addSubview(_ view: UIView)
	func add(subview: UIView)
}
複製代碼

16. 下面的聲明可能引起什麼問題？

struct Array {
  /// Inserts `newElement` at `self.endIndex`.
  public mutating func append(_ newElement: Element)

  /// Inserts the contents of `newElements`, in order, at
  /// `self.endIndex`.
  public mutating func append(_ newElements: S)
    where S.Generator.Element == Element
}
複製代碼

17. 下面哪個命名是正確的：

struct Model {
	var sourceURL: URL
	var sourceUrl: URL
}
複製代碼

綜合題

• 何時方法、函數的第一個參數缺省參數標籤？