riscv: add result module

Adds the `result` module to contain types for fallible functions.

For discussion, see:
<#212 (comment)>

Author: rmsyn

riscv/src/lib.rs

@@ -40,6 +40,7 @@ pub(crate) mod bits;
 pub mod delay;
 pub mod interrupt;
 pub mod register;
+pub mod result;
 
 #[macro_use]
 mod macros;

riscv/src/result.rs

@@ -0,0 +1,30 @@
+use core::fmt;
+
+/// Convenience alias for the [Result](core::result::Result) type for the library.
+pub type Result<T> = core::result::Result<T, Error>;
+
+/// Represents error variants for the library.
+#[repr(C)]
+#[derive(Clone, Copy, Debug, Eq, PartialEq)]
+pub enum Error {
+    /// Attempted out-of-bounds access.
+    OutOfBounds {
+        index: usize,
+        min: usize,
+        max: usize,
+    },
+    /// Unimplemented function or type.
+    Unimplemented,
+}
+
+impl fmt::Display for Error {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        match self {
+            Self::OutOfBounds { index, min, max } => write!(
+                f,
+                "out-of-bounds access, index: {index}, min: {min}, max: {max}"
+            ),
+            Self::Unimplemented => write!(f, "unimplemented"),
+        }
+    }
+}