max

Maior elemento, ao longo de uma dimensão, ou o maior entre dois arrays.

Categoria: Language Fundamentals > Data Types

Sintaxe

M = max(A)

Maior elemento de um vetor, ou de cada coluna de uma matriz.

[M, I] = max(A)

Retorna também o índice do maior elemento; o primeiro quando há empates.

M = max(A, [], dim)

Maior ao longo da dimensão dim.

M = max(A, [], 'all')

Maior de todos os elementos.

M = max(A, B)

Maior elemento a elemento entre A e B, com expansão implícita.

Descrição

Por padrão valores NaN são ignorados: max([1 NaN 3]) é 3. O resultado é NaN apenas quando todos os valores são NaN. A matriz vazia dá []. Para números complexos a comparação usa o valor absoluto e, em empates, o ângulo.

A forma de dois arrays nunca devolve o índice, e o resultado tem a classe do operando inteiro quando um deles é inteiro.

Argumentos de entrada

A, B
Arrays numéricos, lógicos ou de char, ou arrays datetime ou duration.
dim
Dimensão ao longo da qual operar.
'omitnan' | 'includenan'
Se valores NaN são ignorados (o padrão) ou tornam o resultado NaN.

Argumentos de saída

M
Os maiores valores.
I
Índices dos máximos ao longo da dimensão de trabalho.

Exemplo

Máximos de uma matriz

A = [1 5; 7 2];
max(A)
max(A, [], 2)
max(A, [], 'all')
[m, i] = max([3 9 2 9])
max([1 NaN 3])
max(4, [1 6 2])
Saída
ans = 1×2

     7     5
ans = 2×1

     5
     7
ans = 7
m = 9
i = 2
ans = 3
ans = 1×3

     4     6     4

Veja também

min maxk cummax sort mean