swiftlang/swift

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

Open

#46.337 aperta il 26 gen 2017

Vedi su GitHub
 (1 commento) (0 reazioni) (0 assegnatari)Swift (10.719 fork)batch import
affects ABIgood first issueimprovementstandard libraryswift evolution proposal needed

Metriche repository

Star
 (69.989 star)
Metriche merge PR
 (Merge medio 8g 17h) (510 PR mergiate in 30 g)

Descrizione
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.

Guida contributor

Direzione di ricerca
Individua le definizioni di `startIndex`, `endIndex` e `IndexDistance` nel codice sorgente della libreria standard di Swift (probabilmente in `stdlib/public/core/Collection.swift` o simili). Aggiungi proprietà calcolate deprecate `start` e `end` per `startIndex` e `endIndex`, e un alias di tipo deprecato `Distance` per `IndexDistance`. Assicurati che il messaggio di avviso di deprecazione guidi gli utenti verso i nuovi nomi. Verifica che il codice esistente che utilizza i vecchi nomi compili con avvisi di deprecazione. Fai riferimento a deprecazioni simili passate nel progetto Swift per i modelli da seguire.
Tech stack
swift
Dominio
api
Tipo issue
Refactoring
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-3 ore
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Datata
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
SwiftGit
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
65