当前位置: 首页 > 文档资料 > 通过例子学 Rust >

标准库类型 - 结果 Result

优质
小牛编辑
133浏览
2023-12-01

我们前面已经看到 Option 枚举可以用于函数可能失败的返回值,其中 None 可以返回以表明失败。但是有时要强调为什么一个操作会失败。为达成这点,我们提供了 Result 枚举。

Result<T, E> 枚举拥有两个变量:

  • Ok(value) 表示操作成功,并装包操作返回的 valuevalue 拥有 T 类型)。
  • Err(why),表示操作失败,并装包 why,它(能按照所希望的方式)解释了失败的原因(why 拥有 E 类型)。
  1. mod checked {
  2. // 我们想要捕获的数学“错误”
  3. #[derive(Debug)]
  4. pub enum MathError {
  5. DivisionByZero,
  6. NegativeLogarithm,
  7. NegativeSquareRoot,
  8. }
  9. pub type MathResult = Result<f64, MathError>;
  10. pub fn div(x: f64, y: f64) -> MathResult {
  11. if y == 0.0 {
  12. // 此操作将会失败,反而让我们返回失败的理由,并装包成 `Err`
  13. Err(MathError::DivisionByZero)
  14. } else {
  15. // 此操作是有效的,返回装包成 `Ok` 的结果
  16. Ok(x / y)
  17. }
  18. }
  19. pub fn sqrt(x: f64) -> MathResult {
  20. if x < 0.0 {
  21. Err(MathError::NegativeSquareRoot)
  22. } else {
  23. Ok(x.sqrt())
  24. }
  25. }
  26. pub fn ln(x: f64) -> MathResult {
  27. if x < 0.0 {
  28. Err(MathError::NegativeLogarithm)
  29. } else {
  30. Ok(x.ln())
  31. }
  32. }
  33. }
  34. // `op(x, y)` === `sqrt(ln(x / y))`
  35. fn op(x: f64, y: f64) -> f64 {
  36. // 这是一个三层的匹配金字塔!
  37. // (原文:This is a three level match pyramid!)
  38. match checked::div(x, y) {
  39. Err(why) => panic!("{:?}", why),
  40. Ok(ratio) => match checked::ln(ratio) {
  41. Err(why) => panic!("{:?}", why),
  42. Ok(ln) => match checked::sqrt(ln) {
  43. Err(why) => panic!("{:?}", why),
  44. Ok(sqrt) => sqrt,
  45. },
  46. },
  47. }
  48. }
  49. fn main() {
  50. // 这会失败吗?
  51. println!("{}", op(1.0, 10.0));
  52. }