nodejs / nodejs/node-addon-api
Support C++20 span types
Nessuno ha ancora preso questa issue.
- Lingua principale
- C++
- Stelle
- 2.4k
- Fork
- 499
- Merge medio
- 2g 11h
- PR unite (30g)
- 2
Descrizione
node-addon-api's buffer-like types pass their backing memory as a raw pointer plus a separate length, both on the way out (Data() + a length accessor) and on the way in (the New/Copy factories). Callers must keep the two values in sync manually, with no bounds information attached to the pointer.
Once C++20 is the minimum supported standard, we should adopt std::span in both directions. These additions are ABI-compatible (existing pointer/length overloads stay), and give callers a single bounds-carrying handle that works with range-based for, <algorithm>, and <ranges>.
This can be an additive change with a C++ version guard.
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Direzione di ricerca
Inizia individuando la coppia esistente composta da Data() e dall’accessor della lunghezza, quindi le factory New e Copy che accettano input puntatore/lunghezza. Esamina come il progetto gestisce i controlli della versione di C++ e gli overload esistenti. Il lavoro è completato quando è disponibile il supporto additivo per std::span in entrambe le direzioni, mantenendo gli overload puntatore/lunghezza per la compatibilità ABI.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Stack tecnologico
- cpp, nodejs
- Ambito
- backend-api-design
- Tipo di issue
- Funzionalità
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Stato di attività
- Tranquilla
- Chiarezza
- Abbastanza chiara
- Idoneità per principianti
- 55/100