Retorna um novo array contendo um elemento especificado repetido várias vezes.
Sintaxe
array<T> array_repeat(T <element>, int <count>)
Descrição
Retorna um novo array contendo o elemento t repetido count vezes.
Parâmetros
-
t: obrigatório. Especifica o elemento a repetir. Tipos de dados compatíveis:
TINYINT, SMALLINT, INT e BIGINT
FLOAT e DOUBLE
BOOLEAN
DECIMAL e DECIMALVAL
DATE, DATETIME, TIMESTAMP, IntervalDayTime e IntervalYearMonth
STRING, BINARY, VARCHAR e CHAR
ARRAY, STRUCT e MAP
count: obrigatório. Especifica o número de repetições. Requer um valor do tipo INT maior ou igual a 0.
Valor de retorno
Retorna um valor do tipo ARRAY. O valor de retorno segue as seguintes regras:
Se o valor de count for null, retorna null.
Se o valor de count for menor que 0, retorna um array vazio.
Exemplos
-
Exemplo 1: Repita
123twicee retorne o novo array. Exemplo de instrução:-- The return value is [123, 123]. select array_repeat('123', 2); -
Exemplo 2: O valor de count é null. Instrução de exemplo:
-- The return value is null. select array_repeat('123', null); -
Exemplo 3: O valor de count é menor que 0. Exemplo de comando:
-- The return value is []. select array_repeat('123', -1);
Funções relacionadas
ARRAY_REPEAT é uma função de tipo complexo. Para obter mais informações sobre as funções usadas para processar dados de tipos complexos, como ARRAY, MAP, STRUCT e JSON, consulte Complex type functions.