Struct WindowSpecRef 

pub struct WindowSpecRef<'a> {
    pub partition_by: SmallVec<[Cow<'a, str>; 4]>,
    pub order_by: SmallVec<[(Cow<'a, str>, SortOrder); 4]>,
    pub frame: Option<FrameRef<'a>>,
    pub window_ref: Option<Cow<'a, str>>,
}

A zero-copy window specification using borrowed column references.

This is more efficient than WindowSpec when working with string literals.

Example

use prax_query::zero_copy::WindowSpecRef;
use prax_query::sql::DatabaseType;

// All column names are borrowed - no allocations
let spec = WindowSpecRef::new()
    .partition_by(&["dept", "team"])
    .order_by_asc("salary")
    .rows_unbounded_preceding();

let sql = spec.to_sql(DatabaseType::PostgreSQL);

Fields

partition_by: SmallVec<[Cow<'a, str>; 4]>

Partition by columns (borrowed slice or owned vec).

order_by: SmallVec<[(Cow<'a, str>, SortOrder); 4]>

Order by columns with direction.

frame: Option<FrameRef<'a>>

Frame clause.

window_ref: Option<Cow<'a, str>>

Reference to named window.

Implementations

impl<'a> WindowSpecRef<'a>

pub fn new() -> Self

Create a new empty window spec.

pub fn partition_by(self, columns: &[&'a str]) -> Self

Add partition by columns from a slice (zero-copy).

pub fn partition_by_owned<I, S>(self, columns: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Add partition by columns (owned).

pub fn partition_by_col(self, column: &'a str) -> Self

Add a single partition column (borrowed).

pub fn order_by_asc(self, column: &'a str) -> Self

Add order by column ascending (borrowed).

pub fn order_by_desc(self, column: &'a str) -> Self

Add order by column descending (borrowed).

pub fn order_by(self, column: &'a str, order: SortOrder) -> Self

Add order by column with direction (borrowed).

pub fn order_by_owned(self, column: String, order: SortOrder) -> Self

Add order by column (owned).

pub fn rows( self, start: FrameBoundRef<'a>, end: Option<FrameBoundRef<'a>>, ) -> Self

Set ROWS frame.

pub fn range( self, start: FrameBoundRef<'a>, end: Option<FrameBoundRef<'a>>, ) -> Self

Set RANGE frame.

pub fn rows_unbounded_preceding(self) -> Self

Set ROWS UNBOUNDED PRECEDING frame (common for running totals).

pub fn window_name(self, name: &'a str) -> Self

Set reference to named window.

pub fn is_zero_copy(&self) -> bool

Check if this spec uses only borrowed data.

pub fn to_sql(&self, _db_type: DatabaseType) -> String

Generate SQL for the OVER clause.

Trait Implementations

impl<'a> Clone for WindowSpecRef<'a>

fn clone(&self) -> WindowSpecRef<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for WindowSpecRef<'a>

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

Formats the value using the given formatter.

impl<'a> Default for WindowSpecRef<'a>

fn default() -> WindowSpecRef<'a>

Returns the “default value” for a type.