Skip to content

Commit 6f508e7

Browse files
committed
---
yaml --- r: 211599 b: refs/heads/master c: bc3d50d h: refs/heads/master i: 211597: 496e5a0 211595: 379c5c5 211591: 09c3bed 211583: a71c3a2 v: v3
1 parent fe66125 commit 6f508e7

File tree

8 files changed

+13
-183
lines changed

8 files changed

+13
-183
lines changed

[refs]

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
refs/heads/master: 71d33cd1150371d1136d136e5b18ea724fbd2605
2+
refs/heads/master: bc3d50d6847a72899d83b6ea1812574242c3b858
33
refs/heads/snap-stage1: e33de59e47c5076a89eadeb38f4934f58a3618a6
44
refs/heads/snap-stage3: ba0e1cd8147d452c356aacb29fb87568ca26f111
55
refs/heads/try: 1864973ae17213c5a58c4dd3f9af6d1b6c7d2e05

trunk/AUTHORS.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -338,7 +338,7 @@ Hajime Morrita <[email protected]>
338338
Hanno Braun <[email protected]>
339339
Harry Marr <[email protected]>
340340
341-
Heejong Ahn <[email protected]
341+
Heejong Ahn <[email protected]>
342342
Henrik Schopmans <[email protected]>
343343
Herman J. Radtke III <[email protected]>
344344
HeroesGrave <[email protected]>

trunk/src/doc/reference.md

Lines changed: 0 additions & 140 deletions
Original file line numberDiff line numberDiff line change
@@ -3599,146 +3599,6 @@ The notation `&self` is a shorthand for `self: &Self`. In this case,
35993599
in the impl, `Self` refers to the value of type `String` that is the
36003600
receiver for a call to the method `make_string`.
36013601

3602-
## Subtyping
3603-
3604-
Subtyping is implicit and can occur at any stage in type checking or
3605-
inference. Subtyping in Rust is very restricted and occurs only due to
3606-
variance with respect to lifetimes and between types with higher ranked
3607-
lifetimes. If we were to erase lifetimes from types, then the only subtyping
3608-
would be due to type equality.
3609-
3610-
Consider the following example: string literals always have `'static`
3611-
lifetime. Nevertheless, we can assign `s` to `t`:
3612-
3613-
```
3614-
fn bar<'a>() {
3615-
let s: &'static str = "hi";
3616-
let t: &'a str = s;
3617-
}
3618-
```
3619-
Since `'static` "lives longer" than `'a`, `&'static str` is a subtype of
3620-
`&'a str`.
3621-
3622-
## Type coercions
3623-
3624-
Coercions are defined in [RFC401]. A coercion is implicit and has no syntax.
3625-
3626-
[RFC401]: https://github.com/rust-lang/rfcs/blob/master/text/0401-coercions.md
3627-
3628-
### Coercion sites
3629-
3630-
A coercion can only occur at certain coercion sites in a program; these are
3631-
typically places where the desired type is explicit or can be dervied by
3632-
propagation from explicit types (without type inference). Possible coercion
3633-
sites are:
3634-
3635-
* `let` statements where an explicit type is given.
3636-
3637-
In `let _: U = e;`, `e` is coerced to have type `U`.
3638-
3639-
* `static` and `const` statements (similar to `let` statements).
3640-
3641-
* arguments for function calls.
3642-
3643-
The value being coerced is the
3644-
actual parameter and it is coerced to the type of the formal parameter. For
3645-
example, let `foo` be defined as `fn foo(x: U) { ... }` and call it as
3646-
`foo(e);`. Then `e` is coerced to have type `U`;
3647-
3648-
* instantiations of struct or variant fields.
3649-
3650-
Assume we have a `struct
3651-
Foo { x: U }` and instantiate it as `Foo { x: e }`. Then `e` is coerced to
3652-
have type `U`.
3653-
3654-
* function results (either the final line of a block if it is not semicolon
3655-
terminated or any expression in a `return` statement).
3656-
3657-
In `fn foo() -> U { e }`, `e` is coerced to to have type `U`.
3658-
3659-
If the expression in one of these coercion sites is a coercion-propagating
3660-
expression, then the relevant sub-expressions in that expression are also
3661-
coercion sites. Propagation recurses from these new coercion sites.
3662-
Propagating expressions and their relevant sub-expressions are:
3663-
3664-
* array literals, where the array has type `[U; n]`. Each sub-expression in
3665-
the array literal is a coercion site for coercion to type `U`.
3666-
3667-
* array literals with repeating syntax, where the array has type `[U; n]`. The
3668-
repeated sub-expression is a coercion site for coercion to type `U`.
3669-
3670-
* tuples, where a tuple is a coercion site to type `(U_0, U_1, ..., U_n)`.
3671-
Each sub-expression is a coercion site to the respective type, e.g. the
3672-
zeroth sub-expression is a coercion site to type `U_0`.
3673-
3674-
* parenthesised sub-expressions (`(e)`). If the expression has type `U`, then
3675-
the sub-expression is a coercion site to `U`.
3676-
3677-
* blocks. If a block has type `U`, then the last expression in the block (if
3678-
it is not semicolon-terminated) is a coercion site to `U`. This includes
3679-
blocks which are part of control flow statements, such as `if`/`else`, if
3680-
the block has a known type.
3681-
3682-
### Coercion types
3683-
3684-
Coercion is allowed between the following types:
3685-
3686-
* `T` to `U` if `T` is a subtype of `U` (*reflexive case*).
3687-
3688-
* `T_1` to `T_3` where `T_1` coerces to `T_2` and `T_2` coerces to `T_3`
3689-
(*transitive case*).
3690-
3691-
Note that this is not fully supported yet
3692-
3693-
* `&mut T` to `&T`.
3694-
3695-
* `*mut T` to `*const T`.
3696-
3697-
* `&T` to `*const T`.
3698-
3699-
* `&mut T` to `*mut T`.
3700-
3701-
* `&T` to `&U` if `T` implements `Deref<Target = U>`. For example:
3702-
```
3703-
use std::ops::Deref;
3704-
3705-
struct CharContainer {
3706-
value: char
3707-
}
3708-
3709-
impl Deref for CharContainer {
3710-
type Target = char;
3711-
3712-
fn deref<'a>(&'a self) -> &'a char {
3713-
&self.value
3714-
}
3715-
}
3716-
3717-
fn foo(arg: &char) {}
3718-
3719-
fn main() {
3720-
let x = &mut CharContainer { value: 'y' };
3721-
foo(x); //&mut CharContainer is coerced to &char.
3722-
}
3723-
```
3724-
* `&mut T` to `&mut U` if `T` implements `DerefMut<Target = U>`.
3725-
3726-
* TyCtor(`T`) to TyCtor(coerce_inner(`T`)), where TyCtor(`T`) is one of
3727-
- `&T`
3728-
- `&mut T`
3729-
- `*const T`
3730-
- `*mut T`
3731-
- `Box<T>`
3732-
3733-
and where
3734-
- coerce_inner(`[T, ..n]`) = `[T]`
3735-
- coerce_inner(`T`) = `U` where `T` is a concrete type which implements the
3736-
trait `U`.
3737-
3738-
In the future, coerce_inner will be recursively extended to tuples and
3739-
structs. In addition, coercions from sub-traits to super-traits will be
3740-
added. See [RFC401] for more details.
3741-
37423602
# Special traits
37433603

37443604
Several traits define special evaluation behavior.

trunk/src/libcore/result.rs

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -223,9 +223,7 @@
223223
//! }
224224
//! ```
225225
//!
226-
//! `try!` is imported by the prelude and is available everywhere, but it can only
227-
//! be used in functions that return `Result` because of the early return of
228-
//! `Err` that it provides.
226+
//! `try!` is imported by the prelude, and is available everywhere.
229227
230228
#![stable(feature = "rust1", since = "1.0.0")]
231229

trunk/src/librustc_typeck/check/dropck.rs

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -238,12 +238,14 @@ fn ensure_drop_predicates_are_implied_by_item_defn<'tcx>(
238238
/// Let `v` be some value (either temporary or named) and 'a be some
239239
/// lifetime (scope). If the type of `v` owns data of type `D`, where
240240
///
241-
/// * (1.) `D` has a lifetime- or type-parametric Drop implementation, and
242-
/// * (2.) the structure of `D` can reach a reference of type `&'a _`, and
243-
/// * (3.) either:
244-
/// * (A.) the Drop impl for `D` instantiates `D` at 'a directly,
241+
/// (1.) `D` has a lifetime- or type-parametric Drop implementation, and
242+
/// (2.) the structure of `D` can reach a reference of type `&'a _`, and
243+
/// (3.) either:
244+
///
245+
/// (A.) the Drop impl for `D` instantiates `D` at 'a directly,
245246
/// i.e. `D<'a>`, or,
246-
/// * (B.) the Drop impl for `D` has some type parameter with a
247+
///
248+
/// (B.) the Drop impl for `D` has some type parameter with a
247249
/// trait bound `T` where `T` is a trait that has at least
248250
/// one method,
249251
///

trunk/src/libstd/macros.rs

Lines changed: 1 addition & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -117,34 +117,7 @@ macro_rules! println {
117117
}
118118

119119
/// Helper macro for unwrapping `Result` values while returning early with an
120-
/// error if the value of the expression is `Err`. Can only be used in
121-
/// functions that return `Result` because of the early return of `Err` that
122-
/// it provides.
123-
///
124-
/// # Examples
125-
///
126-
/// ```
127-
/// use std::io;
128-
/// use std::fs::File;
129-
/// use std::io::prelude::*;
130-
///
131-
/// fn write_to_file_using_try() -> Result<(), io::Error> {
132-
/// let mut file = try!(File::create("my_best_friends.txt"));
133-
/// try!(file.write_all(b"This is a list of my best friends."));
134-
/// println!("I wrote to the file");
135-
/// Ok(())
136-
/// }
137-
/// // This is equivalent to:
138-
/// fn write_to_file_using_match() -> Result<(), io::Error> {
139-
/// let mut file = try!(File::create("my_best_friends.txt"));
140-
/// match file.write_all(b"This is a list of my best friends.") {
141-
/// Ok(_) => (),
142-
/// Err(e) => return Err(e),
143-
/// }
144-
/// println!("I wrote to the file");
145-
/// Ok(())
146-
/// }
147-
/// ```
120+
/// error if the value of the expression is `Err`.
148121
#[macro_export]
149122
#[stable(feature = "rust1", since = "1.0.0")]
150123
macro_rules! try {

trunk/src/libstd/sync/rwlock.rs

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,6 @@ use sys_common::rwlock as sys;
2424
/// of the underlying data (exclusive access) and the read portion of this lock
2525
/// typically allows for read-only access (shared access).
2626
///
27-
/// The priority policy of the lock is dependent on the underlying operating
28-
/// system's implementation, and this type does not guarantee that any
29-
/// particular policy will be used.
30-
///
3127
/// The type parameter `T` represents the data that this lock protects. It is
3228
/// required that `T` satisfies `Send` to be shared across threads and `Sync` to
3329
/// allow concurrent access through readers. The RAII guards returned from the

trunk/src/libsyntax/parse/parser.rs

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2070,9 +2070,10 @@ impl<'a> Parser<'a> {
20702070
}
20712071
_ => {
20722072
if try!(self.eat_lt()){
2073+
20732074
let (qself, path) =
20742075
try!(self.parse_qualified_path(LifetimeAndTypesWithColons));
2075-
hi = path.span.hi;
2076+
20762077
return Ok(self.mk_expr(lo, hi, ExprPath(Some(qself), path)));
20772078
}
20782079
if try!(self.eat_keyword(keywords::Move) ){

0 commit comments

Comments
 (0)