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
use crate::dsl;
use crate::expression::grouped::Grouped;
use crate::expression::operators::{Escape, Like, NotLike};
use crate::expression::IntoSql;
use crate::sql_types::VarChar;
/// Adds the `escape` method to `LIKE` and `NOT LIKE`. This is used to specify
/// the escape character for the pattern.
///
/// By default, the escape character is `\` on most backends. On SQLite,
/// there is no default escape character.
///
/// # Example
///
/// ```rust
/// # include!("../doctest_setup.rs");
/// #
/// # fn main() {
/// # use schema::users::dsl::*;
/// # use diesel::insert_into;
/// # let connection = &mut establish_connection();
/// # insert_into(users).values(name.eq("Ha%%0r"))
/// # .execute(connection).unwrap();
/// let users_with_percent = users.select(name)
/// .filter(name.like("%😀%%").escape('😀'))
/// .load(connection);
/// let users_without_percent = users.select(name)
/// .filter(name.not_like("%a%%").escape('a'))
/// .load(connection);
/// assert_eq!(Ok(vec![String::from("Ha%%0r")]), users_with_percent);
/// assert_eq!(Ok(vec![String::from("Sean"), String::from("Tess")]), users_without_percent);
/// # }
/// ```
pub trait EscapeExpressionMethods: Sized {
#[doc(hidden)]
type TextExpression;
/// See the trait documentation.
fn escape(self, _character: char) -> dsl::Escape<Self>;
}
impl<T, U> EscapeExpressionMethods for Grouped<Like<T, U>> {
type TextExpression = Like<T, U>;
fn escape(self, character: char) -> dsl::Escape<Self> {
Grouped(Escape::new(
self.0,
character.to_string().into_sql::<VarChar>(),
))
}
}
impl<T, U> EscapeExpressionMethods for Grouped<NotLike<T, U>> {
type TextExpression = NotLike<T, U>;
fn escape(self, character: char) -> dsl::Escape<Self> {
Grouped(Escape::new(
self.0,
character.to_string().into_sql::<VarChar>(),
))
}
}