~drizzle-trunk/drizzle/development

String Modification Functions

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

.. _concat-function:

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:

.. code-block:: mysql

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

Returns: 'Drizzled'

.. code-block:: mysql

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

Returns: NULL

.. code-block:: mysql

	SELECT CONCAT(14.8);

Returns: '14.8'

.. _concat-ws-function:

CONCAT_WS

---------

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.

Syntax:

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

For example:

.. code-block:: mysql

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

Returns: 'Occupation, First name, Last Name'

.. code-block:: mysql

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

Returns: 'First name, Last Name'

.. _trim-function:

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-function:

LTRIM

-----

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

.. _rtrim-function:

RTRIM

-----

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

.. rubric:: Footnotes

.. [1] If the separator is NULL then the result is NULL.