Struct Session 

pub struct Session { /* private fields */ }

The settings a session has, by name.

Every setting the engine has, not only the ones somebody changed. A reader of this is answering “what is it now”, so a name that is missing means the engine does not have that setting rather than that it is at its default.

Implementations

impl Session

pub fn new() -> Self

A session that knows nothing, which is what a caller with no database behind it has.

pub fn set(&mut self, name: &str, value: impl Into<String>)

Records what one setting is now.

pub fn set_time_zone(&mut self, name: &str)

Sets the time zone after it has been validated by the setting layer.

pub fn time_zone(&self) -> &str

The canonical IANA name of the session time zone.

pub fn session_time_zone(&self) -> SessionTimeZone

The parsed zone used by prepared expressions.

pub fn set_default_descending(&mut self, descending: bool)

Sets the direction used by an order item that names none.

pub fn set_default_null_order(&mut self, order: DefaultNullOrder)

Sets how an order item with no null placement is resolved.

pub fn set_integer_division(&mut self, enabled: bool)

Sets whether / is bound as the integer division operator.

pub fn set_ieee_floating_point_ops(&mut self, enabled: bool)

Sets whether floating division and remainder use IEEE answers for zero divisors.

pub fn set_null_on_division_by_zero(&mut self, enabled: bool)

Sets whether division errors caused by a zero divisor become nulls.

pub fn set_order_by_non_integer_literal(&mut self, enabled: bool)

Sets whether a constant non-integer expression is accepted as a sort key.

pub fn set_disable_timestamptz_casts(&mut self, enabled: bool)

Sets whether casts from local timestamps to zoned timestamps are refused.

pub fn set_regex_match_full(&mut self, enabled: bool)

Sets whether regex match operators require the entire string to match.

pub fn set_show_behavior(&mut self, behavior: ShowBehavior)

Sets how SHOW name resolves its name.

pub fn semantics(&self) -> Semantics

The meaning-changing choices the binder resolves into the plan.

pub fn knows_time_zone(name: &str) -> bool

Whether the bundled time-zone database knows this name.

pub fn offset_seconds_at(&self, micros: i64) -> i32

The UTC offset in seconds at an instant expressed as Unix microseconds.

pub fn local_micros(&self, micros: i64) -> i64

A UTC instant shifted to the wall clock of this session.

pub fn get(&self, name: &str) -> Option<&str>

What that setting is now, and None for a name this session has no answer for.

pub fn iter(&self) -> impl Iterator<Item = (&str, &str)>

Every setting and its value, in name order.

pub fn is_empty(&self) -> bool

Whether nothing has been recorded.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.

impl Default for Session

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Session

impl PartialEq for Session

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Session