• Artikel

REPLICATE (Transact-SQL)

Wiederholt einen Zeichenfolgenwert mit einer angegebenen Anzahl.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

REPLICATE ( string_expression ,integer_expression )

Argumente

  • string_expression
    Dies ist ein Ausdruck eines Zeichenfolgen- oder binären Datentyps. string_expression kann aus Zeichen oder aus binären Daten bestehen.

    HinweisHinweis

    Wenn string_expression nicht vom Datentyp varchar(max) oder nvarchar(max) ist, schneidet REPLICATE den Rückgabewert bei 8.000 Bytes ab. Für die Rückgabe von Werten über 8.000 Bytes muss string_expression explizit in den entsprechenden Datentyp mit umfangreichen Werten umgewandelt werden.

  • integer_expression
    Ein Ausdruck eines beliebigen integer-Typs, einschließlich bigint.. Wenn integer_expression negativ ist, wird NULL zurückgegeben.

Rückgabetypen

Gibt denselben Typ zurück wie string_expression.

Hinweise

Kompatibilitätsgrade können sich auf Rückgabewerte auswirken. Weitere Informationen finden Sie unter sp_dbcmptlevel.

Beispiele

A. Verwenden von REPLICATE

Im folgenden Beispiel wird ein 0-Zeichen viermal vor einem Produktionszeilencode in der AdventureWorks2008R2-Datenbank repliziert.

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

Dies ist das Resultset.

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. Verwenden von REPLICATE und DATALENGTH

Im folgenden Beispiel werden die Zahlen von links bis zu einer angegebenen Länge aufgefüllt, während sie aus einem numerischen in einen Zeichen- oder Unicode-Datentyp konvertiert werden.

USE AdventureWorks2008R2;
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