RTRIM (Transact-SQL)

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウス

末尾のスペースを切り捨てた後の文字列を返します。

文字列の末尾にある空白文字 char(32) またはその他の指定した文字を削除します。

Transact-SQL 構文表記規則

構文

SQL Server 2022 (16.x) より前の SQL Server の構文:

RTRIM ( character_expression )

SQL Server 2022 (16.x) 以降、Azure SQL Managed Instance、Azure SQL Database、Azure Synapse Analytics、Microsoft Fabric の構文:

重要

省略可能な characters 引数を使うには、データベースの互換性レベルを 160 に設定する必要があります。

RTRIM ( character_expression , [ characters ] )

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

character_expression

文字データまたはバイナリ データの式。 character_expression には定数、変数、または列を指定できます。 character_expression 以外のデータ型の場合は、ある必要があります text、ntext、および image、つまりに暗黙的に変換 varcharです。 それ以外の場合は、CAST を指定して明示的に character_expression を変換します。

characters

適用対象: SQL Server 2022 (16.x) 以降。

削除する必要がある文字を含む LOB 以外の任意の文字型 (nvarchar、varchar、nchar、または char) のリテラル、変数、または関数呼び出しです。 nvarchar(max) 型と varchar(max) 型は使用できません。

戻り値の型

文字列引数の型を持つ文字式を返します。空白文字 char(32) またはその他の指定した文字は、character_expression の末尾から削除されます。 入力文字列が NULL の場合は NULL を返します。

解説

省略可能な characters 位置引数を有効にするには、クエリの実行時に接続するデータベースでデータベース互換レベル 160 を有効にします。

例

A. 末尾のスペースの削除

次の例では、文末に空白のある文字列を受け取り、文末の空白を除くテキストが返されます。

SELECT RTRIM('Removes trailing spaces.   ');

結果セットは次のようになります。

Removes trailing spaces.

B. 変数で末尾の空白を削除する

この例では、RTRIM を使用して文字変数から後続する空白を削除します。

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

結果セットは次のようになります。

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

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

C. 文字列の末尾から指定した文字を削除する

重要

省略可能な characters 引数を使うには、データベースの互換性レベルを 160 に設定する必要があります。

次の例では、.123abc. 文字列の末尾から文字 abc. を削除します。

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

結果セットは次のようになります。

.123

関連項目