]> git.proxmox.com Git - rustc.git/blob - src/doc/rust-by-example/src/index.md
New upstream version 1.25.0+dfsg1
[rustc.git] / src / doc / rust-by-example / src / index.md
1 # Rust by Example
2
3 [Rust][rust] is a modern systems programming language focusing on safety, speed,
4 and concurrency. It accomplishes these goals by being memory safe without using
5 garbage collection.
6
7 Rust by Example (RBE) is a collection of runnable examples that illustrate various Rust
8 concepts and standard libraries. To get even more out of these examples, don't forget
9 to [install Rust locally][install] and check out the [official docs][std].
10 Additionally for the curious, you can also [check out the source code for this site][home].
11
12 Now let's begin!
13
14 - [Hello World](hello.html) - Start with a traditional Hello World program.
15
16 - [Primitives](primitives.html) - Learn about signed integers, unsigned integers and other primitives.
17
18 - [Custom Types](custom_types.html) - `struct` and `enum`.
19
20 - [Variable Bindings](variable_bindings.html) - mutable bindings, scope, shadowing.
21
22 - [Types](types.html) - Learn about changing and defining types.
23
24 - [Conversion](conversion.html)
25
26 - [Expressions](expression.html)
27
28 - [Flow Control](flow_control.html) - `if`/`else`, `for`, and others.
29
30 - [Functions](fn.html) - Learn about Methods, Closures and High Order Functions.
31
32 - [Modules](mod.html) - Organize code using modules
33
34 - [Crates](crates.html) - A crate is a compilation unit in Rust. Learn to create a library.
35
36 - [Attributes](attribute.html) - An attribute is metadata applied to some module, crate or item.
37
38 - [Generics](generics.html) - Learn about writing a function or data type which can work for multiple types of arguments.
39
40 - [Scoping rules](scope.html) - Scopes play an important part in ownership, borrowing, and lifetimes.
41
42 - [Traits](trait.html) - A trait is a collection of methods defined for an unknown type: `Self`
43
44 - [Macros](macros.html)
45
46 - [Error handling](error.html) - Learn Rust way of handling failures.
47
48 - [Std library types](std.html) - Learn about some custom types provided by `std` library.
49
50 - [Std misc](std_misc.html) - More custom types for file handling, threads.
51
52 - [Testing](testing.html) - All sorts of testing in Rust.
53
54 - [Meta](meta.html) - Documentation, Benchmarking.
55
56 - [Unsafe Operations](unsafe.html)
57
58
59 [rust]: https://www.rust-lang.org/
60 [install]: https://www.rust-lang.org/install.html
61 [std]: https://doc.rust-lang.org/std/
62 [home]: https://github.com/rust-lang/rust-by-example