Struct LiteralSql 

pub struct LiteralSql(/* private fields */);

A SQL fragment emitted verbatim into the query text, not bound as a parameter (e.g. literal key names in json_build_object).

Because the contained text bypasses parameter binding, it must never carry untrusted user input. This newtype makes that contract explicit: a value can only be created through LiteralSql::from_static (compile-time safe) or LiteralSql::trusted (a deliberately-named, greppable assertion that the caller vetted the string). The inner String is private, so an Expr::Literal can never be built directly from a bare runtime string.

Implementations

impl LiteralSql

pub fn from_static(text: &'static str) -> Self

Build from a compile-time string. Always safe: a &'static str baked into the binary can never be untrusted user input.

pub fn trusted(text: impl Into<String>) -> Self

Build from a runtime string the caller asserts is trusted (e.g. a schema column name), never raw user input. Prefer Self::from_static when the value is known at compile time.

pub fn as_str(&self) -> &str

The underlying SQL text.

Trait Implementations

impl Clone for LiteralSql

fn clone(&self) -> LiteralSql

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LiteralSql

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

Formats the value using the given formatter.

impl PartialEq for LiteralSql

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for LiteralSql

impl StructuralPartialEq for LiteralSql