# cat

конкатенация нескольких массивов

## Последовательность вызова

    y=cat(dims,A1,A2,...,An)

## Аргументы

dims

  положительный вещественный скаляр.

A1,A2,..An

  скаляры, векторы, матрицы или многомерные массивы или cell-массивы. A1,A2,...,An должны быть одинакового размера (за исключением номера размерности `dims`). `size(A1,i)=size(A2,i)=...=size(An,i)` для `i`, отличных от `dims`, а `size(A1,dims), size(A2,dims),..., size(An,dims)` могут различаться.

y

  скаляр, вектор, матрица или многомерный массив того же типа, что и `A1, A2,..., An`.

## Описание

`y=cat(dims,A1,A2,...,An) :``y` является результатом конкатенации входных аргументов `A1, A2,..., An`.

Если `dims=1`, то конкатенация проводится по строкам входных аргументов

`A1=[1 2 3 ; 4 5 6]`; `A2=[7 8 9 ; 10 11 12]`; `y=cat(1,A1,A2)` => `y=[1 2 3 ; 4 5 6 ;7 8 9; 10 11 12]`.

Если `dims=2`, то конкатенация проводится по столбцам входных аргументов

`A1=[1 2 3 ; 4 5 6]`; `A2=[7 8 9 ; 10 11 12]`; `y=cat(2,A1,A2)` => `y=[1 2 3 7 8 9 ; 4 5 6 10 11 12]` .

## Примеры

    // первый пример: конкатенация по строкам
    dims=1; A1=[1 2 3]; A2=[4 5 6 ; 7 8 9]; A3=[10 11 12]; y=cat(dims,A1,A2,A3)

    // второй пример: конкатенация по столбцам
    dims=2; A1=[1 2 3]'; A2=[4 5;7 8;9 10]; y=cat(dims,A1,A2)

    // третий пример: конкатенация то третьей размерности
    dims=3; A1=matrix(1:12,[2,2,3]); A2=[13 14;15 16]; A3=matrix(21:36,[2,2,4]); y=cat(dims,A1,A2,A3)

## Смотрите также

- permute
- matrix