# repelem

Repeat copies of array elements

## Syntax

``u = repelem(v,n)``
``B = repelem(A,r1,...,rN)``

## Description

example

````u = repelem(v,n)`, where `v` is a scalar or vector, returns a vector of repeated elements of `v`. If `n` is a scalar, then each element of `v` is repeated `n` times. The length of `u` is `length(v)*n`.If `n` is a vector, then it must be the same length as `v`. Each element of `n` specifies the number of times to repeat the corresponding element of `v`. This syntax is not supported for `table` input.```

example

````B = repelem(A,r1,...,rN)` returns an array with each element of `A` repeated according to `r1,...,rN`. Each `r1,...,rN` must either be a scalar or a vector with the same length as `A` in the corresponding dimension. For example, if `A` is a matrix, `repelem(A,2,3)` returns a matrix containing a `2`-by-`3` block of each element of `A`.```

## Examples

collapse all

Create a vector and repeat each of its elements three times into a new vector.

```v = [1 2 3 4]; u = repelem(v,3)```
```u = 1×12 1 1 1 2 2 2 3 3 3 4 4 4 ```

Repeat the first two elements of `v` twice and the last two elements three times.

`u = repelem(v,[2 2 3 3])`
```u = 1×10 1 1 2 2 3 3 3 4 4 4 ```

Create a matrix and repeat each element into a 3-by-2 block of a new matrix.

`A = [1 2; 3 4]`
```A = 2×2 1 2 3 4 ```
`B = repelem(A,3,2)`
```B = 6×4 1 1 2 2 1 1 2 2 1 1 2 2 3 3 4 4 3 3 4 4 3 3 4 4 ```

Create a matrix and copy its columns into a new array, repeating the first column twice and second column three times.

`A = [1 2; 3 4]`
```A = 2×2 1 2 3 4 ```
`B = repelem(A,1,[2 3])`
```B = 2×5 1 1 2 2 2 3 3 4 4 4 ```

## Input Arguments

collapse all

Input element, specified as a scalar or a vector.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64` | `logical` | `char` | `string` | `struct` | `table` | `cell` | `datetime` | `duration`
Complex Number Support: Yes

Number of times to repeat each element, specified as a scalar or a vector. If `n` is a scalar, then all elements of `v` are repeated `n` times. If `n` is a vector, then each element of `n` specifies the number of times to repeat the corresponding element of `v`. In either case, `n` must be integer-valued.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64`

Input array, specified as a matrix or multidimensional array.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64` | `logical` | `char` | `struct` | `table` | `cell` | `datetime` | `duration`
Complex Number Support: Yes

Repetition factors for each dimension, specified as separate arguments of integer-valued scalars or vectors. If `A` is a table, each repetition factor must be a scalar.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64`

## Output Arguments

collapse all

Output vector. If `v` is a row vector or scalar, `u` is a row vector. If `v` is a column vector, `u` is also a column vector.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64` | `logical` | `char` | `string` | `struct` | `table` | `cell` | `datetime` | `duration`

Output array, returned as a matrix or multidimensional array.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64` | `logical` | `char` | `string` | `struct` | `table` | `cell` | `datetime` | `duration`