library/core/tests/result.rs

   1 use core::ops::DerefMut;
   2 use core::option::*;
   3
   4 fn op1() -> Result<isize, &'static str> {
   5     Ok(666)
   6 }
   7 fn op2() -> Result<isize, &'static str> {
   8     Err("sadface")
   9 }
  10
  11 #[test]
  12 fn test_and() {
  13     assert_eq!(op1().and(Ok(667)).unwrap(), 667);
  14     assert_eq!(op1().and(Err::<i32, &'static str>("bad")).unwrap_err(), "bad");
  15
  16     assert_eq!(op2().and(Ok(667)).unwrap_err(), "sadface");
  17     assert_eq!(op2().and(Err::<i32, &'static str>("bad")).unwrap_err(), "sadface");
  18 }
  19
  20 #[test]
  21 fn test_and_then() {
  22     assert_eq!(op1().and_then(|i| Ok::<isize, &'static str>(i + 1)).unwrap(), 667);
  23     assert_eq!(op1().and_then(|_| Err::<isize, &'static str>("bad")).unwrap_err(), "bad");
  24
  25     assert_eq!(op2().and_then(|i| Ok::<isize, &'static str>(i + 1)).unwrap_err(), "sadface");
  26     assert_eq!(op2().and_then(|_| Err::<isize, &'static str>("bad")).unwrap_err(), "sadface");
  27 }
  28
  29 #[test]
  30 fn test_or() {
  31     assert_eq!(op1().or(Ok::<_, &'static str>(667)).unwrap(), 666);
  32     assert_eq!(op1().or(Err("bad")).unwrap(), 666);
  33
  34     assert_eq!(op2().or(Ok::<_, &'static str>(667)).unwrap(), 667);
  35     assert_eq!(op2().or(Err("bad")).unwrap_err(), "bad");
  36 }
  37
  38 #[test]
  39 fn test_or_else() {
  40     assert_eq!(op1().or_else(|_| Ok::<isize, &'static str>(667)).unwrap(), 666);
  41     assert_eq!(op1().or_else(|e| Err::<isize, &'static str>(e)).unwrap(), 666);
  42
  43     assert_eq!(op2().or_else(|_| Ok::<isize, &'static str>(667)).unwrap(), 667);
  44     assert_eq!(op2().or_else(|e| Err::<isize, &'static str>(e)).unwrap_err(), "sadface");
  45 }
  46
  47 #[test]
  48 fn test_impl_map() {
  49     assert!(Ok::<isize, isize>(1).map(|x| x + 1) == Ok(2));
  50     assert!(Err::<isize, isize>(1).map(|x| x + 1) == Err(1));
  51 }
  52
  53 #[test]
  54 fn test_impl_map_err() {
  55     assert!(Ok::<isize, isize>(1).map_err(|x| x + 1) == Ok(1));
  56     assert!(Err::<isize, isize>(1).map_err(|x| x + 1) == Err(2));
  57 }
  58
  59 #[test]
  60 fn test_collect() {
  61     let v: Result<Vec<isize>, ()> = (0..0).map(|_| Ok::<isize, ()>(0)).collect();
  62     assert!(v == Ok(vec![]));
  63
  64     let v: Result<Vec<isize>, ()> = (0..3).map(|x| Ok::<isize, ()>(x)).collect();
  65     assert!(v == Ok(vec![0, 1, 2]));
  66
  67     let v: Result<Vec<isize>, isize> = (0..3).map(|x| if x > 1 { Err(x) } else { Ok(x) }).collect();
  68     assert!(v == Err(2));
  69
  70     // test that it does not take more elements than it needs
  71     let mut functions: [Box<dyn Fn() -> Result<(), isize>>; 3] =
  72         [box || Ok(()), box || Err(1), box || panic!()];
  73
  74     let v: Result<Vec<()>, isize> = functions.iter_mut().map(|f| (*f)()).collect();
  75     assert!(v == Err(1));
  76 }
  77
  78 #[test]
  79 fn test_fmt_default() {
  80     let ok: Result<isize, &'static str> = Ok(100);
  81     let err: Result<isize, &'static str> = Err("Err");
  82
  83     let s = format!("{:?}", ok);
  84     assert_eq!(s, "Ok(100)");
  85     let s = format!("{:?}", err);
  86     assert_eq!(s, "Err(\"Err\")");
  87 }
  88
  89 #[test]
  90 fn test_unwrap_or() {
  91     let ok: Result<isize, &'static str> = Ok(100);
  92     let ok_err: Result<isize, &'static str> = Err("Err");
  93
  94     assert_eq!(ok.unwrap_or(50), 100);
  95     assert_eq!(ok_err.unwrap_or(50), 50);
  96 }
  97
  98 #[test]
  99 fn test_unwrap_or_else() {
 100     fn handler(msg: &'static str) -> isize {
 101         if msg == "I got this." { 50 } else { panic!("BadBad") }
 102     }
 103
 104     let ok: Result<isize, &'static str> = Ok(100);
 105     let ok_err: Result<isize, &'static str> = Err("I got this.");
 106
 107     assert_eq!(ok.unwrap_or_else(handler), 100);
 108     assert_eq!(ok_err.unwrap_or_else(handler), 50);
 109 }
 110
 111 #[test]
 112 #[should_panic]
 113 pub fn test_unwrap_or_else_panic() {
 114     fn handler(msg: &'static str) -> isize {
 115         if msg == "I got this." { 50 } else { panic!("BadBad") }
 116     }
 117
 118     let bad_err: Result<isize, &'static str> = Err("Unrecoverable mess.");
 119     let _: isize = bad_err.unwrap_or_else(handler);
 120 }
 121
 122 #[test]
 123 fn test_unwrap_unchecked() {
 124     let ok: Result<isize, &'static str> = Ok(100);
 125     assert_eq!(unsafe { ok.unwrap_unchecked() }, 100);
 126 }
 127
 128 #[test]
 129 fn test_unwrap_err_unchecked() {
 130     let ok_err: Result<isize, &'static str> = Err("Err");
 131     assert_eq!(unsafe { ok_err.unwrap_err_unchecked() }, "Err");
 132 }
 133
 134 #[test]
 135 pub fn test_expect_ok() {
 136     let ok: Result<isize, &'static str> = Ok(100);
 137     assert_eq!(ok.expect("Unexpected error"), 100);
 138 }
 139 #[test]
 140 #[should_panic(expected = "Got expected error: \"All good\"")]
 141 pub fn test_expect_err() {
 142     let err: Result<isize, &'static str> = Err("All good");
 143     err.expect("Got expected error");
 144 }
 145
 146 #[test]
 147 pub fn test_expect_err_err() {
 148     let ok: Result<&'static str, isize> = Err(100);
 149     assert_eq!(ok.expect_err("Unexpected ok"), 100);
 150 }
 151 #[test]
 152 #[should_panic(expected = "Got expected ok: \"All good\"")]
 153 pub fn test_expect_err_ok() {
 154     let err: Result<&'static str, isize> = Ok("All good");
 155     err.expect_err("Got expected ok");
 156 }
 157
 158 #[test]
 159 pub fn test_iter() {
 160     let ok: Result<isize, &'static str> = Ok(100);
 161     let mut it = ok.iter();
 162     assert_eq!(it.size_hint(), (1, Some(1)));
 163     assert_eq!(it.next(), Some(&100));
 164     assert_eq!(it.size_hint(), (0, Some(0)));
 165     assert!(it.next().is_none());
 166     assert_eq!((&ok).into_iter().next(), Some(&100));
 167
 168     let err: Result<isize, &'static str> = Err("error");
 169     assert_eq!(err.iter().next(), None);
 170 }
 171
 172 #[test]
 173 pub fn test_iter_mut() {
 174     let mut ok: Result<isize, &'static str> = Ok(100);
 175     for loc in ok.iter_mut() {
 176         *loc = 200;
 177     }
 178     assert_eq!(ok, Ok(200));
 179     for loc in &mut ok {
 180         *loc = 300;
 181     }
 182     assert_eq!(ok, Ok(300));
 183
 184     let mut err: Result<isize, &'static str> = Err("error");
 185     for loc in err.iter_mut() {
 186         *loc = 200;
 187     }
 188     assert_eq!(err, Err("error"));
 189 }
 190
 191 #[test]
 192 pub fn test_unwrap_or_default() {
 193     assert_eq!(op1().unwrap_or_default(), 666);
 194     assert_eq!(op2().unwrap_or_default(), 0);
 195 }
 196
 197 #[test]
 198 pub fn test_into_ok() {
 199     fn infallible_op() -> Result<isize, !> {
 200         Ok(666)
 201     }
 202
 203     assert_eq!(infallible_op().into_ok(), 666);
 204
 205     enum MyNeverToken {}
 206     impl From<MyNeverToken> for ! {
 207         fn from(never: MyNeverToken) -> ! {
 208             match never {}
 209         }
 210     }
 211
 212     fn infallible_op2() -> Result<isize, MyNeverToken> {
 213         Ok(667)
 214     }
 215
 216     assert_eq!(infallible_op2().into_ok(), 667);
 217 }
 218
 219 #[test]
 220 fn test_try() {
 221     fn try_result_some() -> Option<u8> {
 222         let val = Ok(1)?;
 223         Some(val)
 224     }
 225     assert_eq!(try_result_some(), Some(1));
 226
 227     fn try_result_none() -> Option<u8> {
 228         let val = Err(NoneError)?;
 229         Some(val)
 230     }
 231     assert_eq!(try_result_none(), None);
 232
 233     fn try_result_ok() -> Result<u8, u8> {
 234         let result: Result<u8, u8> = Ok(1);
 235         let val = result?;
 236         Ok(val)
 237     }
 238     assert_eq!(try_result_ok(), Ok(1));
 239
 240     fn try_result_err() -> Result<u8, u8> {
 241         let result: Result<u8, u8> = Err(1);
 242         let val = result?;
 243         Ok(val)
 244     }
 245     assert_eq!(try_result_err(), Err(1));
 246 }
 247
 248 #[test]
 249 fn test_result_as_deref() {
 250     // &Result<T: Deref, E>::Ok(T).as_deref() ->
 251     //      Result<&T::Deref::Target, &E>::Ok(&*T)
 252     let ref_ok = &Result::Ok::<&i32, u8>(&42);
 253     let expected_result = Result::Ok::<&i32, &u8>(&42);
 254     assert_eq!(ref_ok.as_deref(), expected_result);
 255
 256     let ref_ok = &Result::Ok::<String, u32>(String::from("a result"));
 257     let expected_result = Result::Ok::<&str, &u32>("a result");
 258     assert_eq!(ref_ok.as_deref(), expected_result);
 259
 260     let ref_ok = &Result::Ok::<Vec<i32>, u32>(vec![1, 2, 3, 4, 5]);
 261     let expected_result = Result::Ok::<&[i32], &u32>([1, 2, 3, 4, 5].as_slice());
 262     assert_eq!(ref_ok.as_deref(), expected_result);
 263
 264     // &Result<T: Deref, E>::Err(T).as_deref() ->
 265     //      Result<&T::Deref::Target, &E>::Err(&*E)
 266     let val = 41;
 267     let ref_err = &Result::Err::<&u8, i32>(val);
 268     let expected_result = Result::Err::<&u8, &i32>(&val);
 269     assert_eq!(ref_err.as_deref(), expected_result);
 270
 271     let s = String::from("an error");
 272     let ref_err = &Result::Err::<&u32, String>(s.clone());
 273     let expected_result = Result::Err::<&u32, &String>(&s);
 274     assert_eq!(ref_err.as_deref(), expected_result);
 275
 276     let v = vec![5, 4, 3, 2, 1];
 277     let ref_err = &Result::Err::<&u32, Vec<i32>>(v.clone());
 278     let expected_result = Result::Err::<&u32, &Vec<i32>>(&v);
 279     assert_eq!(ref_err.as_deref(), expected_result);
 280 }
 281
 282 #[test]
 283 fn test_result_as_deref_mut() {
 284     // &mut Result<T: DerefMut, E>::Ok(T).as_deref_mut() ->
 285     //      Result<&mut T::DerefMut::Target, &mut E>::Ok(&mut *T)
 286     let mut val = 42;
 287     let mut expected_val = 42;
 288     let mut_ok = &mut Result::Ok::<&mut i32, u8>(&mut val);
 289     let expected_result = Result::Ok::<&mut i32, &mut u8>(&mut expected_val);
 290     assert_eq!(mut_ok.as_deref_mut(), expected_result);
 291
 292     let mut expected_string = String::from("a result");
 293     let mut_ok = &mut Result::Ok::<String, u32>(expected_string.clone());
 294     let expected_result = Result::Ok::<&mut str, &mut u32>(expected_string.deref_mut());
 295     assert_eq!(mut_ok.as_deref_mut(), expected_result);
 296
 297     let mut expected_vec = vec![1, 2, 3, 4, 5];
 298     let mut_ok = &mut Result::Ok::<Vec<i32>, u32>(expected_vec.clone());
 299     let expected_result = Result::Ok::<&mut [i32], &mut u32>(expected_vec.as_mut_slice());
 300     assert_eq!(mut_ok.as_deref_mut(), expected_result);
 301
 302     // &mut Result<T: DerefMut, E>::Err(T).as_deref_mut() ->
 303     //      Result<&mut T, &mut E>::Err(&mut *E)
 304     let mut val = 41;
 305     let mut_err = &mut Result::Err::<&mut u8, i32>(val);
 306     let expected_result = Result::Err::<&mut u8, &mut i32>(&mut val);
 307     assert_eq!(mut_err.as_deref_mut(), expected_result);
 308
 309     let mut expected_string = String::from("an error");
 310     let mut_err = &mut Result::Err::<&mut u32, String>(expected_string.clone());
 311     let expected_result = Result::Err::<&mut u32, &mut String>(&mut expected_string);
 312     assert_eq!(mut_err.as_deref_mut(), expected_result);
 313
 314     let mut expected_vec = vec![5, 4, 3, 2, 1];
 315     let mut_err = &mut Result::Err::<&mut u32, Vec<i32>>(expected_vec.clone());
 316     let expected_result = Result::Err::<&mut u32, &mut Vec<i32>>(&mut expected_vec);
 317     assert_eq!(mut_err.as_deref_mut(), expected_result);
 318 }
 319
 320 #[test]
 321 fn result_const() {
 322     // test that the methods of `Result` are usable in a const context
 323
 324     const RESULT: Result<usize, bool> = Ok(32);
 325
 326     const REF: Result<&usize, &bool> = RESULT.as_ref();
 327     assert_eq!(REF, Ok(&32));
 328
 329     const IS_OK: bool = RESULT.is_ok();
 330     assert!(IS_OK);
 331
 332     const IS_ERR: bool = RESULT.is_err();
 333     assert!(!IS_ERR)
 334 }
 335
 336 #[test]
 337 fn result_opt_conversions() {
 338     #[derive(Copy, Clone, Debug, PartialEq)]
 339     struct BadNumErr;
 340
 341     fn try_num(x: i32) -> Result<i32, BadNumErr> {
 342         if x <= 5 { Ok(x + 1) } else { Err(BadNumErr) }
 343     }
 344
 345     type ResOpt = Result<Option<i32>, BadNumErr>;
 346     type OptRes = Option<Result<i32, BadNumErr>>;
 347
 348     let mut x: ResOpt = Ok(Some(5));
 349     let mut y: OptRes = Some(Ok(5));
 350     assert_eq!(x, y.transpose());
 351     assert_eq!(x.transpose(), y);
 352
 353     x = Ok(None);
 354     y = None;
 355     assert_eq!(x, y.transpose());
 356     assert_eq!(x.transpose(), y);
 357
 358     x = Err(BadNumErr);
 359     y = Some(Err(BadNumErr));
 360     assert_eq!(x, y.transpose());
 361     assert_eq!(x.transpose(), y);
 362
 363     let res: Result<Vec<i32>, BadNumErr> = (0..10)
 364         .map(|x| {
 365             let y = try_num(x)?;
 366             Ok(if y % 2 == 0 { Some(y - 1) } else { None })
 367         })
 368         .filter_map(Result::transpose)
 369         .collect();
 370
 371     assert_eq!(res, Err(BadNumErr))
 372 }