]> git.proxmox.com Git - rustc.git/blame - src/doc/book/2018-edition/src/SUMMARY.md
bump version to 1.80.1+dfsg1-1~bpo12+pve1
[rustc.git] / src / doc / book / 2018-edition / src / SUMMARY.md
CommitLineData
83c7162d
XL
1# The Rust Programming Language
2
3[Foreword](foreword.md)
4[Introduction](ch00-00-introduction.md)
5
6## Getting started
7
8- [Getting Started](ch01-00-getting-started.md)
9 - [Installation](ch01-01-installation.md)
10 - [Hello, World!](ch01-02-hello-world.md)
11 - [Hello, Cargo!](ch01-03-hello-cargo.md)
12
13- [Programming a Guessing Game](ch02-00-guessing-game-tutorial.md)
14
15- [Common Programming Concepts](ch03-00-common-programming-concepts.md)
16 - [Variables and Mutability](ch03-01-variables-and-mutability.md)
17 - [Data Types](ch03-02-data-types.md)
18 - [How Functions Work](ch03-03-how-functions-work.md)
19 - [Comments](ch03-04-comments.md)
20 - [Control Flow](ch03-05-control-flow.md)
21
22- [Understanding Ownership](ch04-00-understanding-ownership.md)
23 - [What is Ownership?](ch04-01-what-is-ownership.md)
24 - [References & Borrowing](ch04-02-references-and-borrowing.md)
25 - [Slices](ch04-03-slices.md)
26
27- [Using Structs to Structure Related Data](ch05-00-structs.md)
28 - [Defining and Instantiating Structs](ch05-01-defining-structs.md)
29 - [An Example Program Using Structs](ch05-02-example-structs.md)
30 - [Method Syntax](ch05-03-method-syntax.md)
31
32- [Enums and Pattern Matching](ch06-00-enums.md)
33 - [Defining an Enum](ch06-01-defining-an-enum.md)
34 - [The `match` Control Flow Operator](ch06-02-match.md)
35 - [Concise Control Flow with `if let`](ch06-03-if-let.md)
36
37## Basic Rust Literacy
38
0bf4aa26
XL
39- [Packages, Crates, and Modules](ch07-00-packages-crates-and-modules.md)
40 - [Packages and crates for making libraries and executables](ch07-01-packages-and-crates-for-making-libraries-and-executables.md)
41 - [Modules and `use` to control scope and privacy](ch07-02-modules-and-use-to-control-scope-and-privacy.md)
83c7162d
XL
42
43- [Common Collections](ch08-00-common-collections.md)
44 - [Vectors](ch08-01-vectors.md)
45 - [Strings](ch08-02-strings.md)
46 - [Hash Maps](ch08-03-hash-maps.md)
47
48- [Error Handling](ch09-00-error-handling.md)
49 - [Unrecoverable Errors with `panic!`](ch09-01-unrecoverable-errors-with-panic.md)
50 - [Recoverable Errors with `Result`](ch09-02-recoverable-errors-with-result.md)
3c0e092e 51 - [To `panic!` or Not to `panic!`](ch09-03-to-panic-or-not-to-panic.md)
83c7162d
XL
52
53- [Generic Types, Traits, and Lifetimes](ch10-00-generics.md)
54 - [Generic Data Types](ch10-01-syntax.md)
55 - [Traits: Defining Shared Behavior](ch10-02-traits.md)
56 - [Validating References with Lifetimes](ch10-03-lifetime-syntax.md)
57
58- [Testing](ch11-00-testing.md)
59 - [Writing tests](ch11-01-writing-tests.md)
60 - [Running tests](ch11-02-running-tests.md)
61 - [Test Organization](ch11-03-test-organization.md)
62
63- [An I/O Project: Building a Command Line Program](ch12-00-an-io-project.md)
64 - [Accepting Command Line Arguments](ch12-01-accepting-command-line-arguments.md)
65 - [Reading a File](ch12-02-reading-a-file.md)
66 - [Refactoring to Improve Modularity and Error Handling](ch12-03-improving-error-handling-and-modularity.md)
67 - [Developing the Library’s Functionality with Test Driven Development](ch12-04-testing-the-librarys-functionality.md)
68 - [Working with Environment Variables](ch12-05-working-with-environment-variables.md)
69 - [Writing Error Messages to Standard Error Instead of Standard Output](ch12-06-writing-to-stderr-instead-of-stdout.md)
70
71## Thinking in Rust
72
73- [Functional Language Features: Iterators and Closures](ch13-00-functional-features.md)
74 - [Closures: Anonymous Functions that Can Capture Their Environment](ch13-01-closures.md)
75 - [Processing a Series of Items with Iterators](ch13-02-iterators.md)
76 - [Improving Our I/O Project](ch13-03-improving-our-io-project.md)
77 - [Comparing Performance: Loops vs. Iterators](ch13-04-performance.md)
78
79- [More about Cargo and Crates.io](ch14-00-more-about-cargo.md)
80 - [Customizing Builds with Release Profiles](ch14-01-release-profiles.md)
81 - [Publishing a Crate to Crates.io](ch14-02-publishing-to-crates-io.md)
82 - [Cargo Workspaces](ch14-03-cargo-workspaces.md)
83 - [Installing Binaries from Crates.io with `cargo install`](ch14-04-installing-binaries.md)
84 - [Extending Cargo with Custom Commands](ch14-05-extending-cargo.md)
85
86- [Smart Pointers](ch15-00-smart-pointers.md)
87 - [`Box<T>` Points to Data on the Heap and Has a Known Size](ch15-01-box.md)
88 - [The `Deref` Trait Allows Access to the Data Through a Reference](ch15-02-deref.md)
89 - [The `Drop` Trait Runs Code on Cleanup](ch15-03-drop.md)
90 - [`Rc<T>`, the Reference Counted Smart Pointer](ch15-04-rc.md)
91 - [`RefCell<T>` and the Interior Mutability Pattern](ch15-05-interior-mutability.md)
92 - [Creating Reference Cycles and Leaking Memory is Safe](ch15-06-reference-cycles.md)
93
94- [Fearless Concurrency](ch16-00-concurrency.md)
95 - [Threads](ch16-01-threads.md)
96 - [Message Passing](ch16-02-message-passing.md)
97 - [Shared State](ch16-03-shared-state.md)
98 - [Extensible Concurrency: `Sync` and `Send`](ch16-04-extensible-concurrency-sync-and-send.md)
99
100- [Object Oriented Programming Features of Rust](ch17-00-oop.md)
101 - [Characteristics of Object-Oriented Languages](ch17-01-what-is-oo.md)
102 - [Using Trait Objects that Allow for Values of Different Types](ch17-02-trait-objects.md)
103 - [Implementing an Object-Oriented Design Pattern](ch17-03-oo-design-patterns.md)
104
105## Advanced Topics
106
107- [Patterns Match the Structure of Values](ch18-00-patterns.md)
108 - [All the Places Patterns May be Used](ch18-01-all-the-places-for-patterns.md)
109 - [Refutability: Whether a Pattern Might Fail to Match](ch18-02-refutability.md)
110 - [All the Pattern Syntax](ch18-03-pattern-syntax.md)
111
112- [Advanced Features](ch19-00-advanced-features.md)
113 - [Unsafe Rust](ch19-01-unsafe-rust.md)
114 - [Advanced Lifetimes](ch19-02-advanced-lifetimes.md)
115 - [Advanced Traits](ch19-03-advanced-traits.md)
116 - [Advanced Types](ch19-04-advanced-types.md)
117 - [Advanced Functions & Closures](ch19-05-advanced-functions-and-closures.md)
0bf4aa26 118 - [Macros](ch19-06-macros.md)
83c7162d
XL
119
120- [Final Project: Building a Multithreaded Web Server](ch20-00-final-project-a-web-server.md)
121 - [A Single Threaded Web Server](ch20-01-single-threaded.md)
122 - [Turning our Single Threaded Server into a Multithreaded Server](ch20-02-multithreaded.md)
123 - [Graceful Shutdown and Cleanup](ch20-03-graceful-shutdown-and-cleanup.md)
124
125- [Appendix](appendix-00.md)
126 - [A - Keywords](appendix-01-keywords.md)
127 - [B - Operators and Symbols](appendix-02-operators.md)
128 - [C - Derivable Traits](appendix-03-derivable-traits.md)
13cf67c4
XL
129 - [D - Useful Development Tools](appendix-04-useful-development-tools.md)
130 - [E - Editions](appendix-05-editions.md)
131 - [F - Translations](appendix-06-translation.md)
132 - [G - How Rust is Made and “Nightly Rust”](appendix-07-nightly-rust.md)