Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

heapq.nlargest

Sélectionne jusqu’à n éléments dans l’ordre décroissant de leur clé pour établir un classement.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

heapq.nlargest(n, iterable, key=None)

Sélectionne jusqu’à n éléments dans l’ordre décroissant de leur clé pour établir un classement.

Les ex æquo gardent leur ordre d’arrivée même à la limite de sélection. key=len classe bbb devant cc puis a et le résultat contient les chaînes elles-mêmes.

Un n non positif donne une liste vide, une limite supérieure à l’effectif retient tous les éléments.

from heapq import nlargest
scores = [("a", 2), ("b", 8), ("c", 8)]
assert nlargest(1, scores, key=lambda row: row[1]) == [("b", 8)]
assert nlargest(10, [1, 2]) == [2, 1]
assert nlargest(-1, [3]) == []

Exemples

import heapq
print(heapq.nlargest(2, ["a", "bbb", "cc"], key=len))
print(heapq.nlargest(0, [3, 5]))

Résultat

['bbb', 'cc']
[]

Un n non positif donne une liste vide, une limite supérieure à l’effectif retient tous les éléments.

Sources