程序测试

测试属性

在测试函数前加上#[test]属性:

#[test]
fn it_works() {
    assert!(false);
}

其中assert!宏接受一个参数,如果参数为false,它会导致panic!。 运行cargo test命令,可见该测试失败。如果要反转测试失败, 可以加上#[should_panic]属性:

测试模块

在测试模块前加上#[cfg(test)]属性:

测试目录

对于集成测试,可以新建一个tests目录,这样其中的代码就不需要再引入单元风格的测试模块了。

文档测试

对于包含有测试例子的注释文档中,运行cargo test时也会运行其中包含的测试。

错误处理

Rust明确区分两种形式的错误:失败 (failture) 和恐慌 (panic)。 失败是可以通过某种方式恢复的错误,而恐慌(panic)则不能够恢复。

最简单的表明函数会失败的方法是使用Option<T>类型:

fn from_str<A: FromStr>(s: &str) -> Option<A> {

}

其中from_str()返回一个Option<A>。如果转换成功,它会返回Some(value); 如果失败,直接返回None。对于需要提供出错信息的情形,可以使用Result<T, E>类型:

enum Result<T, E> {
    Ok(T),
    Err(E),
}

如果不想处理错误,可以使用unwrap()方法来产生恐慌:

let mut buffer = String::new();
let input = io::stdin().read_line(&mut buffer).unwrap();

ResultErr时,unwrap()panic!,直接退出程序。另一个更好的做法是:

let input = io::stdin().read_line(&mut buffer)
                       .ok()
                       .expect("Failed to read line");

其中ok()Result转换为Optionexpect()unwrap()功能类似, 可以用来提供更多的错误信息。

此外,还可以使用宏try!来封装表达式,当ResultErr时会从当前函数提早返回Err

//! The `adder` crate provides functions that add numbers to other numbers.
//!
//! # Examples
//!
//! ```
//! assert_eq!(4, adder::add_two(2));
//! ```

/// This function adds two to its argument.
///
/// # Examples
///
/// ```
/// use adder::add_two;
///
/// assert_eq!(4, add_two(2));
/// ```
pub fn add_two(a: i32) -> i32 {
    a + 2
}
pub fn add_two(a: i32) -> i32 {
    a + 2
}

#[cfg(test)]
mod test {
    use super::add_two;

    #[test]
    fn it_works() {
        assert_eq!(4, add_two(2));
    }
}
#[test]
#[should_panic(expected = "assertion failed")]
fn it_works() {
    assert_eq!("Hello", "world");
}