| .gitignore | ||
| arc-and-mutex.md | ||
| atomics.md | ||
| casts.md | ||
| checked-uninit.md | ||
| coercions.md | ||
| concurrency.md | ||
| constructors.md | ||
| conversions.md | ||
| data.md | ||
| destructors.md | ||
| dot-operator.md | ||
| drop-flags.md | ||
| exception-safety.md | ||
| exotic-sizes.md | ||
| hrtb.md | ||
| leaking.md | ||
| lifetime-elision.md | ||
| lifetime-misc.md | ||
| lifetime-mismatch.md | ||
| lifetimes.md | ||
| meet-safe-and-unsafe.md | ||
| other-reprs.md | ||
| ownership.md | ||
| poisoning.md | ||
| races.md | ||
| raii.md | ||
| README.md | ||
| references.md | ||
| repr-rust.md | ||
| safe-unsafe-meaning.md | ||
| send-and-sync.md | ||
| subtyping.md | ||
| SUMMARY.md | ||
| transmutes.md | ||
| unbounded-lifetimes.md | ||
| unchecked-uninit.md | ||
| uninitialized.md | ||
| unwinding.md | ||
| vec-alloc.md | ||
| vec-dealloc.md | ||
| vec-deref.md | ||
| vec-drain.md | ||
| vec-final.md | ||
| vec-insert-remove.md | ||
| vec-into-iter.md | ||
| vec-layout.md | ||
| vec-push-pop.md | ||
| vec.md | ||
| working-with-unsafe.md | ||
% The Advanced Rust Programming Language
NOTE: This is a draft document, and may contain serious errors
So you've played around with Rust a bit. You've written a few simple programs and
you think you grok the basics. Maybe you've even read through
The Rust Programming Language. Now you want to get neck-deep in all the
nitty-gritty details of the language. You want to know those weird corner-cases.
You want to know what the heck unsafe really means, and how to properly use it.
This is the book for you.
To be clear, this book goes into serious detail. We're going to dig into exception-safety and pointer aliasing. We're going to talk about memory models. We're even going to do some type-theory. This is stuff that you absolutely don't need to know to write fast and safe Rust programs. You could probably close this book right now and still have a productive and happy career in Rust.
However if you intend to write unsafe code -- or just really want to dig into the guts of the language -- this book contains invaluable information.
Unlike The Rust Programming Language we will be assuming considerable prior knowledge. In particular, you should be comfortable with:
-
Basic Systems Programming:
- Pointers
- The stack and heap
- The memory hierarchy (caches)
- Threads
Due to the nature of advanced Rust programming, we will be spending a lot of time talking about safety and guarantees. In particular, a significant portion of the book will be dedicated to correctly writing and understanding Unsafe Rust.