REPLICATE (Transact-SQL)

Ripete un valore stringa il numero di volte specificato.

Convenzioni della sintassi Transact-SQL

Sintassi

REPLICATE ( string_expression ,integer_expression ) 

Argomenti

• string_expression
  Espressione di dati di tipo stringa di caratteri o binario. string_expression può essere di tipo carattere o binario.

  [!NOTA] Se string_expression non è di tipo varchar(max) o nvarchar(max), REPLICATE tronca il valore restituito a 8.000 byte. Per restituire valori con dimensioni maggiori di 8.000 byte, è necessario eseguire il cast esplicito di string_expression al tipo di dati appropriato per valori di grandi dimensioni.

• integer_expression
  Espressione di qualsiasi tipo integer, incluso bigint. Se l'argomento integer_expression è negativo, viene restituito NULL.

Tipi restituiti

Restituisce lo stesso tipo dell'argomento string_expression.

Osservazioni

I livelli di compatibilità possono influire sui valori restituiti. Per ulteriori informazioni, vedere sp_dbcmptlevel.

Esempi

A. Utilizzo di REPLICATE

Nell'esempio seguente il carattere 0 viene ripetuto quattro volte davanti al codice della linea di produzione nel database AdventureWorks.

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

Set di risultati:

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. Utilizzo di REPLICATE e DATALENGTH

Nell'esempio seguente vengono inseriti numeri di riempimento iniziali a sinistra fino alla lunghezza specificata durante la conversione da un tipo di dati numerico a un tipo di dati carattere o 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

Vedere anche

Riferimento

Tipi di dati (Transact-SQL)
Funzioni per i valori stringa (Transact-SQL)

Guida in linea e informazioni

Assistenza su SQL Server 2005