dylink 0.5.0

Run-time dynamic linking loader utilities
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

// Copyright (c) 2023 Jonathan "Razordor" Alan Thomason

use std::{error, fmt};

/// The error enumeration dylink uses to define the error status.
///
/// This error structure may propagate from a dylink'd function generated from [dylink](crate::dylink).
#[non_exhaustive]
#[derive(Debug, Clone)]
pub enum DylinkError {
	/// The library was loaded, but the function was not.
	FnNotFound(String),
	/// The library was not loaded.
	LibNotLoaded(String),
	/// All the libraries were not loaded.
	ListNotLoaded(String),
}

impl error::Error for DylinkError {}

impl fmt::Display for DylinkError {
	fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
		let err = match &self {
			Self::FnNotFound(fn_name) => format!("function `{fn_name}` not found"),
			Self::LibNotLoaded(lib_name) => format!("library `{lib_name}` could not be loaded"),
			Self::ListNotLoaded(msgs) => {
				// This makes the formatting slightly less recursive looking.
				return write!(f, "Dylink Error(s):\n{msgs}");
			}
		};
		write!(f, "Dylink Error: {err}")
	}
}