Partilhar via


RTRIM (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Ponto de Extremidade de Análise SQL no Microsoft FabricArmazém no Microsoft FabricBase de Dados SQL no Microsoft Fabric

Devolve uma cadeia de caracteres após truncar todos os espaços finais.

Remove caracteres char(32) de espaço ou outros caracteres especificados do final de uma cadeia.

Transact-SQL convenções de sintaxe

Sintaxe

Sintaxe para SQL Server antes do SQL Server 2022 (16.x):

RTRIM ( character_expression )

Sintaxe para SQL Server 2022 (16.x) e posteriores, Azure SQL Managed Instance, Azure SQL Database, Azure Synapse Analytics e Microsoft Fabric:

Importante

Vai precisar do nível de compatibilidade da base de dados definido para 160 para usar o argumento de caracteres opcionais.

RTRIM ( character_expression , [ characters ] )

Arguments

character_expression

Uma expressão de caracteres ou dados binários. character_expression pode ser uma constante, variável ou coluna. character_expression deve ser de um tipo de dado, exceto texto, ntexto e imagem, que seja implicitamente convertível para varchar. Caso contrário, use CAST para converter explicitamente character_expression.

Personagens

Aplica-se a: SQL Server 2022 (16.x) e posteriores.

Uma chamada literal, variável ou função de qualquer tipo de caractere não-LOB (nvarchar, varchar, nchar ou char) contendo caracteres que devem ser removidos. Os tipos nvarchar(max) e varchar(max) não são permitidos.

Tipos de devolução

Devolve uma expressão de carácter com um tipo de argumento de string, onde o carácter char(32) de espaço ou outros caracteres especificados são removidos do final de um character_expression. Retorna NULL se a cadeia de caracteres de entrada for NULL.

Observações

Para ativar o argumento posicional dos caracteres opcionais, ative o nível 160 de compatibilidade da base de dados na(s) base de dados a que se está a ligar ao executar consultas.

Examples

A. Remover os espaços finais

O exemplo seguinte pega numa sequência de caracteres que tem espaços no final da frase e devolve o texto sem os espaços no final da frase.

SELECT RTRIM('Removes trailing spaces.   ');

Aqui está o conjunto de resultados.

Removes trailing spaces.

B. Remover espaços finais com uma variável

O exemplo seguinte demonstra como usar RTRIM a remoção de espaços finais de uma variável de carácter.

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

Aqui está 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.

C. Remover caracteres especificados do final de uma cadeia de caracteres

Importante

Vai precisar do nível de compatibilidade da base de dados definido para 160 para usar o argumento de caracteres opcionais.

O exemplo seguinte remove os caracteres abc. do final da .123abc. cadeia.

SELECT RTRIM('.123abc.' , 'abc.');

Aqui está o conjunto de resultados.

.123

Consulte também