diesel/expression_methods/
escape_expression_methods.rs

Help
1use crate::dsl;
2use crate::expression::grouped::Grouped;
3use crate::expression::operators::{Escape, Like, NotLike};
4use crate::expression::IntoSql;
5use crate::sql_types::VarChar;
6
7/// Adds the `escape` method to `LIKE` and `NOT LIKE`. This is used to specify
8/// the escape character for the pattern.
9///
10/// By default, the escape character is `\` on most backends. On SQLite,
11/// there is no default escape character.
12///
13/// # Example
14///
15/// ```rust
16/// # include!("../doctest_setup.rs");
17/// #
18/// # fn main() {
19/// #     use schema::users::dsl::*;
20/// #     use diesel::insert_into;
21/// #     let connection = &mut establish_connection();
22/// #     insert_into(users).values(name.eq("Ha%%0r"))
23/// #         .execute(connection).unwrap();
24/// let users_with_percent = users.select(name)
25///     .filter(name.like("%😀%%").escape('😀'))
26///     .load(connection);
27/// let users_without_percent = users.select(name)
28///     .filter(name.not_like("%a%%").escape('a'))
29///     .load(connection);
30/// assert_eq!(Ok(vec![String::from("Ha%%0r")]), users_with_percent);
31/// assert_eq!(Ok(vec![String::from("Sean"), String::from("Tess")]), users_without_percent);
32/// # }
33/// ```
34pub trait EscapeExpressionMethods: Sized {
35    #[doc(hidden)]
36    type TextExpression;
37
38    /// See the trait documentation.
39    fn escape(self, _character: char) -> dsl::Escape<Self>;
40}
41
42impl<T, U> EscapeExpressionMethods for Grouped<Like<T, U>> {
43    type TextExpression = Like<T, U>;
44
45    fn escape(self, character: char) -> dsl::Escape<Self> {
46        Grouped(Escape::new(
47            self.0,
48            character.to_string().into_sql::<VarChar>(),
49        ))
50    }
51}
52
53impl<T, U> EscapeExpressionMethods for Grouped<NotLike<T, U>> {
54    type TextExpression = NotLike<T, U>;
55
56    fn escape(self, character: char) -> dsl::Escape<Self> {
57        Grouped(Escape::new(
58            self.0,
59            character.to_string().into_sql::<VarChar>(),
60        ))
61    }
62}
diesel/expression_methods/escape_expression_methods.rs

diesel/expression_methods/
escape_expression_methods.rs
