REPLICATE (Transact-SQL)
Répète une valeur de chaîne un nombre spécifié de fois.
Syntaxe
REPLICATE ( string_expression ,integer_expression )
Arguments
string_expression
Correspond à une expression d'un type de données binaire ou de chaîne de caractères. string_expression correspond à des données de type binaire ou caractère.[!REMARQUE]
Si string_expression n'est pas du type varchar(max) ou nvarchar(max), REPLICATE tronque la valeur de retour à 8 000 octets. Pour retourner des valeurs supérieures à 8 000 octets, il est nécessaire d'attribuer de manière explicite à string_expression le type de données de valeur élevée approprié.
integer_expression
Expression de n'importe quel type entier, notamment bigint. Si l'argument integer_expression est négatif, une chaîne NULL est retournée.
Types de retour
Retourne le même type que string_expression.
Notes
Les niveaux de compatibilité peuvent affecter les valeurs retournées. Pour plus d'informations, consultez sp_dbcmptlevel.
Exemples
A. Utilisation de REPLICATE
L'exemple suivant réplique un caractère 0 quatre fois devant un code de ligne de production dans la base de données AdventureWorks.
USE AdventureWorks
GO
SELECT [Name]
, REPLICATE('0', 4) + [ProductLine] AS 'Line Code'
FROM [Production].[Product]
WHERE [ProductLine] = 'T'
ORDER BY [Name]
GO
Voici l'ensemble des résultats.
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. Utilisation de REPLICATE et de DATALENGTH
Cet exemple complète à gauche des nombres dans la limite d'une longueur spécifiée lors de leur conversion d'un type de données numérique en type caractère ou 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