sqlint 0.2.2

An abstraction layer for SQL databases.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

use super::Function;
use crate::ast::Expression;

#[derive(Debug, Clone, PartialEq)]
/// Returns the first non-null expression
pub struct Coalesce<'a> {
    pub(crate) exprs: Vec<Expression<'a>>,
}

/// Returns the first non-null argument
///
/// ```rust
/// # use sqlint::{ast::*, visitor::{Visitor, Sqlite}};
/// # fn main() -> Result<(), sqlint::error::Error> {
/// let exprs: Vec<Expression> = vec![
///   Column::from(("users", "company")).into(),
///   Value::text("Individual").into(),
/// ];
/// let query = Select::from_table("users").value(coalesce(exprs));
/// let (sql, params) = Sqlite::build(query)?;
/// assert_eq!("SELECT COALESCE(`users`.`company`, ?) FROM `users`", sql);
/// assert_eq!(vec![Value::text("Individual")], params);
/// # Ok(())
/// # }
/// ```
pub fn coalesce<'a, T, V>(exprs: V) -> Function<'a>
where
    T: Into<Expression<'a>>,
    V: Into<Vec<T>>,
{
    let fun = Coalesce { exprs: exprs.into().into_iter().map(|e| e.into()).collect() };

    fun.into()
}