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