union

União de conjuntos: os valores ordenados que aparecem em qualquer um de dois arrays.

Categoria: Language Fundamentals > Data Types

Sintaxe

C = union(A, B)

Retorna os valores distintos de A ou B, ordenados.

[C, ia, ib] = union(A, B)

Também retorna vetores de índices tais que C é formado por A(ia) e B(ib).

Descrição

As duplicatas são removidas, então o resultado tem cada valor uma só vez, em ordem crescente para números e em ordem alfabética para texto. As duas entradas são tratadas como conjuntos, de modo que a ordem original e valores repetidos não importam.

intersect dá os valores comuns, setdiff os que estão só em um array e setxor os que estão em exatamente um deles.

Argumentos de entrada

A, B
Arrays numéricos, cell arrays de vetores de caracteres, arrays de strings ou tabelas com tipos compatíveis.

Argumentos de saída

C
Valores distintos ordenados (linha se as duas entradas forem linhas, senão coluna).
ia, ib
Índices dos elementos tomados de A e de B. Um valor presente nos dois é tomado de A.

Exemplo

Números, texto e índices

union([3 1 2], [2 5 1])
union({'a','c'}, {'b','a'})
[c, ia, ib] = union([1 2], [2 3])
Saída
ans = 1×4

     1     2     3     5
ans = 1×3 cell

    {'a'}    {'b'}    {'c'}
c = 1×3

     1     2     3
ia = 2×1

     1
     2
ib = 2

Veja também

intersect setdiff setxor unique ismember