cat

Junta arrays ao longo de uma dimensão escolhida.

Categoria: Language Fundamentals > Matrices and Arrays

Sintaxe

C = cat(dim, A, B, ...)

Descrição

cat(1, A, B) equivale a [A; B] e cat(2, A, B) a [A, B]. Seu uso real é com dim 3 ou mais, que os colchetes não expressam, por exemplo para empilhar matrizes em um array 3-D.

Cell arrays, strings e outros tipos de array também podem ser unidos. Se as outras dimensões não coincidirem, a chamada falha com erro de dimensão.

Argumentos de entrada

dim

Inteiro positivo: 1 empilha na vertical, 2 lado a lado, 3 ao longo das páginas.

A, B, ...

Arrays da mesma classe (ou classes compatíveis). Todos os tamanhos devem coincidir, exceto ao longo de dim.

Argumentos de saída

C

O array unido. Seu tamanho ao longo de dim é a soma dos tamanhos das entradas.

Exemplo

Empilhar duas matrizes em páginas

A = [1 2; 3 4];
B = [5 6; 7 8];
C = cat(3, A, B);
size(C)
C(:, :, 2)

ans = 1×3

     2     2     2
ans = 2×2

     5     6
     7     8

Veja também

horzcat vertcat repmat permute reshape