Enum Overflow 

#[non_exhaustive]
pub enum Overflow {
    Block,
    DropNewest,
}

Available on crate feature std only.

What NonBlocking does when its queue is full.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Block

Wait for space. No record is ever dropped; under sustained overload the logging threads slow down to the writer’s pace.

A record at or above the logger’s flush level (see crate::LoggerBuilder::flush_on, default Error) waits until everything queued before it has been written and the writer flushed, so it has reached the OS when the logging call returns.

DropNewest

Drop the record that did not fit and count it (see NonBlocking::dropped).

Logging never waits on the writer: a record at or above the logger’s flush level only queues a flush request for the worker (skipped if the queue is full, since the worker flushes as soon as it drains the queue), so it is not yet durable when the call returns. Call crate::Logger::flush to wait. The one wait left is on shutdown: while Sink::shutdown drains the queue, records from other threads wait for it to finish and are then written synchronously, so they are not lost.

Trait Implementations

impl Clone for Overflow

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Overflow

impl Debug for Overflow

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

Formats the value using the given formatter.

impl Default for Overflow

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Overflow

impl PartialEq for Overflow

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Overflow