swiftlang/swift

[SR-3752] Remove redundant word "Index" from Collection properties/typealiases

Open

#46,337 建立於 2017年1月26日

在 GitHub 查看
 (1 留言) (0 反應) (0 負責人)Swift (69,989 star) (10,719 fork)batch import
affects ABIgood first issueimprovementstandard libraryswift evolution proposal needed

描述
Previous ID SR-3752
Radar rdar://problem/29976316
Original Reporter @airspeedswift
Type Improvement
Votes 0
Component/s Standard Library
Labels Improvement, AffectsABI, StarterProposal
Assignee None
Priority Medium

md5: 0c809e36d2916cefa628bdb99c61a0e8

Issue Description:

The two properties "startIndex" and "endIndex", and the typealias IndexDistance should have the word "Index" removed, in order to reduce clutter. The meaning is clear without it.

For source compatibility reasons, deprecated computed properties or a typealias should be provided.

貢獻者指南

技術棧
swift
領域
developer experience
議題類型
refactor
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
2
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-3 hours
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
stale
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
clear
前置要求
Swift programming languageDeprecation attribute usage
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
80
研究方向
Locate the definitions of `startIndex`, `endIndex`, and `IndexDistance` in the Swift standard library source code (likely in `stdlib/public/core/Collection.swift` or similar). Add deprecated computed properties `start` and `end` for `startIndex` and `endIndex`, and a deprecated typealias `Distance` for `IndexDistance`. Ensure the deprecation warning message guides users to the new names. Test that existing code using the old names compiles with deprecation warnings. Refer to similar past deprecations in the Swift project for patterns.