Struct TemplateArg 

pub struct TemplateArg<'q, DB: Database, D> { /* private fields */ }

SQL template argument processor handling safe parameter encoding and placeholder generation

Generic Parameters

• 't: Lifetime for database arguments
• DB: Database type implementing [sqlx::Database]
• D: Template data type

Implementations

impl<'q, DB: Database, D> TemplateArg<'q, DB, D>

pub fn new(d: &'q D) -> Self

Creates a new TemplateArg instance wrapping template data

Arguments

• d - Reference to template data with lifetime 't

pub fn set_encode_placeholder_fn(&mut self, f: fn(usize, &mut String))

Sets custom placeholder formatting function

Arguments

• f - Function that takes parameter index and appends placeholder

pub fn e<'t, ImplEncode>(&self, t: ImplEncode) -> String

where ImplEncode: Encode<'t, DB> + Type<DB>,

Encodes a single parameter and returns its placeholder

Arguments

• t - Value implementing [sqlx::Encode] and [sqlx::Type]

Returns

Placeholder string (e.g., $1 or ?)

Example

let placeholder = arg.e(user_id);

pub fn el<'t, ImplEncode>( &self, args: impl IntoIterator<Item = ImplEncode>, ) -> String

where ImplEncode: Encode<'t, DB> + Type<DB>,

Encodes an iterable of parameters and returns parenthesized placeholders

Arguments

• args - Iterator of encodable values

Returns

Comma-separated placeholders wrapped in parentheses

Example

let placeholders = arg.el(&[1, 2, 3]);

pub fn get_err(&self) -> Option<Error>

Takes any encoding error that occurred

pub fn get_arguments(&self) -> Option<DB::Arguments>

Takes ownership of the encoded arguments

Trait Implementations

impl<'t, DB: Database, D> Deref for TemplateArg<'t, DB, D>

type Target = &'t D

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.