Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Lacking documentation on thin vs fat/wide pointers

Aperta Adatta ai principianti
#164,818 0 commenti 1 reazione 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
64/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
rust
Ambito
documentation

Direzione di ricerca

Leggi la documentazione di std::ptr::addr_eq, std::ptr::from_raw_parts e *const T::is_null, insieme alla documentazione esistente sui puntatori di with_metadata_of. Decidi dove definire in modo centralizzato i puntatori sottili e larghi e rendi coerente la terminologia in questi riferimenti. Il lavoro è completato quando i termini sono definiti chiaramente e le API citate li usano in modo coerente.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

A-docs T-libs T-opsem
Location (URL)

https://doc.rust-lang.org/std/ptr/fn.addr_eq.html
https://doc.rust-lang.org/std/ptr/fn.from_raw_parts.html

Summary

We should document centrally the distinction between thin and fat pointers. The currently the terms are only defined in documentation of experimental APIs, and the existence of fat pointers seems to be mostly ignored in the documentation (e.g. #163372).

std::ptr::addr_eq uses the word fat pointer without defining it. The experimental std::ptr::from_raw_parts inconsistently uses "wide pointer". <*const T>::is_null works around mentioning fat pointers by talking about unsized types.

Came up in #163372.

Lingua principale
Rust
Stelle
121k
Fork
18k
Merge medio
2g 23h
PR unite (30g)
513

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di rust-lang/rust

Tutte le issue di rust-lang/rust

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.