Swift API 設計思考題

沒故事的卓同學發表於2018-08-21
SwiftAPI

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

  1. 說明下面兩個方法為什麼第一個宣告瞭引數標籤 at，第二個方法預設了。
extension List {
  public mutating func remove(at position: Index) -> Element
  public mutating func remove(_ member: Element) -> Element?
}
複製程式碼
  1. 下面兩種宣告方式哪一個是正確的，說明原因。
func add(_ observer: NSObject, for keyPath: String)
func addObserver(_ observer: NSObject, forKeyPath path: String)
複製程式碼
  1. 下面哪一種宣告方式更好，說明原因。
x.subViews(havingColor: y)
x.subViews(color: y)
複製程式碼
  1. 下面哪一種宣告方式更好，說明原因。
let foreground = Color(red: 32, green: 64, blue: 128)
let foreground = Color(havingRGBValuesRed: 32, green: 64, andBlue: 128)
複製程式碼
  1. 下面兩個方法有什麼區別？
x.sort()
x.sorted()
複製程式碼
  1. Protocol 有什麼命名規則？
  2. 什麼情況可以宣告全域性函式？
  3. 下面宣告的方法預設了第一個引數標籤有什麼原因？
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 { ... }
}
複製程式碼
  1. 下面這樣宣告會帶來什麼問題？
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? { ... }
}
複製程式碼
  1. 下面的引數名稱哪一個比較好？
func filter(_ predicate: (Element) -> Bool) -> [Generator.Element]
func filter(_ includedInResult: (Element) -> Bool) -> [Generator.Element]
複製程式碼
  1. 下面宣告錯誤的地方在哪裡？
extension String {
/// ...description...
	public func compare(_ options: CompareOptions = [], other: String, range: Range? = nil, locale: Locale? = nil
	) -> Ordering
}
複製程式碼
  1. 下面的函式為什麼不需要宣告引數標籤？
min(number1, number2)
zip(sequence1, sequence2)
複製程式碼
  1. 下面兩個初始化方法為什麼一個有引數標籤，一個沒有？
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) 
}
複製程式碼
  1. 下面兩個方法的宣告哪一個比較好？
// a 移動到某個點上
a.move(toX: b, y: c)
a.moveTo(x: b, y: c)
複製程式碼
  1. 下面兩個方法的宣告哪一個比較好？
extension UIView {
	func addSubview(_ view: UIView)
	func add(subview: UIView)
}
複製程式碼
  1. 下面的宣告可能引發什麼問題？
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
}
複製程式碼
  1. 下面哪一個命名是正確的：
struct Model {
	var sourceURL: URL
	var sourceUrl: URL
}
複製程式碼

綜合題

  • 什麼時候方法、函式的第一個引數預設引數標籤？

相關文章