REPLICATE (Transact-SQL)

Répète une valeur de chaîne un nombre spécifié de fois.

Conventions de la syntaxe Transact-SQL

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.

  Notes

  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.

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 AdventureWorks2012.

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.

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'), ('37', '37'),('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

Voici l'ensemble des résultats.

Varchar Column        Char Column
--------------------  ------------
002                   2  
037                   37 
597                   597

(3 row(s) affected)

Voir aussi

Référence

Types de données (Transact-SQL)

Fonctions de chaîne (Transact-SQL)