Undocumented method for "slice" class

Documentation

The "slice" class has a method "indices" that, when given a length of a sequence, will return a tuple with (start, stop, step) that is adjusted for the length of that sequence. This method is completely undocumented

For example,

x=slice(0, 10, -2)
x.indices(5) #This returns (0, 4, -2)
x.indices(10) #This returns (0, 9, -2)
x.indices(100) #This returns (0, 9, -2)

The only example that I could find in any official Python documents is this, there is a single reference to this method at the bottom of the page. However, as of the lastest version of Python, which is 3.11.0 at the time of writing, using this method in a standard installation of CPython still works.

• PR: gh-99129

Commencez par la page de documentation Python de la classe slice liée dans l’issue et examinez la manière dont ses méthodes sont documentées. Ajoutez la documentation de slice.indices(), notamment son argument length, le tuple renvoyé et des exemples de comportement ; le travail est terminé lorsque la méthode est décrite à côté de la classe et que les exemples sont corrects.