Supported as of 0.11 | |
Provided by the standard library | |
Proposed | |
Impossible |
'r Lifetime |
K Trait bounds |
T… Function arguments |
-> U Function return |
extern "ABI" ABI definition |
This "periodic table" is a cheatsheet for various Rust types. Rust programming language has a versatile type system that avoids a certain class of memory error in the safe context, and consequently has somewhat many types at the first glance. This table organizes them into an orthogonal tabular form, making them easier to understand and reason.
This table does not indicate that Rust has a complex type system compared to other languages. Rust does have seemingly many types, but you only need to understand the meaning of each axis, or even just each column. There are some non-trivial but reasonable interactions between rows and columns though, therefore this table strives to illustrate that.
The periodic table was made by Kang Seonghoon as a thought experiment, and then... it have got redditted unexpectedly :p Henceforth I've made the URL permanent and added some descriptions. Some post-reddit changes include:
[T, ..n]
, so it has a new "unsized" column now.T
) occupy two cells since you can use trait methods to those types. Also proposed function traits are updated and some of them are marked impossible as per the comments by glaebhoerl. Thanks everyone in /r/rust and #rust-internals for suggestions!Discussion: /r/rust, /r/programming, Hacker News
Columns indicate the ownership. There are two big groups from left to right: indirect (i.e. pointers) and direct. Particularly indirect types can be used in place of other indirect types in many cases: &mut self
methods can be used for Box<T>
(when the box itself is mutable), and &self
methods can be used for &mut T
.
Rows indicate the different kind of types. There are three big groups from top to bottom: unsafe dereference, safe dereference and callable.
Colored backgrounds (sorry the accessibility!) indicate the current availability. Black background means the type is plain absurd and prohibited. Striped background means the type is supported via the standard library. Gray background means the type makes some sense but it is not yet in the language. Fortunately we have two or three proposals that cover all the missing types now:
[T]
, str
and Trait
do not have their size known in the compile time. The proposal allows them in the limited context, and that is primarily useful for fully supporting custom smart pointers. This also has a side effect that allows for &mut str
, though it won't see much use since safe strings cannot be modified via indexing.|T…| -> U
may be desugared into either Fn<(T…), U>
, &mut Fn<(T…), U>
, impl Fn<(T…), U>
(with a syntax originally proposed by RFC 105) or so.There are some optional syntactic parts possible in types. Many of them are turned off by default since they are normally verbose, but you can turn them on if you want.
Copyright © 2014, Kang Seonghoon. This work is licensed under a Creative Commons Attribution 4.0 International License.
a part of cosmic.mearie.org.