SUBSTITUIR

✅ Azure Stream Analytics ✅ Fabric Eventstream

Substitui todas as ocorrências de um valor de cadeia de caracteres especificado por outro valor de cadeia de caracteres.

Sintaxe

REPLACE ( stringExpression, stringPattern, stringReplacement )

Argumentos

stringExpression

A expressão de cadeia de caracteres a ser pesquisada.

stringPattern

A substring a ser encontrada. Se stringPattern for uma cadeia de caracteres vazia, stringExpression será retornada.

stringReplacement

A cadeia de substituição.

Tipos de devolução

Retorna NULL se qualquer um dos argumentos for NULL. Caso contrário, retorna nvarchar(max).

Exemplos

SELECT REPLACE(value, pattern, replacement) AS result FROM input

Expressão	Resultado
SUBSTITUIR('abcde', 'cd', 'xx')	'ABXXE'
SUBSTITUIR('cdabcd', 'cd', 'x')	'XABX'
SUBSTITUIR('cd', 'cd', 'xxx')	«xxx»
SUBSTITUIR('abcde', 'gh', 'xx')	'ABCDE'
SUBSTITUIR('abcde', 'cde', '')	«AB»
SUBSTITUIR('abcde', '', 'xxx')	'ABCDE'
SUBSTITUIR('', 'cde', 'xxx')	''
SUBSTITUIR(NULL, 'cde', 'xxx')	null
REPLACE('abcde', NULL, 'xxx')	null
REPLACE('abcde', 'cde', NULL)	null

Ver também

• TRADUZIR