1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Copyright © 2021 Alexandra Frydl
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

use crate::prelude::*;

/// A deferred function that will be called when dropped.
#[must_use = "This deferred function runs immediately. Assign it to a guard to run it at the end of the block: `let _guard = defer(…);`"]
pub struct Deferred<F>(ManuallyDrop<F>)
where
  F: FnOnce();

/// Defers a function so that it is called when dropped.
pub fn defer<F>(func: F) -> Deferred<F>
where
  F: FnOnce(),
{
  Deferred(ManuallyDrop::new(func))
}

impl<F> Drop for Deferred<F>
where
  F: FnOnce(),
{
  fn drop(&mut self) {
    let func = unsafe { ManuallyDrop::take(&mut self.0) };

    func();
  }
}