llvm/llvm-project

[llvm] Document non-trivial `llvm::DenseMapBase` member functions

Open

#166.155 geöffnet am 3. Nov. 2025

Auf GitHub ansehen
 (7 Kommentare) (0 Reaktionen) (2 zugewiesene Personen)C++ (10.782 Forks)batch import
documentationenhancementgood first issuellvm:adt

Repository-Metriken

Stars
 (26.378 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 1T 2h) (1.000 gemergte PRs in 30 T)

Beschreibung

There are (now?) some non-trivial memberfunctions in DenseMapBase that would be good to document, possibly adding a code sample.

From looking at https://llvm.org/doxygen/classllvm_1_1DenseMap.html, examples include:

  1. try_emplace
  2. insert_or_assign
  3. emplace_or_assign
  4. lookup_or
  5. operator[] - should specify what happens if the key isn't yet in the map.

Contributor Guide

Research-Richtung
Überprüfe die in der Issue aufgeführten DenseMapBase Memberfunktionen auf der Doxygen Seite und schreibe klare Dokumentation mit Codebeispielen für jede: try emplace, insert or assign, emplace or assign, lookup or und operator[].
Tech Stack
cpp
Domain
documentation
Issue Type
Dokumentation
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
1
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 Stunden
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
C++
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
80