REPLICATE (Transact-SQL)

Повторяет значение строки указанное число раз.

Синтаксические обозначения в Transact-SQL

Синтаксис

REPLICATE ( string_expression ,integer_expression ) 

Аргументы

• string_expression
  Выражение символьной строки или данных бинарного типа. string_expression может содержать либо символьные, либо бинарные данные.

  Примечание.
  Если аргумент string_expression не принадлежит к типу varchar(max) или nvarchar(max), функция REPLICATE усекает возвращаемое значение до 8000 байт. Для возврата значений, превышающих 8 000 байт, аргумент string_expression должен быть явно приведен к соответствующему типу данных с большими значениями.

• integer_expression
  Выражение любого целого типа, включая тип bigint. Если integer_expression имеет отрицательное значение, то возвращается NULL.

Типы возвращаемых данных

Возвращает тот же тип, что и аргумент string_expression.

Замечания

Уровни совместимости могут влиять на возвращаемые значения. Дополнительные сведения см. в разделе sp_dbcmptlevel.

Примеры

А. Использование функции REPLICATE

В следующем примере производится четырехкратная репликация символа 0 в начале рабочей строки кода в базе данных AdventureWorks.

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

Ниже приводится результирующий набор.

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

Б. Использование функций REPLICATE и DATALENGTH

В следующем примере числа дополняются слева до указанной длины, как будто они были преобразованы из числового типа данных в символьный или Юникод.

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

См. также

Справочник

Типы данных (Transact-SQL)
Строковые функции (Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005