Struct fallible_alloc::alloc_error::AllocError

pub struct AllocError { /* fields omitted */ }

Crate’s error type describing issues with allocation

Please check possible reasons of issues in AllocErrorType

Usage example:

use fallible_alloc::vec::alloc_with_size;

match alloc_with_size::<f32>(10) {
  Ok(vec) => println!("Created a vec with size 10"),
  Err(error) => println!("Failed to create a vec, reason: {}", error)
}

Implementations

impl AllocError

pub fn new<M: AsRef<str>>(message: M, error_type: AllocErrorType) -> AllocError

Creates a new AllocError

Please check error types in AllocErrorType

Usage example:

use fallible_alloc::alloc_error::AllocError;
use fallible_alloc::alloc_error::AllocErrorType;
let error = AllocError::new("error", AllocErrorType::FailedAllocation);

pub fn message(&self) -> String

AllocError’s message getter

Message is being cloned on return

Usage example:

use fallible_alloc::alloc_error::AllocError;
use fallible_alloc::alloc_error::AllocErrorType;
let error = AllocError::new("error", AllocErrorType::FailedAllocation);
println!("{}", error.message());

pub fn error_type(&self) -> AllocErrorType

AllocError’s type getter

Message is being cloned on return

Usage example:

use fallible_alloc::alloc_error::AllocError;
use fallible_alloc::alloc_error::AllocErrorType;
let error = AllocError::new("error", AllocErrorType::FailedAllocation);
assert_eq!(error.error_type(), AllocErrorType::FailedAllocation);

Trait Implementations

impl Clone for AllocError

fn clone(&self) -> AllocError

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AllocError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for AllocError

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for AllocError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<LayoutError> for AllocError

fn from(error: LayoutError) -> AllocError

Performs the conversion.

impl Hash for AllocError

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Send for AllocError

impl Sync for AllocError