# cat

concatena vários arrays

## Seqüência de Chamamento

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

## Parâmetros

dims

  um escalar real positivo

A1,A2,..An

  escalares, vetores, matrizes, multi-arrays ou cell arrays. A1, A2, ..., An, devem ter o mesmo tamanho (excluindo o número de dimensão dims). size(A1,i)=size(A2,i)=...=size(An,i) para i diferente de dims e size(A1,dims), size(A2,dims),...,size(An,dims) podem ser diferentes

y

  um escalar, vetor, matriz ou multi-array, y tem o mesmo tipo de A1,A2,...,An

## Descrição

`y=cat(dims,A1,A2,...,An) :` y é o resutado da concatenação dos argumentos de entrada A1, A2, ..., An. Se dims= 1, então a concatenação é feita de acordo com as linhas; se dims= 2, então a concatenação é feita de acordo com as colunas dos argumentos de entrada.

Se dims= 1,então a concatenação é feita de acordo com as linhas

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]

Se dims= 2,então a concatenação é feita de acordo com as colunas dos argumentos de entrada

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]

## Exemplos

    // primeiro exemplo: concatenação de acordo com as linhas
    dims=1; A1=[1 2 3]; A2=[4 5 6 ; 7 8 9]; A3=[10 11 12]; y=cat(dims,A1,A2,A3)

    // segundo exemplo: concatenação de acordo com as colunas
    dims=2; A1=[1 2 3]'; A2=[4 5;7 8;9 10]; y=cat(dims,A1,A2)

    // terceiro exemplo concatenação de acordo com a terceira dimensão
    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)

## Ver Também

- permute
- matrix