rust-lang/book

This repository contains the source files for "The Rust Programming Language," the official introductory book for the Rust programming language. Rust is a systems programming language, used for writing fast, low-level software like operating systems, game engines, and embedded firmware, that is designed to prevent certain classes of bugs (particularly memory-related crashes) at compile time rather than at runtime. The book is the canonical learning resource for Rust, written and maintained by the Rust language team. It covers the core concepts you need to work with the language: ownership (Rust's distinctive approach to managing memory without a garbage collector), borrowing and lifetimes, structs, enums, error handling, traits (similar to interfaces in other languages), generics, closures, iterators, and more. It also walks through building real example programs to apply the concepts in context. The book is available to read for free online at doc.rust-lang.org, and is also sold in print form. This repository holds the raw source written in Markdown, if you want to read it, you do not need to clone and build it yourself; just visit the online version. The source is built into a browsable web book using a tool called mdBook. You would come here if you are learning Rust for the first time and want the structured, authoritative introduction, or if you want to contribute corrections and improvements to the text. The repository is also useful if you want to build a local version of the book to read offline.