Repository navigation
Tracking Issue for extending null() and null_mut() to non-Sized thin pointers #93959
Description
Feature gate: maybe none? There’s no obvious way to use #[unstable] for this kind of library change.
This is a tracking issue for extending ptr::null, ptr::null_mut, and to work with any thin pointers. This change was accepted as part of RFC 2580 Pointer Metadata.NonNull::dangling
As of Rust 1.58:
- These functions can only return pointer to
T: Sizedtypes. (This bound is implied by the lack ofT: ?Sizedpseudo-bound in their respective signature.) externtypes are the only kind of types that are notSizedbut pointers to them are still “thin”. (As opposed to pointers to slices or trait objects, that are “wide” and store a length or a vtable pointer as pointer metadata.)
So this description could be rephrased as extending ptr::null, ptr::null_mut, and to NonNull::danglingextern types. However future language proposals could potentially add new kinds of !Sized types whose pointers are thin. This change should then apply to such types too.
Motivation
These functions deliberately do not support slices or trait objects. What length or vtable would be used in the new pointers? More generally, their implementation is only obvious for thin pointers. That is, when pointer metadata is zero-size, such as for Sized types.
However extern types add an intermediate kind of type that is !Sized but still still has thin pointers. The new Pointee trait from the Pointer Metadata RFC allows expressing more precise bounds within the trait system. That same RFC proposed the change tracked here and was accepted, but that change is not implemented yet so it remains an open question for extern types.
Public API
These existing stable APIs of core::ptr / std::ptr:
pub const fn null<T>() -> *const T {…}
pub const fn null_mut<T>() -> *mut T {…}Should be changed to
pub const fn null<T: ?Sized + Thin>() -> *const T {…}
pub const fn null_mut<T: ?Sized + Thin>() -> *mut T {…}… where Thin is an existing trait alias:
pub trait Thin = Pointee<Metadata = ()>;
pub trait Pointee {
type Metadata: Copy + Send + Sync + Ord + Hash + Unpin;
}In 1.58, Pointee and Thin are both unstable and tracked at #81513. Pointee is automatically implemented for all types. For Sized and extern types, Metadata is (). So Sized implies Thin.
Because Sized implies Thin, this proposed change to the signatures of stable functions should be backward-compatible.
Having an unstable trait involved in a bound of a stable function is unusual but not unprecedented. (For example Pattern in str::find.)
Steps / History
- Implementation: #...
- Final comment period (FCP)
- Stabilization PR (?)
Implementation strategy and related language change
null, null_mut, and dangling are implemented by converting an integer (zero or align_of()) to a raw pointer with the as operator. In Rust 1.58, as only allows such a conversion if the target type is a pointer to a Sized type. The obvious way to implement this proposed extension of null and friends would be to make the same extension to as. However this change in language semantics is not part of an accepted RFC. It should be approved by the language team, perhaps with its own RFC.
To summarize, the proposed language change is:
Cast expressionsinteger as *const Tandinteger as *mut Twould change from being legal only ifT: Sized, to being legal only ifT: ?Sized + Thin.
Update: ptr::from_raw_parts could be used instead of as.
Unresolved Questions
Is the language change to theasoperator described above desirable?Should it separately go through the RFC process?
Activity
SimonSapin commentedon Feb 13, 2022
As @scottmcm pointed out on Zulip, instead of of extending
asthe implementation ofnullcould look like this:ptr::from_raw_parts(0 as *const ()). So I’m withdrawing the language change proposal. (I someone else wants to propose the same elsewhere, feel free.)SimonSapin commentedon Feb 13, 2022
In terms of its own signature
NonNull::danglingseems like it could be extended to all thin pointers, but in terms of its behavior it relies ofalign_of. What shouldalign_of(oralign_of_val_raw) be for extern types? Let’s… not get into that here. So not touchingdanglingand only extendingnullandnull_mut.[-]Tracking Issue for extending null, null_mut, dangling to non-Sized thin pointers[/-][+]Tracking Issue for extending null, null_mut, ~dangling~ to non-Sized thin pointers[/+][-]Tracking Issue for extending null, null_mut, ~dangling~ to non-Sized thin pointers[/-][+]Tracking Issue for extending null() and null_mut() to non-Sized thin pointers[/+]SimonSapin commentedon Feb 13, 2022
We know that, but the compiler doesn’t (yet)
… so this wrong. I in
coreitself I get only one error, but it likely affects every user ofnullornull_mutin a generic context whereT: Sizedholds butT: Thindoesn’t without an explicit bound:I tried encoding the desired implication with this:
But this caused many errors like:
I think this is because
Defaultis defined as:So
impl Default for Cell<T>requiresCell<T>: Thin.Since #81172, when asked specifically for
<Cell<T> as Pointee>::Metadatathe compile knows to resolve it to(). But trait resolution doesn’t seem to be aware of the "equality".Kixunil commentedon Feb 14, 2022
I don't see a problem with defining
Sized: Thinsince the trait is implemented by the compiler anyway. Is there any obstacle I don't see?SimonSapin commentedon Feb 14, 2022
The obstacle is that things break when I do it, as described in my previous comment. It looks like #93977 might fix that.
Rollup merge of rust-lang#93977 - compiler-errors:sized-generic-metad…
Extend ptr::null and null_mut to all thin (including extern) types
madsmtm commentedon May 26, 2022
Thanks for doing this @SimonSapin!
Extend ptr::null and null_mut to all thin (including extern) types
Auto merge of #94954 - SimonSapin:null-thin3, r=yaahc