pointdexter 1.0.0-rc1

unifies *const/*mut pointers using the trait system
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

Creates a new `NonNullPointer` if `ptr` is in fact not null.

# Original

[`NonNull::new`]

# API Differences

This returns a `Result`, not an `Option`, where the `Err` variant has a useful
default message.

# Panics During `const` Evaluation

This method will panic during const evaluation if the pointer cannot be
determined to be null or not. See [`is_null`] for more information.

# Examples

```rust
use pointdexter::prelude::*;

let mut x = 0u32;
let ptr = NonNullPointer::new((&mut x).into()).unwrap();

let Err(_) = NonNullPointer::<u32, Unique>::new(ptxr::null()) else {
  unreachable!()
};
```

[`is_null`]: Pointer::is_null