Skip to main content

ParseLimits

Struct ParseLimits 

Source
pub struct ParseLimits { /* private fields */ }
Expand description

The bounds applied to one parse.

Both values are carried rather than fixed, so a caller that knows its own workload may raise or lower them without editing this module.

Implementations§

Source§

impl ParseLimits

Source

pub fn from_server(config: &Config) -> Result<Self>

Builds the bounds a statement is read under for this destination.

Two ceilings meet here and neither may be mistaken for the other. The parser guard is this product’s own and protects the thread the parser runs on; the packet ceiling belongs to the destination and decides what it will accept in one piece. What they share is that a statement larger than the packet ceiling can never be sent, so reading it costs nothing but time, and the smaller of the two is therefore what the parser is entered with.

The packet ceiling is settled here and nowhere else, and the order is the requirement: the stored key wins when it was written, the server’s own answer applies when it was not, and no number in this source is ever used. An invocation that has reached no server has neither, and then nothing is settled at all — there is no send to measure, so a ceiling invented here would refuse a command no server ever objected to.

§The defect this shape was written to close

The paragraph above said no number in this source is ever used, and a number in this source was used: the smaller of the two ceilings was taken against DEFAULT_MAX_STATEMENT_BYTES, one mebibyte written into crate::sql::parse. A caller who raised the published conn.max_packet_bytes to sixty-four mebibytes went on reading one, and the invocation ended in zero with nothing said.

That is the costliest shape hardcoding takes. A number standing where no setting exists is merely invisible; a number ANNULLING a setting that does exist makes the setting appear to work while it does not, and the caller has no way to learn otherwise. Both ceilings are settings now, so the smaller of the two is still taken and the caller can move either.

§Errors

Returns a configuration failure when a stored ceiling is outside its domain.

Source§

impl ParseLimits

Source

pub const fn new(max_statement_bytes: usize, parser_stack_bytes: usize) -> Self

Builds bounds from explicit values.

A zero in either position is replaced by the default, because a bound of zero would refuse every statement or hand the parser no stack at all.

Source

pub const fn max_statement_bytes(self) -> usize

The largest statement accepted, in bytes.

Source

pub const fn parser_stack_bytes(self) -> usize

The stack given to the parser thread, in bytes.

Trait Implementations§

Source§

impl Clone for ParseLimits

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for ParseLimits

Source§

impl Debug for ParseLimits

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for ParseLimits

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Eq for ParseLimits

Source§

impl PartialEq for ParseLimits

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for ParseLimits

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> AnyEq for T
where T: Any + PartialEq,

Source§

fn equals(&self, other: &(dyn Any + 'static)) -> bool

Source§

fn as_any(&self) -> &(dyn Any + 'static)

Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more