~drizzle-trunk/drizzle/development

String Modification Functions

=============================

 

CONCAT

------

 

The SQL standard defines a concatenation operator ( || ), which joins two or more strings into one string value.


The CONCAT(str1, str2….) function can have one or more arguments. It returns a string that is the result of concatenating the arguments. 

 

* If arguments are non-binary strings, the result is also a non-binary string.

* If any argument is a binary string, then the result will also be a binary string. 

* Numeric arguments are converted to their equivalent in binary string format. 

* If any argument is NULL then it also returns NULL. 

 

Syntax:

 

CONCAT(str1, str2, [,...n])


For example: ::
      

        SELECT CONCAT('Dr', 'izzl', 'ed');

 

Returns: 'Drizzled' ::

 

        SELECT CONCAT('micro', NULL, 'nel');

 

Returns: NULL ::

 

        SELECT CONCAT(14.8);

 

Returns: '14.8'

 

CONCAT_WS

---------


CONCAT WS (With Separator) 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. 

 

* If the separator is NULL then the result is NULL.


Syntax:

 

CONCAT_WS(separator str1, str2,....) 

 

For example:
      

        SELECT CONCAT_WS(',', ' Occupation', 'First name', 'Last Name');

 

Returns: 'Occupation, First name, Last Name'

 

        SELECT CONCAT_WS(',', 'First name', NULL, 'Last Name');

 

Returns: 'First name, Last Name'

 

 

TRIM()

------         

 

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.

 

Syntax:

 

TRIM([{BOTH | LEADING | TRAILING} [remstr] FROM] str), TRIM([remstr FROM] str)

 

[remstr] is optional (if it's not specified, spaces are removed).

 

LTRIM()

-------

 

This version of the TRIM function removes leading spaces from the beginning of a string.

 

 

RTRIM()

-------

 

This version of the TRIM function removes trailing spaces from the end of a function.