基本语法

变量绑定

在Rust中,变量绑定 (variable bindings) 是通过let关键字声明的:

let x = 5;
let mut x = 5;
let x: i32 = 5;
let (a, b) = (3, 4);

其中变量类型如i32一般都是可以省略的,因为Rust使用了类型推断 (type inference)。 Rust还通过模式匹配 (pattern matching) 对变量进行解构,这允许我们同时对多个变量进行赋值。

有几点是需要特别注意的:

  • 变量默认是不可改变的 (immutable),如果需要改变一个变量的值需要显式加上mut关键字。
  • 变量具有局部作用域,被限制在所属的代码块内,并且允许变量覆盖 (variable shadowing)。
  • Rust默认开启属性#[warn(unused_variable)],会对未使用的变量 (以_开头的除外) 发出警告。
  • 原生类型

    Rust内置的原生类型 (primitive types) 有以下几类:

    • 布尔类型:有两个值truefalse
    • 字符类型:表示单个Unicode字符,存储为4个字节。
    • 数值类型:分为有符号整数 (i8, i16, i32, i64, isize)、 无符号整数 (u8, u16, u32, u64, usize) 以及浮点数 (f32, f64)。
    • 字符串类型:最底层的是不定长类型str,更常用的是字符串切片&str和堆分配字符串String, 其中字符串切片是静态分配的,有固定的大小,并且不可变,而堆分配字符串是可变的。
    • 数组:具有固定大小,并且元素都是同种类型,可表示为[T; N]
    • 切片:引用一个数组的部分数据并且不需要拷贝,可表示为&[T]
    • 元组:具有固定大小的有序列表,每个元素都有自己的类型,通过解构或者索引来获得每个元素的值。
    • 指针:最底层的是裸指针*const T*mut T,但解引用它们是不安全的,必须放到unsafe块里。
    • 函数:具有函数类型的变量实质上是一个函数指针。
    • 元类型:即(),其唯一的值也是()
    // boolean type
    let t = true;
    let f: bool = false;
    
    // char type
    let c = 'c';
    
    // numeric types
    let x = 42;
    let y: u32 = 123_456;
    let z: f64 = 1.23e+2;
    let zero = z.min(123.4);
    let bin = 0b1111_0000;
    let oct = 0o7320_1546;
    let hex = 0xf23a_b049;
    
    // string types
    let str = "Hello, world!";
    let mut string = str.to_string();
    
    // arrays and slices
    let a = [0, 1, 2, 3, 4];
    let middle = &a[1..4];
    let mut ten_zeros: [i64; 10] = [0; 10];
    
    // tuples
    let tuple: (i32, &str) = (50, "hello");
    let (fifty, _) = tuple;
    let hello = tuple.1;
    
    // raw pointers
    let x = 5;
    let raw = &x as *const i32;
    let points_at = unsafe { *raw };
    
    // functions
    fn foo(x: i32) -> i32 { x }
    let bar: fn(i32) -> i32 = foo;

    有几点是需要特别注意的:

    • 数值类型可以使用_分隔符来增加可读性。
    • Rust还支持单字节字符b'H'以及单字节字符串b"Hello",仅限制于ASCII字符。 此外,还可以使用r#"..."#标记来表示原始字符串,不需要对特殊字符进行转义。
    • 使用&符号将String类型转换成&str类型很廉价, 但是使用to_string()方法将&str转换到String类型涉及到分配内存, 除非很有必要否则不要这么做。
    • 数组的长度是不可变的,动态的数组称为向量 (vector),可以使用宏vec!创建。
    • 元组可以使用==!=运算符来判断是否相同。
    • 不多于32个元素的数组和不多于12个元素的元组在值传递时是自动复制的。
    • Rust不提供原生类型之间的隐式转换,只能使用as关键字显式转换。
    • 可以使用type关键字定义某个类型的别名,并且应该采用驼峰命名法。

    结构体

    结构体 (struct) 是一种记录类型,所包含的每个域 (field) 都有一个名称。 每个结构体也都有一个名称,通常以大写字母开头,使用驼峰命名法。 元组结构体 (tuple struct) 是由元组和结构体混合构成,元组结构体有名称, 但是它的域没有。当元组结构体只有一个域时,称为新类型 (newtype)。 没有任何域的结构体,称为类单元结构体 (unit-like struct)。 结构体中的值默认是不可变的,需要使用mut使其可变。

    // structs
    struct Point {
      x: i32,
      y: i32,
    }
    let mut point = Point { x: 0, y: 0 };
    
    // tuple structs
    struct Color(u8, u8, u8);
    let android_green = Color(0xa4, 0xc6, 0x39);
    let (red, green, blue) = android_green;
    
    // A tuple struct’s constructors can be used as functions.
    struct Digit(i32);
    let v = vec![0, 1, 2];
    let d: Vec<Digit> = v.into_iter().map(Digit).collect();
    
    // newtype: a tuple struct with only one element
    struct Inches(i32);
    let length = Inches(10);
    let Inches(integer_length) = length;
    
    // unit-like structs
    struct Null;
    let empty = Null;

    一个包含..struct可以用来从其它结构体拷贝一些值或者在解构时忽略一些域:

    #[derive(Default)]
    struct Point3d {
        x: i32,
        y: i32,
        z: i32,
    }
    
    let origin = Point3d::default();
    let point = Point3d { y: 1, ..origin };
    let Point3d { x: x0, y: y0, .. } = point;

    需要注意,Rust在语言级别不支持域可变性 (field mutability),所以不能这么写:

    struct Point {
        mut x: i32,
        y: i32,
    }

    这是因为可变性是绑定的一个属性,而不是结构体自身的。可以使用Cell<T>来模拟:

    use std::cell::Cell;
    
    struct Point {
        x: i32,
        y: Cell<i32>,
    }
    
    let mut point = Point { x: 5, y: Cell::new(6) };
    
    point.y.set(7);

    此外,结构体的域默认是私有的,可以使用pub关键字将其设置成公开。

    枚举

    Rust有一个集合类型,称为枚举 (enum),对于一个指定的名称有一组可替代的值, 其中子数据结构可以存储也可以不存储数据,需要使用::语法来获得每个元素的名称。

    // enums
    enum Message {
        Quit,
        ChangeColor(i32, i32, i32),
        Move { x: i32, y: i32 },
        Write(String),
    }
    
    let x: Message = Message::Move { x: 3, y: 4 };

    与结构体一样,枚举中的元素默认不能使用关系运算符进行比较 (如==, !=, >=), 也不支持像+*这样的双目运算符,需要自己实现,或者使用match进行匹配。

    枚举默认也是私有的,如果使用pub使其变为公有,则它的元素也都是默认公有的。 这一点是与结构体不同的:即使结构体是公有的,它的域仍然是默认私有的。 此外,枚举和结构体也可以是递归的 (recursive)。

    函数

    要声明一个函数,需要使用关键字fn,后面跟上函数名,比如

    fn add_one(x: i32) -> i32 {
        x + 1
    }

    其中函数参数的类型不能省略,可以有多个参数,但是最多只能返回一个值, 提前返回使用return关键字。Rust编译器会对未使用的函数提出警告, 可以使用属性#[allow(dead_code)]禁用无效代码检查。

    Rust有一个特殊语法适用于分叉函数 (diverging function),它不返回值:

    fn diverges() -> ! {
        panic!("This function never returns!");
    }

    其中panic!是一个宏,使当前执行线程崩溃并打印给定信息。返回类型!可用作任何类型:

    注释

    Rust有三种注释:

    • 行注释 (line comments):以//开头,仅能注释一行。
    • 块注释 (block comments):以/*开头,以*/结尾,能注释多行,但是不建议使用。
    • 文档注释 (doc comments):以///或者//!开头,支持Markdown标记语言, 其中///等价于写属性#[doc = "..."]//!等价于#![doc = "/// ..."], 配合rustdoc可自动生成说明文档。
    let x: i32 = diverges();
    let y: String = diverges();
    // explicit conversion
    let decimal = 65.4321_f32;
    let integer = decimal as u8;
    let character = integer as char;
    
    // type aliases
    type NanoSecond = u64;
    type Point = (u8, u8);
  • Rust允许先声明变量然后再初始化,但是使用未被初始化的变量会产生一个编译时错误。