RTRIM (Transact-SQL)

Aplica-se a:SQL Server (todas as versões compatíveis) Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

Retorna uma cadeia de caracteres depois de truncar todos os espaços à direita.

Convenções de sintaxe do Transact-SQL

Sintaxe

RTRIM ( character_expression )  

Observação

Para ver a sintaxe do Transact-SQL para o SQL Server 2014 e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

character_expression
É uma expression de dados de caractere. character_expression pode ser uma constante, uma variável ou uma coluna de dados binários ou de caracteres.

character_expression deve ser um tipo de dados implicitamente conversível em varchar. Caso contrário, use CAST para converter character_expression explicitamente.

Tipos de retorno

varchar ou nvarchar

Exemplos

a. Exemplo simples

O exemplo a seguir usa uma cadeia de caracteres com espaços no final da frase e retorna o texto sem os espaços no final da frase.

SELECT RTRIM('Removes trailing spaces.   ');  

Este é o conjunto de resultados.

Removes trailing spaces.

B: Exemplo simples

O exemplo a seguir demonstra como usar RTRIM para remover espaços à direita. Desta vez há outra cadeia de caracteres concatenada com a primeira cadeia de caracteres para mostrar que os espaços foram excluídos.

SELECT RTRIM('Four spaces are after the period in this sentence.    ') + 'Next string.';  

Este é o conjunto de resultados.

Four spaces are after the period in this sentence.Next string.

C. Usando RTRIM com uma variável

O exemplo a seguir demonstra como usar RTRIM para remover espaços à direita de uma variável de caractere.

DECLARE @string_to_trim VARCHAR(60);  
SET @string_to_trim = 'Four spaces are after the period in this sentence.    ';  
SELECT @string_to_trim + ' Next string.';  
SELECT RTRIM(@string_to_trim) + ' Next string.';  
GO  

Este é o conjunto de resultados.

Four spaces are after the period in this sentence.     Next string.

Four spaces are after the period in this sentence. Next string.

Consulte Também

LEFT (Transact-SQL)
LTRIM (Transact-SQL)
RIGHT (Transact-SQL)
STRING_SPLIT (Transact-SQL)
SUBSTRING (Transact-SQL)
TRIM (Transact-SQL)
CAST e CONVERT (Transact-SQL)
Tipos de dados (Transact-SQL)
Funções de cadeia de caracteres (Transact-SQL)