Enum SQLChunk 

pub enum SQLChunk<'a, V: SQLParam> {
    Token(Token),
    Ident(Cow<'a, str>),
    Raw(Cow<'a, str>),
    Number(usize),
    Param(Param<'a, V>),
    Table(TableSqlRef),
    Column(ColumnSqlRef),
}

One piece of a SQL fragment.

The renderer puts spaces between chunks where SQL needs them, so chunks never carry their own surrounding whitespace.

Variants

Token(Token)

A keyword, operator or punctuation: SELECT, =, (, …

Ident(Cow<'a, str>)

A quoted identifier (table, column or alias name): "name", or `name` for MySQL.

Raw(Cow<'a, str>)

Raw SQL text, written as-is with no quoting: function names, expressions.

Number(usize)

An unsigned integer literal written into the SQL text, for clauses such as LIMIT and OFFSET that are not parameterized.

Param(Param<'a, V>)

A placeholder and its bound value: ?, $1 or :name, depending on the dialect and the placeholder.

Table(TableSqlRef)

A table, rendered as "schema"."table" or "table". Its column names are used to expand an empty SELECT projection.

Column(ColumnSqlRef)

A column, rendered as "table"."column".

Implementations

impl<'a, V: SQLParam> SQLChunk<'a, V>

pub const fn token(t: Token) -> Self

Creates a token chunk.

pub const fn ident_static(name: &'static str) -> Self

Creates a quoted identifier from a static string.

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

Creates raw SQL text from a static string.

pub const fn table(table: TableRef) -> Self

Creates a table chunk.

pub const fn column(column: ColumnRef) -> Self

Creates a column chunk.

pub const fn param_borrowed(value: &'a V, placeholder: Placeholder) -> Self

Creates a parameter chunk that borrows its value.

pub fn ident(name: impl Into<Cow<'a, str>>) -> Self

Creates a quoted identifier.

pub fn raw(text: impl Into<Cow<'a, str>>) -> Self

Creates raw SQL text.

pub const fn number(value: usize) -> Self

Creates an unsigned integer literal chunk.

pub fn param(value: impl Into<Cow<'a, V>>, placeholder: Placeholder) -> Self

Creates a parameter chunk with a value and placeholder.

Trait Implementations

impl<'a, V: Clone + SQLParam> Clone for SQLChunk<'a, V>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<V: SQLParam + Debug> Debug for SQLChunk<'_, V>

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

Formats the value using the given formatter.

impl<V: SQLParam> From<ColumnRef> for SQLChunk<'_, V>

fn from(value: ColumnRef) -> Self

Converts to this type from the input type.

impl<V: SQLParam> From<OwnedSQLChunk<V>> for SQLChunk<'static, V>

fn from(value: OwnedSQLChunk<V>) -> Self

Converts to this type from the input type.

impl<'a, V: SQLParam> From<Param<'a, V>> for SQLChunk<'a, V>

fn from(value: Param<'a, V>) -> Self

Converts to this type from the input type.

impl<'a, V: SQLParam> From<SQLChunk<'a, V>> for OwnedSQLChunk<V>

fn from(value: SQLChunk<'a, V>) -> Self

Converts to this type from the input type.

impl<V: SQLParam> From<TableRef> for SQLChunk<'_, V>

fn from(value: TableRef) -> Self

Converts to this type from the input type.

impl<V: SQLParam> From<Token> for SQLChunk<'_, V>

fn from(value: Token) -> Self

Converts to this type from the input type.