1
Fork 0

Remove mentions of int / uint from public documentation

This commit is contained in:
Jake Goulding 2015-05-27 19:20:32 -04:00
parent 875d356245
commit a959cc435f
13 changed files with 23 additions and 23 deletions

View file

@ -160,7 +160,7 @@ that all delimiters be balanced.
## `->` for function return type ## `->` for function return type
This is to make the language easier to parse for humans, especially in the face This is to make the language easier to parse for humans, especially in the face
of higher-order functions. `fn foo<T>(f: fn(int): int, fn(T): U): U` is not of higher-order functions. `fn foo<T>(f: fn(i32): i32, fn(T): U): U` is not
particularly easy to read. particularly easy to read.
## Why is `let` used to introduce variables? ## Why is `let` used to introduce variables?

View file

@ -14,8 +14,8 @@ use std::io::{File, Open, Write, IoError};
struct Info { struct Info {
name: String, name: String,
age: int, age: i32,
rating: int rating: i32
} }
fn write_info(info: &Info) -> Result<(), IoError> { fn write_info(info: &Info) -> Result<(), IoError> {
@ -36,8 +36,8 @@ use std::io::{File, Open, Write, IoError};
struct Info { struct Info {
name: String, name: String,
age: int, age: i32,
rating: int rating: i32
} }
fn write_info(info: &Info) -> Result<(), IoError> { fn write_info(info: &Info) -> Result<(), IoError> {

View file

@ -57,15 +57,15 @@ it becomes.
Prefer Prefer
```rust ```rust
fn foo<T: Iterator<int>>(c: T) { ... } fn foo<T: Iterator<i32>>(c: T) { ... }
``` ```
over any of over any of
```rust ```rust
fn foo(c: &[int]) { ... } fn foo(c: &[i32]) { ... }
fn foo(c: &Vec<int>) { ... } fn foo(c: &Vec<i32>) { ... }
fn foo(c: &SomeOtherCollection<int>) { ... } fn foo(c: &SomeOtherCollection<i32>) { ... }
``` ```
if the function only needs to iterate over the data. if the function only needs to iterate over the data.
@ -121,7 +121,7 @@ The primary exception: sometimes a function is meant to modify data
that the caller already owns, for example to re-use a buffer: that the caller already owns, for example to re-use a buffer:
```rust ```rust
fn read(&mut self, buf: &mut [u8]) -> IoResult<uint> fn read(&mut self, buf: &mut [u8]) -> IoResult<usize>
``` ```
(From the [Reader trait](http://static.rust-lang.org/doc/master/std/io/trait.Reader.html#tymethod.read).) (From the [Reader trait](http://static.rust-lang.org/doc/master/std/io/trait.Reader.html#tymethod.read).)

View file

@ -19,7 +19,7 @@ Prefer
```rust ```rust
struct SearchResult { struct SearchResult {
found: bool, // item in container? found: bool, // item in container?
expected_index: uint // what would the item's index be? expected_index: usize // what would the item's index be?
} }
fn binary_search(&self, k: Key) -> SearchResult fn binary_search(&self, k: Key) -> SearchResult
@ -27,7 +27,7 @@ fn binary_search(&self, k: Key) -> SearchResult
or or
```rust ```rust
fn binary_search(&self, k: Key) -> (bool, uint) fn binary_search(&self, k: Key) -> (bool, usize)
``` ```
over over

View file

@ -5,7 +5,7 @@
Prefer Prefer
```rust ```rust
fn use_mutex(m: sync::mutex::Mutex<int>) { fn use_mutex(m: sync::mutex::Mutex<i32>) {
let guard = m.lock(); let guard = m.lock();
do_work(guard); do_work(guard);
drop(guard); // unlock the lock drop(guard); // unlock the lock
@ -16,7 +16,7 @@ fn use_mutex(m: sync::mutex::Mutex<int>) {
over over
```rust ```rust
fn use_mutex(m: sync::mutex::Mutex<int>) { fn use_mutex(m: sync::mutex::Mutex<i32>) {
do_work(m.lock()); do_work(m.lock());
// do other work // do other work
} }

View file

@ -15,7 +15,7 @@ trait Printable {
fn print(&self) { println!("{:?}", *self) } fn print(&self) { println!("{:?}", *self) }
} }
impl Printable for int {} impl Printable for i32 {}
impl Printable for String { impl Printable for String {
fn print(&self) { println!("{}", *self) } fn print(&self) { println!("{}", *self) }

View file

@ -43,12 +43,12 @@ promises to the client.
For example, consider a function `my_transform` that returns a compound iterator For example, consider a function `my_transform` that returns a compound iterator
type `Enumerate<Skip<vec::MoveItems<T>>>`. We wish to hide this type from the type `Enumerate<Skip<vec::MoveItems<T>>>`. We wish to hide this type from the
client, so that the client's view of the return type is roughly `Iterator<(uint, client, so that the client's view of the return type is roughly `Iterator<(usize,
T)>`. We can do so using the newtype pattern: T)>`. We can do so using the newtype pattern:
```rust ```rust
struct MyTransformResult<T>(Enumerate<Skip<vec::MoveItems<T>>>); struct MyTransformResult<T>(Enumerate<Skip<vec::MoveItems<T>>>);
impl<T> Iterator<(uint, T)> for MyTransformResult<T> { ... } impl<T> Iterator<(usize, T)> for MyTransformResult<T> { ... }
fn my_transform<T, Iter: Iterator<T>>(iter: Iter) -> MyTransformResult<T> { fn my_transform<T, Iter: Iterator<T>>(iter: Iter) -> MyTransformResult<T> {
... ...

View file

@ -3,7 +3,7 @@
Terminate `return` statements with semicolons: Terminate `return` statements with semicolons:
``` rust ``` rust
fn foo(bar: int) -> Option<int> { fn foo(bar: i32) -> Option<i32> {
if some_condition() { if some_condition() {
return None; return None;
} }

View file

@ -44,7 +44,7 @@ For example:
use option::Option; use option::Option;
use mem; use mem;
let i: int = mem::transmute(Option(0)); let i: isize = mem::transmute(Option(0));
``` ```
> **[FIXME]** Add rationale. > **[FIXME]** Add rationale.

View file

@ -10,7 +10,7 @@
``` rust ``` rust
#[deprecated = "Use `bar` instead."] #[deprecated = "Use `bar` instead."]
fn foo(a: uint, b: uint) -> uint { fn foo(a: usize, b: usize) -> usize {
a + b a + b
} }
``` ```

View file

@ -43,7 +43,7 @@ trait Graph {
Now, our clients can be abstract over a given `Graph`: Now, our clients can be abstract over a given `Graph`:
```rust,ignore ```rust,ignore
fn distance<G: Graph>(graph: &G, start: &G::N, end: &G::N) -> uint { ... } fn distance<G: Graph>(graph: &G, start: &G::N, end: &G::N) -> usize { ... }
``` ```
No need to deal with the `E`dge type here! No need to deal with the `E`dge type here!

View file

@ -58,7 +58,7 @@ fn main() {
``` ```
The idea is that by passing around a box, you're only copying a pointer, rather The idea is that by passing around a box, you're only copying a pointer, rather
than the hundred `int`s that make up the `BigStruct`. than the hundred `i32`s that make up the `BigStruct`.
This is an antipattern in Rust. Instead, write this: This is an antipattern in Rust. Instead, write this:

View file

@ -146,7 +146,7 @@ print_area(5);
We get a compile-time error: We get a compile-time error:
```text ```text
error: failed to find an implementation of trait main::HasArea for int error: the trait `HasArea` is not implemented for the type `_` [E0277]
``` ```
So far, weve only added trait implementations to structs, but you can So far, weve only added trait implementations to structs, but you can