• Artigo

REPLICATE (Transact-SQL)

Repete um valor da cadeia de caracteres um número especificado de vezes.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

REPLICATE ( string_expression ,integer_expression )

Argumentos

  • string_expression
    É uma expressão de um tipo de dados binário ou cadeia de caracteres. string_expression pode ser composto de dados binários ou de caractere.

    ObservaçãoObservação

    Se string_expression não for do tipo varchar(max) ou nvarchar(max), REPLICATE truncará o valor de retorno em 8.000 bytes. Para retornar valores com mais de 8.000 bytes, string_expression deve ser convertido explicitamente no tipo de dados de valor grande apropriado.

  • integer_expression
    É uma expressão de qualquer tipo inteiro, inclusive bigint. Se integer_expression for negativa, NULL será retornado.

Tipos de retorno

Retorna o mesmo tipo que string_expression.

Comentários

Os níveis de compatibilidade podem afetar os valores de retorno. Para obter mais informações, consulte sp_dbcmptlevel.

Exemplos

A. Usando REPLICATE

O exemplo a seguir replica um caractere 0 quatro vezes na frente do código de uma linha de produção no banco de dados AdventureWorks2008R2.

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

Aqui está o conjunto de resultados.

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

O exemplo a seguir preenche números à esquerda até um comprimento especificado, à medida que são convertidos de um tipo de dados numérico em caractere ou Unicode.

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