Rust manual memory management
It's very unusual to directly access the memory allocator in Rust. You generally want to use the smart pointer constructors (Box::new
, Rc::new
, Arc::new
) for single objects and just use Vec
or Box<[T]>
if you want a heap-based array.
If you really want to allocate memory and get a raw pointer to it, you can look at the implementation of Rc
. (Not Box
. Box
is magical.) To get its backing memory, it actually creates a Box
and then uses its into_raw_non_null
function to get the raw pointer out. For destroying, it uses the allocator API, but could alternatively use Box::from_raw
and then drop
that.
Although it's really not recommended to do this ever, you can use malloc
and free
like you are used to from C. It's not very useful, but here's how it looks:
extern crate libc; // 0.2.65
use std::mem;
fn main() {
unsafe {
let my_num: *mut i32 = libc::malloc(mem::size_of::<i32>() as libc::size_t) as *mut i32;
if my_num.is_null() {
panic!("failed to allocate memory");
}
libc::free(my_num as *mut libc::c_void);
}
}
A better approach is to use Rust's standard library:
use std::alloc::{alloc, dealloc, Layout};
fn main() {
unsafe {
let layout = Layout::new::<u16>();
let ptr = alloc(layout);
*(ptr as *mut u16) = 42;
assert_eq!(*(ptr as *mut u16), 42);
dealloc(ptr, layout);
}
}
Are the
Heap
structure and theptr
module (marked with experimental) the ones to look at for this kind of thing?
No, as a beginner you absolutely shouldn't start there. When you started learning C, malloc
was all there was, and it's still a hugely error-prone part of the language - but you can't write any non-trivial program without it. It's very important for C programmers to learn about malloc
and how to avoid all the pitfalls (memory leaks, use-after-free, and so on).
In modern C++, people are taught to use smart pointers to manage memory, instead of using delete
by hand, but you still need to call new
to allocate the memory for your smart pointer to manage. It's a lot better, but there's still some risk there. And still, as a C++ programmer, you need to learn how new
and delete
work, in order to use the smart pointers correctly.
Rust aims to be much safer than C or C++. Its smart pointers encapsulate all the details of how memory is handled at low-level. You only need to know how to allocate and deallocate raw memory if you're implementing a smart pointer yourself. Because of the way ownership is managed, you actually need to know a lot more details of the language to be able to write correct code. It can't be lesson one or two like it is in C or C++: it's a very advanced topic, and one many Rust programmers never need to learn about.
If you want to learn about how to allocate memory on the heap, the Box
class is the place to start with that. In the Rust book, the chapter about smart pointers is the chapter about memory allocation.