← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/functions/string/comparative.rst

  • Committer: Andrew Hutchings
  • Date: 2011-02-01 10:23:22 UTC
  • mto: (2136.1.1 build)
  • mto: This revision was merged to the branch mainline in revision 2137.
  • Revision ID: andrew@linuxjedi.co.uk-20110201102322-oxztcyrjzg3c7yta
Fix counters cleanup

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/functions/string/comparative.rst
1
 
Comparative Functions
2
 
=====================
3
 
 
4
 
LIKE            
5
 
----
6
 
 
7
 
The LIKE operator is used to check if field values match a specified pattern, and searches for less-than-exact but similar values.
8
 
 
9
 
The LIKE operator supports the use of two wildcards. (Wildcards provide more flexibility by allowing any character or group of characters in a string to be acceptable as a match for another string):
10
 
 
11
 
    * Percentage (%): Represents zero or more values.
12
 
    * Underscore (_): Matches exactly one character value.
13
 
 
14
 
In accordance the SQL standard, LIKE performs matching on a per-character basis. It therefore provides results different from the = comparison operator.
15
 
 
16
 
The following SELECT statement includes a WHERE clause in order to search for job titles that start with "DIRECTOR", by using the percentage wildcard after the lookup value.
17
 
 
18
 
For example:
19
 
 
20
 
.. code-block:: mysql
21
 
 
22
 
        SELECT title, field
23
 
        FROM job_detail
24
 
        WHERE title LIKE 'DIRECTOR%'
25
 
        ORDER BY field, title;
26
 
 
27
 
 
28
 
REGEXP
29
 
------
30
 
 
31
 
Returns values that match a regular expression pattern; they are commonly used for creating complex searches. Here is an example of using a REGEXP (Regular Expression) match:
32
 
 
33
 
.. code-block:: mysql
34
 
 
35
 
        SELECT title, category_name
36
 
        FROM film_detail
37
 
        WHERE title REGEXP '^AIRP[LO]'
38
 
        ORDER BY title;
39
 
 
40
 
Other REGEXP examples:
41
 
 
42
 
.. code-block:: mysql
43
 
 
44
 
        SELECT 'abcabc' REGEXP 'abc',    
45
 
        'abcabc' REGEXP 'cb';
46
 
 
47
 
The search pattern may describe only a part of string. To match entire string, use ^ and $ in the search:
48
 
 
49
 
.. code-block:: mysql
50
 
 
51
 
        SELECT 'abc' REGEXP '^abc$', 'abcabc' REGEXP '^abc$';
52
 
 
53
 
        SELECT 'cde' REGEXP '[a-c]+', 'efg' REGEXP '[a-c]+';
54
 
 
55
 
        SELECT 'abcabc' REGEXP 'ABC', 'abcabc' REGEXP BINARY 'ABC';
56
 
 
57
 
 
58
 
STRCMP()
59
 
--------
60
 
 
61
 
The purpose of STRCMP is also to compare two strings. This function returns 0 if two strings are the same, -1 if the first argument is smaller than the second according to the current sort order, and 1 otherwise.