diesel/expression/functions/aggregate_folding.rs
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 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67
use crate::expression::functions::define_sql_function;
use crate::sql_types::Foldable;
define_sql_function! {
/// Represents a SQL `SUM` function. This function can only take types which are
/// Foldable.
///
/// # Examples
///
/// ```rust
/// # include!("../../doctest_setup.rs");
/// # use diesel::dsl::*;
/// #
/// # fn main() {
/// # use schema::animals::dsl::*;
/// # let connection = &mut establish_connection();
/// assert_eq!(Ok(Some(12i64)), animals.select(sum(legs)).first(connection));
/// # }
/// ```
#[aggregate]
fn sum<ST: Foldable>(expr: ST) -> ST::Sum;
}
define_sql_function! {
/// Represents a SQL `AVG` function. This function can only take types which are
/// Foldable.
///
/// # Examples
///
/// ```rust
/// # include!("../../doctest_setup.rs");
/// # use diesel::dsl::*;
/// # #[cfg(feature = "numeric")]
/// # extern crate bigdecimal;
/// #
/// # fn main() {
/// # run_test().unwrap();
/// # }
/// #
/// # table! {
/// # numbers (number) {
/// # number -> Integer,
/// # }
/// # }
/// #
/// # #[cfg(all(feature = "numeric", any(feature = "postgres", not(feature = "sqlite"))))]
/// # fn run_test() -> QueryResult<()> {
/// # use bigdecimal::BigDecimal;
/// # use self::numbers::dsl::*;
/// # let conn = &mut establish_connection();
/// # diesel::sql_query("CREATE TEMPORARY TABLE numbers (number INTEGER)").execute(conn)?;
/// diesel::insert_into(numbers)
/// .values(&vec![number.eq(1), number.eq(2)])
/// .execute(conn)?;
/// let average = numbers.select(avg(number)).get_result(conn)?;
/// let expected = "1.5".parse::<BigDecimal>().unwrap();
/// assert_eq!(Some(expected), average);
/// # Ok(())
/// # }
/// #
/// # #[cfg(not(all(feature = "numeric", any(feature = "postgres", not(feature = "sqlite")))))]
/// # fn run_test() -> QueryResult<()> {
/// # Ok(())
/// # }
#[aggregate]
fn avg<ST: Foldable>(expr: ST) -> ST::Avg;
}