fstapi 0.0.3

API for manipulating Fast Signal Trace (FST) format waveforms.
Documentation 
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
33
34
35
36
37

use crate::utils::IntoCHandle;
use std::fmt;
use std::num::NonZeroU32;

/// Handle type, which is actually a 32-bit non-zero unsigned integer.
#[repr(transparent)]
#[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct Handle(pub(crate) NonZeroU32);

impl Handle {
  /// Creates a new handle.
  pub(crate) fn new(n: u32) -> Option<Self> {
    NonZeroU32::new(n).map(Self)
  }
}

impl From<Handle> for u32 {
  /// Creates a non-zero unsigned integer from the handle.
  fn from(value: Handle) -> Self {
    value.0.into()
  }
}

impl fmt::Display for Handle {
  fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
    self.0.fmt(f)
  }
}

impl IntoCHandle for Option<Handle> {
  fn into_handle(self) -> u32 {
    match self {
      Some(i) => i.into(),
      None => 0,
    }
  }
}