swiftlang/swift

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

Open

#46,337 opened on 2017年1月26日

GitHub で見る
 (1 comment) (0 reactions) (0 assignees)Swift (69,989 stars) (10,719 forks)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
Issue 種別
refactor
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
2
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
1-3 hours
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
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.