REPLICATE (Transact-SQL)

文字列値を指定した回数だけ繰り返します。

Transact-SQL 構文表記規則

構文

REPLICATE ( string_expression ,integer_expression ) 

引数

• string_expression
  文字列またはバイナリ データ型の式を指定します。string_expression は文字またはバイナリ データのいずれかになります。

  注意
  string_expression の型が varchar(max) または nvarchar(max) でない場合は、戻り値が 8,000 バイトで切り捨てられます。8,000 バイトを超える値を返すには、string_expression を適切なサイズのデータ型に明示的にキャストする必要があります。

• integer_expression
  bigint を含む、整数型の式を指定します。integer_expression に負の値を指定した場合は、NULL が返されます。

戻り値の型

string_expression と同じ型が返されます。

説明

互換性レベルは、戻り値に影響します。詳細については、「sp_dbcmptlevel」を参照してください。

例

A. REPLICATE を使用する

次の例では、AdventureWorks データベースの取り扱い品目コードの前に 0 という文字を 4 回繰り返します。

USE AdventureWorks
GO
SELECT [Name]
, REPLICATE('0', 4) + [ProductLine] AS 'Line Code'
FROM [Production].[Product]
WHERE [ProductLine] = 'T'
ORDER BY [Name]
GO

以下に結果セットを示します。

Name                                               Line Code
-------------------------------------------------- ---------
HL Touring Frame - Blue, 46                        0000T 
HL Touring Frame - Blue, 50                        0000T 
HL Touring Frame - Blue, 54                        0000T 
HL Touring Frame - Blue, 60                        0000T 
HL Touring Frame - Yellow, 46                      0000T 
HL Touring Frame - Yellow, 50                      0000T
...

B. REPLICATE と DATALENGTH を使用する

次の例では、数値型から文字または Unicode に数値を変換するときに、その数値の左側を埋めて指定された長さにします。

USE AdventureWorks;
GO
IF EXISTS(SELECT name FROM sys.tables
      WHERE name = 't1')
   DROP TABLE t1;
GO
CREATE TABLE t1 
(
 c1 varchar(3),
 c2 char(3)
)
GO
INSERT INTO t1 VALUES ('2', '2')
INSERT INTO t1 VALUES ('37', '37')
INSERT INTO t1 VALUES ('597', '597')
GO
SELECT REPLICATE('0', 3 - DATALENGTH(c1)) + c1 AS 'Varchar Column',
       REPLICATE('0', 3 - DATALENGTH(c2)) + c2 AS 'Char Column'
FROM t1
GO

関連項目

参照

データ型 (Transact-SQL)

文字列関数 (Transact-SQL)