Reference Guide > TDV Support for SQL Functions > TDV-Supported Character Functions > REPLACE
 
REPLACE
Given a series of three strings (representing the search string, string to be replaced, and replacement string, respectively), the REPLACE function substitutes the replacement string for all instances of the string to be replaced that are contained in the search string.
Syntax
REPLACE (search_string, string_to_be_replaced, replacement_string)
Remarks
The string_to_be_replaced and the replacement_string must be of the same type (string or binary).
All occurrences of the string_to_be_replaced within the search_string are replaced with the replacement_string.
The string_to_be_replaced and the replacement_string must be enclosed within single-quotes.
If any of the input strings is NULL, the output is also NULL. Otherwise, the output is a string.
The following table lists the input types that you can use in REPLACE, and their corresponding output types.
Data Type of search_string
Data Type of string_to_be_replaced
Data Type of replacement_string
Output
Data Type
CHAR, VARCHAR, LONGVARCHAR, STRING
Same as search_string.
Same as string_to_be_
replaced.
Same as string_to_be_
replaced.
CHAR, LONGVARCHAR, NULL, STRING, VARCHAR
NULL
Same as search_string.
NULL
NULL
CHAR, VARCHAR, LONGVARCHAR, STRING
Same as string_to_be_
replaced.
NULL
CHAR, LONGVARCHAR, STRING, VARCHAR
Same as search_string.
NULL
NULL
Example
SELECT REPLACE (products.ProductName, 'USB 2.0', 'USB 3.0') Replaced
FROM /shared/examples/ds_inventory/products products