bjoernager/rust
bjoernager/rust
1
Fork 0
Code Activity

Reword memory-ownership section.

Browse source
This commit is contained in:
Graydon Hoare 2012-10-05 15:48:28 -07:00
parent df98cb8e88
commit 2f50607d88
1 changed files with 7 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

17
doc/rust.md
View file

@ -2733,20 +2733,17 @@ the box values pointing to it. Since box values may themselves be passed in
and out of frames, or stored in the heap, heap allocations may outlive the and out of frames, or stored in the heap, heap allocations may outlive the
frame they are allocated within. frame they are allocated within.
### Memory ownership ### Memory ownership
A task owns all memory it can *safely* reach through local variables, A task owns all memory it can *safely* reach through local variables,
shared or unique boxes, and/or references. Sharing memory between tasks can as well as managed, owning and borrowed pointers.
only be accomplished using *unsafe* constructs, such as raw pointer
operations or calling C code.
When a task sends a value that has the `send` trait over a channel, it When a task sends a value that has the `Send` trait to another task,
loses ownership of the value sent and can no longer refer to it. This is it loses ownership of the value sent and can no longer refer to it.
statically guaranteed by the combined use of "move semantics" and the This is statically guaranteed by the combined use of "move semantics",
compiler-checked _meaning_ of the `send` trait: it is only instantiated and the compiler-checked _meaning_ of the `Send` trait:
for (transitively) unique kinds of data constructor and pointers, never shared it is only instantiated for (transitively) sendable kinds of data constructor and pointers,
pointers. never including managed or borrowed pointers.
When a stack frame is exited, its local allocations are all released, and its When a stack frame is exited, its local allocations are all released, and its
references to boxes (both shared and owned) are dropped. references to boxes (both shared and owned) are dropped.