PostgreSQL CONCAT_WS() Function
The PostgreSQL CONCAT_WS() function is used to concatenate two or more expressions together and adds a separator between each of the concatenated expressions. This function may have one or more expressions. If any of the expressions is a NULL, this function ignores NULL values during concatenation, and does not add the separator between NULL values. If separator is a NULL, this function will return a NULL value.
Syntax
CONCAT_WS(separator, expr1, expr2, ... expr_n)
Parameters
separator |
Required. Specify the separator which will be added between each of the concatenated expressions. |
expr1, expr2, ... expr_n |
Required. Specify the expressions to concatenate together. |
Return Value
Returns the concatenated string.
Example 1:
The example below shows the usage of CONCAT_WS() function.
SELECT CONCAT_WS(' ', 'SQL', 'Tutorial'); Result: 'SQL Tutorial' SELECT CONCAT_WS(' ', 'Learning', 'SQL', 'is', 'fun!.'); Result: 'Learning SQL is fun!.' SELECT CONCAT_WS(', ', 10, 20, 30, 40); Result: '10, 20, 30, 40' SELECT CONCAT_WS(' = ', 'Sum', 25 + 25); Result: 'Sum = 50' SELECT CONCAT_WS(', ', 10, 20, NULL, 40); Result: '10, 20, 40' SELECT CONCAT_WS(NULL, 10, 20, 30, 40); Result: NULL
Example 2:
Consider a database table called Employee with the following records:
EmpID | FirstName | LastName |
---|---|---|
1 | John | Smith |
2 | Marry | Knight |
3 | Jo | Williams |
4 | Kim | Fischer |
5 | Ramesh | Gupta |
6 | Huang | Zhang |
In the query below, the CONCAT_WS() function is used to concatenate records of column FirstName and column LastName.
SELECT *, CONCAT_WS(' ', FirstName, LastName) AS FullName FROM Employee;
This will produce the result as shown below:
EmpID | FirstName | LastName | FullName |
---|---|---|---|
1 | John | Smith | John Smith |
2 | Marry | Knight | Marry Knight |
3 | Jo | Williams | Jo Williams |
4 | Kim | Fischer | Kim Fischer |
5 | Ramesh | Gupta | Ramesh Gupta |
6 | Huang | Zhang | Huang Zhang |
❮ PostgreSQL Functions