← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

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

  • Committer: Monty Taylor
  • Date: 2011-03-15 16:10:15 UTC
  • mfrom: (2235.3.1 staging)
  • Revision ID: mordred@inaugust.com-20110315161015-qceggirmf3cct7cw
Merge in libdrizzle install changes, doc changes and some header
refactoring.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/functions/string/modification.rst
 
1
String Modification Functions
 
2
=============================
 
3
 
 
4
CONCAT
 
5
------
 
6
 
 
7
The SQL standard defines a concatenation operator ( || ), which joins two or more strings into one string value.
 
8
The CONCAT(str1, str2...) function can have one or more arguments. It returns a string that is the result of concatenating the arguments.
 
9
 
 
10
* If arguments are non-binary strings, the result is also a non-binary string.
 
11
* If any argument is a binary string, then the result will also be a binary string. 
 
12
* Numeric arguments are converted to their equivalent in binary string format. 
 
13
* If any argument is NULL then it also returns NULL. 
 
14
 
 
15
Syntax:
 
16
 
 
17
CONCAT(str1, str2, [,...n])
 
18
For example:
 
19
 
 
20
.. code-block:: mysql
 
21
 
 
22
        SELECT CONCAT('Dr', 'izzl', 'ed');
 
23
 
 
24
Returns: 'Drizzled'
 
25
 
 
26
.. code-block:: mysql
 
27
 
 
28
        SELECT CONCAT('micro', NULL, 'nel');
 
29
 
 
30
Returns: NULL
 
31
 
 
32
.. code-block:: mysql
 
33
 
 
34
        SELECT CONCAT(14.8);
 
35
 
 
36
Returns: '14.8'
 
37
 
 
38
CONCAT_WS
 
39
---------
 
40
CONCAT WS (With Separator) [1]_ allows you to specify that the first argument is treated as a separator for the rest of the arguments. This argument is added between the strings to be concatenated.
 
41
 
 
42
Syntax:
 
43
 
 
44
CONCAT_WS(separator str1, str2,....)
 
45
 
 
46
For example:
 
47
 
 
48
.. code-block:: mysql
 
49
 
 
50
        SELECT CONCAT_WS(',', ' Occupation', 'First name', 'Last Name');
 
51
 
 
52
Returns: 'Occupation, First name, Last Name'
 
53
 
 
54
.. code-block:: mysql
 
55
 
 
56
        SELECT CONCAT_WS(',', 'First name', NULL, 'Last Name');
 
57
 
 
58
Returns: 'First name, Last Name'
 
59
 
 
60
 
 
61
TRIM()
 
62
------
 
63
 
 
64
The TRIM function remove specified prefixes or suffixes from a string (typically leading and trailing spaces), and returns the resulting string. If none of the specifiers BOTH, LEADING, or TRAILING is given, BOTH is assumed.
 
65
 
 
66
Syntax:
 
67
 
 
68
TRIM([{BOTH | LEADING | TRAILING} [remstr] FROM] str), TRIM([remstr FROM] str)
 
69
 
 
70
[remstr] is optional (if it's not specified, spaces are removed).
 
71
 
 
72
LTRIM()
 
73
-------
 
74
 
 
75
This version of the TRIM function removes leading spaces from the beginning of a string.
 
76
 
 
77
 
 
78
RTRIM()
 
79
-------
 
80
 
 
81
This version of the TRIM function removes trailing spaces from the end of a function. 
 
82
 
 
83
.. rubric:: Footnotes
 
84
 
 
85
.. [1] If the separator is NULL then the result is NULL.