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

CKTIS / Java

Map.size() — Nombre d’entrées d’une map

`Map.size()` renvoie le nombre actuel d’associations clé-valeur sous forme d’`int`. Remplacer la valeur d’une clé existante ne change pas la taille.

Version : Java SE 21

Syntaxe

int size()

size() est une méthode d’instance sans argument de l’interface java.util.Map. L’appel map.size() renvoie le nombre d’associations clé-valeur sous forme d’int : 0 si la map est vide et Integer.MAX_VALUE si le nombre d’associations dépasse ce qu’un int peut représenter. Pour savoir seulement si la map est vide, utilise map.isEmpty().

Chaque clé présente compte pour une entrée. Deux clés ayant la même valeur comptent pour deux entrées. Une entrée de valeur null compte aussi si la map autorise les valeurs nulles. Si put ne fait que remplacer la valeur d’une clé existante, aucune entrée n’est ajoutée. Ajouter une nouvelle clé n’augmente pas toujours le nombre d’entrées : une LinkedHashMap dotée d’une règle d’éviction peut supprimer son entrée la plus ancienne lors du même appel à put, sans changer le résultat de size(). La taille n’est pas la capacité : dans une HashMap, la capacité désigne le nombre de compartiments de hachage, pas le nombre d’entrées.

Dans une HashMap que rien d’autre ne modifie, map.size() < limit vérifie qu’on peut ajouter une entrée pour une nouvelle clé sans dépasser la limite. Une WeakHashMap peut perdre des entrées sans suppression explicite lorsque le ramasse-miettes récupère les clés référencées faiblement. Lors de mises à jour concurrentes d’une ConcurrentHashMap, le résultat peut refléter un état transitoire : vérifier la taille puis appeler put ne fait pas respecter la limite de façon atomique.

Exemples

import java.util.HashMap;
import java.util.Map;

public class Main {
    public static void main(String[] args) {
        Map<Integer, String> map = new HashMap<>();
        System.out.println(map.size());

        map.put(10, "A");
        map.put(20, "A");
        map.put(30, "B");
        System.out.println(map.size());

        map.put(30, null);
        System.out.println(map.size());

        map.put(40, "C");
        int limit = 5;
        System.out.println(map.size());
        boolean hasRoom = map.size() < limit;
        System.out.println(hasRoom);
        if (hasRoom) {
            map.put(95, "D");
        }
        System.out.println(map.size());
    }
}

Résultat

0
3
3
4
true
5

La map vide a une taille de `0`. Les clés `10` et `20` ont la même valeur, mais chacune compte séparément, tout comme la clé `30`. Remplacer la valeur de `30` par `null` laisse trois entrées. Avant d’ajouter la clé `95`, la taille vaut `4` : la comparaison avec la limite `5` donne `true` et l’ajout porte la taille à `5`.

Leçons associées

  • Java · Leçon 17 · Avancé · Version : 2
  • Java · Leçon 18 · Avancé · Version : 2
  • Java · Leçon 20 · Avancé · Version : 2
  • Java · Leçon 42 · Débutant · Version : 2
  • Java · Leçon 40 · Intermédiaire · Version : 2

Sources