-
Notifications
You must be signed in to change notification settings - Fork 0
Doc language FAQ
- Memory safe: no null pointers, wild pointers, etc
- Expressive mutability control. Immutable by default
- No shared mutable state across tasks
- Dynamic execution safety: task failure / unwinding, trapping, RAII / dtors
- Safe interior pointer types with lifetime analysis
- Lightweight tasks (coroutines) with expanding stacks
- Fast asynchronous, copyless message passing
- Optional garbage collection
- All types may be explicitly allocated on the stack or interior to other types
- Static, native compilation using LLVM
- Direct and simple interface to C code
- Multi-paradigm: pure-functional, concurrent-actor, imperative-procedural, OO
- First-class functions, cheap non-escaping closures
- Algebraic data types (called enums) with pattern matching
- Method implementations on any type
- Traits, which share aspects of type classes and interfaces
- Multi-platform. Developed on Windows, Linux, OS X
- UTF-8 strings, assortment of machine-level types
- Works with existing native toolchains, GDB, Valgrind, Instruments, etc
- Rule-breaking is allowed if explicit about where and how
The syntax is still evolving, but here's a snippet from the hash map in core::send_map.
struct LinearMap<K:Eq Hash,V> {
k0: u64,
k1: u64,
resize_at: uint,
size: uint,
buckets: ~[Option<Bucket<K,V>>],
}
enum SearchResult {
FoundEntry(uint), FoundHole(uint), TableFull
}
fn linear_map_with_capacity<K:Eq Hash,V>(capacity: uint) -> LinearMap<K,V> {
let r = rand::Rng();
linear_map_with_capacity_and_keys(r.gen_u64(), r.gen_u64(), capacity)
}
impl<K:Hash IterBytes Eq, V> LinearMap<K,V> {
pure fn contains_key(&const self, k: &K) -> bool {
match self.bucket_for_key(self.buckets, k) {
FoundEntry(_) => true,
TableFull | FoundHole(_) => false
}
}
fn clear(&mut self) {
for uint::range(0, self.buckets.len()) |idx| {
self.buckets[idx] = None;
}
self.size = 0;
}
...
}
There aren't many large programs yet. The Rust compiler, 50,000+ lines at the time of writing, is written in Rust. As the oldest body of Rust code it has gone through many iterations of the language, and some parts are nicer to look at than others. It may not be the best code to learn from, but borrowck and resolve were written recently.
A research browser engine called Servo, currently 17,000+ lines across more than a dozen crates, will be exercising a lot of Rust's distinctive type-system and concurrency features, and integrating many native libraries. Note that Servo pushes at all the rough edges of Rust, and with the ongoing language changes is regrettably difficult to build for the time being.
Some examples that demonstrate different aspects of the language:
- The language's general-purpose hash function, SipHash-2-4. Bit twiddling, OO, macros
- The core library's LinearMap, a sendable hash map in an OO style
- The standard library's json module. Enums and pattern matching
- Servo's ImageCacheTask, an image cache in an actor style
- fempeg, an mp2 decoder that does only stack allocation, no heap and no GC
- rustdoc, Rust's documentation generator, in a functional, GC-less style with parallel folding and mapping
- mre, a small web framework integrating a number of interesting crates and bindings
You may also be interested in browsing GitHub's Rust page.
Yes. All development happens in lock-step on all 3 target platforms. Using MinGW, not Cygwin. Note that the windows implementation currently has some limitations: in particular tasks cannot unwind on windows, and all Rust executables require a MinGW installation at runtime.
Rust and Go have similar syntax and task models, but they have very different type systems. Rust is distinguished by greater type safety and memory safety guarantees, more control over memory layout, and robust generics.
Rust has several key features that aren't shared by Go:
- No shared mutable state - Shared mutable state allows data races, a large class of bad bugs. In Rust there is no sharing of mutable data, but ownership of data can be efficiently transferred between tasks.
- Minimal GC impact - By not having shared mutable data, Rust can avoid global GC, hence Rust never stops the world to collect garbage. With multiple allocation options, individual tasks can completely avoid GC.
- No null pointers - Accidentally dereferencing null pointers is a big bummer, so Rust doesn't have them.
- Type parametric code - Generics prove useful time and again, though they are inevitably complex to greater or lesser degrees.
Some of Rust's advantages come at the cost of a more intricate type system than Go's.
Go has its own strengths and in particular has a great user experience that Rust still lacks.
At this point we are focusing on removing and stabilizing features rather than adding them. File a bug if you think it's important in terms of meeting the existing goals or making the language passably usable. Reductions are more interesting than additions, though.
It is multi-paradigm. Not everything is shoe-horned into a single abstraction. Many things you can do in OO languages you can do in Rust, but not everything, and not always using the same abstraction you're accustomed to.
Data values in the language can only be constructed through a fixed set of initializer forms. Each of those forms requires that its inputs already be initialized. A liveness analysis ensures that local variables are initialized before use.
- A crate is a top-level compilation unit that corresponds to a single loadable object.
- A module is a (possibly nested) unit of name-management inside a crate.
- A crate contains an implicit, un-named top-level module.
- Recursive definitions can span modules, but not crates.
- Crates do not have global names, only a set of non-unique metadata tags.
- There is no global inter-crate namespace; all name management occurs within a crate.
- Using another crate binds the root of its namespace into the user's namespace.
In short, because too few guarantees could be made about the dynamic environment of the catch block, as well as invariants holding in the unwound heap, to be able to safely resume; we believe that other methods of signalling and logging errors are more appropriate, with tasks playing the role of a "hard" isolation boundary between separate heaps.
Rust provides, instead, three predictable and well-defined options for handling any combination of the three main categories of "catch" logic:
- Failure logging is done by the integrated logging subsystem.
- Recovery after a failure is done by trapping a task failure from outside the task, where other tasks are known to be unaffected.
- Cleanup of resources is done by RAII-style objects with destructors.
Cleanup through RAII-style destructors is more likely to work than in catch blocks anyways, since it will be better tested (part of the non-error control paths, so executed all the time).
We want to maintain the option to parametrize at runtime. We may make eventually change this limitation, but initially this is how type parameters were implemented.
Doing so would make type inference much more complex, and require the implementation strategy of runtime parametrization.
We don't know if there's an obvious, easy, efficient, stock-textbook way of supporting open or structural disjoint unions. We prefer to stick to language features that have an obvious and well-explored semantics.
There's a lot of debate on this topic; it's easy to find a proponent of default-sync or default-async communication, and there are good reasons for either. Our choice rests on the following arguments:
- Part of the point of isolating tasks is to decouple tasks from one another, such that assumptions in one task do not cause undue constraints (or bugs, if violated!) in another. Temporal coupling is as real as any other kind; async-by-default relaxes the default case to only causal coupling.
- Default-async supports buffering and batching communication, reducing the frequency and severity of task-switching and inter-task / inter-domain synchronization.
- Default-async with transmittable channels is the lowest-level building block on which more-complex synchronization topologies and strategies can be built; it is not clear to us that the majority of cases fit the 2-party full-synchronization pattern rather than some more complex multi-party or multi-stage scenario. We did not want to force all programs to pay for wiring the former assumption into all communications.
Similar to the reasoning about default-sync: it wires fewer assumptions into the implementation, that would have to be paid by all use-cases even if they actually require a more complex communication topology.
The str type is UTF-8 because we observe more text in the wild in this encoding -- particularly in network transmissions, which are endian-agnostic -- and we think it's best that the default treatment of I/O not involve having to recode codepoints in each direction.
This does mean that indexed access to a Unicode codepoint inside a str value is an O(n) operation. On the one hand, this is clearly undesirable; on the other hand, this problem is full of trade-offs and we'd like to point a few important qualifications:
- Scanning a
strfor ASCII-range codepoints can still be done safely octet-at-a-time, with each indexing operation pulling out au8costing only O(1) and producing a value that can be cast and compared to an ASCII-rangechar. So if you're (say) line-breaking on'\n', octet-based treatment still works. UTF8 was well-designed this way. - Most "character oriented" operations on text only work under very restricted language assumptions sets such as "ASCII-range codepoints only". Outside ASCII-range, you tend to have to use a complex (non-constant-time) algorithm for determining linguistic-unit (glyph, word, paragraph) boundaries anyways. We recommend using an "honest" linguistically-aware, Unicode-approved algorithm.
- The
chartype is UCS4. If you honestly need to do a codepoint-at-a-time algorithm, it's trivial to write atype wstr = [char], and unpack astrinto it in a single pass, then work with thewstr. In other words: the fact that the language is not "decoding to UCS4 by default" shouldn't stop you from decoding (or re-encoding any other way) if you need to work with that encoding.
We made this decision at a time when the syntax extension system was less mature. We plan to change log to be a macro (see #554).
In each case there is one or more operator, literal constructor, overloaded use or integration with a built-in control structure that makes us think it would be awkward to phrase the type in terms of more-general type constructors. Same as, say, with numbers! But this is partly an aesthetic call, and we'd be willing to look at a worked-out proposal for eliminating or rephrasing these special cases.
Yes. Since C code typically expects a larger stack than Rust code does, the stack may grow before the call. The Rust domain owning the task that makes the call will block for the duration of the call, so if the call is likely to be long-lasting, you should consider putting the task in its own domain (thread or process).
Yes. The Rust code has to be exposed via an extern declaration, which makes it C-ABI compatible. Its address can then be taken and passed to C code. When C calls Rust back, the callback occurs in very restricted circumstances.
They start small (ideally in the hundreds of bytes) and expand dynamically by calling through special frames that allocate new stack segments. This is known as the "spaghetti stack" approach.
- Managed boxes live in the garbage collected task-local heap
- Owned boxes live in the global exchange heap
- Managed boxes may be referred to by multiple managed box references
- Owned boxes have unique ownership and there may only be a single unique pointer to a unique box at a time
- Managed boxes may not be shared between tasks
- Owned boxes may be transferred (moved) between tasks
- Borrowed pointers point to the interior of a stack or heap allocation
- Borrowed pointers can only be formed when it will provably be outlived by the referent
- Borrowed pointers to managed box pointers keep the managed boxes alive
- Borrowed pointers to owned boxes prevent their ownership from being transferred
- Borrowed pointers employ region-based alias analysis to ensure correctness
- Mechanically, it simplifies the inference algorithm; inference only requires looking at one function at a time.
- The same simplification goes double for human readers. A reader does not need an IDE running an inference algorithm across an entire crate to be able to guess at a function's argument types; it's always explicit and nearby.
- Parameters in Rust can be passed by reference or by value. We can't automatically infer which one the programmer means.
For simplicity, we do not plan to do so. Implementing automatic semicolon insertion for Rust would be tricky because the absence of a trailing semicolon means "return a value".