W3cubDocs

/Rust

Enum std::heap::AllocErr

pub enum AllocErr {
    Exhausted {
        request: Layout,
    },
    Unsupported {
        details: &'static str,
    },
}
🔬 This is a nightly-only experimental API. (allocator_api #32838)the precise API and guarantees it provides may be tweaked slightly, especially to possibly take into account the types being stored to make room for a future tracing garbage collector

The AllocErr error specifies whether an allocation failure is specifically due to resource exhaustion or if it is due to something wrong when combining the given input arguments with this allocator.

Variants

🔬 This is a nightly-only experimental API. (allocator_api #32838)the precise API and guarantees it provides may be tweaked slightly, especially to possibly take into account the types being stored to make room for a future tracing garbage collector

Error due to hitting some resource limit or otherwise running out of memory. This condition strongly implies that some series of deallocations would allow a subsequent reissuing of the original allocation request to succeed.

Fields of Exhausted

🔬 This is a nightly-only experimental API. (allocator_api #32838)the precise API and guarantees it provides may be tweaked slightly, especially to possibly take into account the types being stored to make room for a future tracing garbage collector
🔬 This is a nightly-only experimental API. (allocator_api #32838)the precise API and guarantees it provides may be tweaked slightly, especially to possibly take into account the types being stored to make room for a future tracing garbage collector

Error due to allocator being fundamentally incapable of satisfying the original request. This condition implies that such an allocation request will never succeed on the given allocator, regardless of environment, memory pressure, or other contextual conditions.

For example, an allocator that does not support requests for large memory blocks might return this error variant.

Fields of Unsupported

🔬 This is a nightly-only experimental API. (allocator_api #32838)the precise API and guarantees it provides may be tweaked slightly, especially to possibly take into account the types being stored to make room for a future tracing garbage collector

Methods

impl AllocErr [src]

[src]

🔬 This is a nightly-only experimental API. (allocator_api #32838)the precise API and guarantees it provides may be tweaked slightly, especially to possibly take into account the types being stored to make room for a future tracing garbage collector

[src]

🔬 This is a nightly-only experimental API. (allocator_api #32838)the precise API and guarantees it provides may be tweaked slightly, especially to possibly take into account the types being stored to make room for a future tracing garbage collector

[src]

🔬 This is a nightly-only experimental API. (allocator_api #32838)the precise API and guarantees it provides may be tweaked slightly, especially to possibly take into account the types being stored to make room for a future tracing garbage collector

[src]

🔬 This is a nightly-only experimental API. (allocator_api #32838)the precise API and guarantees it provides may be tweaked slightly, especially to possibly take into account the types being stored to make room for a future tracing garbage collector

Trait Implementations

impl PartialEq<AllocErr> for AllocErr [src]

[src]

This method tests for self and other values to be equal, and is used by ==. Read more

[src]

This method tests for !=.

impl Debug for AllocErr [src]

[src]

Formats the value using the given formatter. Read more

impl Clone for AllocErr [src]

[src]

Returns a copy of the value. Read more

1.0.0
[src]

Performs copy-assignment from source. Read more

impl Eq for AllocErr [src]

impl Display for AllocErr [src]

[src]

Formats the value using the given formatter. Read more

impl Error for AllocErr [src]

[src]

A short description of the error. Read more

1.0.0
[src]

The lower-level cause of this error, if any. Read more

© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/heap/enum.AllocErr.html