max

数组的最大元素

全页折叠

语法

M = max(A)

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

M = max(A,[],dim)

M = max(A,[],vecdim)

M = max(A,[],___,missingflag)

[M,I] = max(___)

[M,I] = max(A,[],___,"linear")

C = max(A,B)

C = max(A,B,missingflag)

___ = max(___,"ComparisonMethod",method)

说明

M = max(A) 返回数组的最大元素。

如果 A 是向量，则 max(A) 返回 A 的最大值。
如果 A 为矩阵，则 max(A) 是包含 A 的每一列的最大值的行向量。
如果 A 是多维数组，则 max(A) 沿大小不等于 1 的 A 的第一个维度进行运算，并将这些元素视为向量。此维度中 M 的大小变为 1，而所有其他维度的大小仍与在 A 中相同。如果 A 是第一个维度长度为零的空数组，则 M 是与 A 大小相同的空数组。
如果 A 是表或时间表，则 max(A) 返回包含每个变量的最大值的一个单行表。 (自 R2023a 起)

示例

M = max(A,[],"all") 查找 A 的所有元素的最大值。

示例

M = max(A,[],dim) 返回维度 dim 上的最大元素。例如，如果 A 为矩阵，则 max(A,[],2) 返回包含每一行的最大值的列向量。

示例

M = max(A,[],vecdim) 返回向量 vecdim 所指定的维度上的最大值。例如，如果 A 是矩阵，则 max(A,[],[1 2]) 返回 A 中所有元素的最大值，因为矩阵的每个元素包含在由维度 1 和 2 定义的数组切片中。

示例

M = max(A,[],___,missingflag) 指定在上述任一语法的基础上是省略还是包含 A 中的缺失值。例如，max(A,[],"includemissing") 在计算最大值时包括所有缺失值。默认情况下，max 会忽略缺失值。

示例

[M,I] = max(___) 还返回 A 中最大值第一次在运算维度上出现时的对应索引。

示例

[M,I] = max(A,[],___,"linear") 还返回 A 中最大值在 A 中的对应线性索引。

示例

C = max(A,B) 返回从 A 或 B 中提取的最大元素的数组。

示例

C = max(A,B,missingflag) 还指定如何处理缺失值。

___ = max(___,"ComparisonMethod",method) 为上述任何语法指定如何比较元素，此项为可选项。例如，对于向量 A = [-1 2 -9]，语法 max(A,[],"ComparisonMethod","abs") 根据绝对值比较 A 的元素并返回最大值 -9。

示例

全部折叠

向量中的最大元素

打开实时脚本

创建一个向量并计算其最大元素。

A = [23 42 37 18 52];
M = max(A)

M = 
52

最大复数元素

打开实时脚本

创建一个复数向量并计算其最大元素，即具有最大幅值的元素。

A = [-2+2i 4+i -1-3i];
max(A)

ans = 
4.0000 + 1.0000i

每个矩阵列中的最大元素

打开实时脚本

创建一个矩阵并计算每列中的最大元素。

A = [2 8 4; 7 3 9]

A = 2×3

     2     8     4
     7     3     9

M = max(A)

M = 1×3

     7     8     9

每个矩阵行中的最大元素

打开实时脚本

创建一个矩阵并计算每行中的最大元素。

A = [1.7 1.2 1.5; 1.3 1.6 1.99]

A = 2×3

    1.7000    1.2000    1.5000
    1.3000    1.6000    1.9900

M = max(A,[],2)

数组页的最大值

打开实时脚本

创建一个三维数组并计算每页数据（行和列）的最大值。

A(:,:,1) = [2 4; -2 1];
A(:,:,2) = [9 13; -5 7];
A(:,:,3) = [4 4; 8 -3];
M1 = max(A,[],[1 2])

M1 = 
M1(:,:,1) =

     4


M1(:,:,2) =

    13


M1(:,:,3) =

     8

要计算一个数组的所有维度上的最大值，可以在向量维度参量中指定每个维度，或使用 "all" 选项。

M2 = max(A,[],[1 2 3])

M2 = 
13

Mall = max(A,[],"all")

Mall = 
13

包括缺失值的最大元素

打开实时脚本

创建一个包含 NaN 值的矩阵。

A = [1.77 -0.005 NaN -2.95; NaN 0.34 NaN 0.19]

A = 2×4

    1.7700   -0.0050       NaN   -2.9500
       NaN    0.3400       NaN    0.1900

计算矩阵的最大值，包括缺失值。对于包含任一 NaN 值的矩阵列，最大值为 NaN。

M = max(A,[],"includemissing")

M = 1×4

       NaN    0.3400       NaN    0.1900

最大元素索引

打开实时脚本

创建一个矩阵 A 并计算每列中的最大元素，以及这些元素在 A 中显示的行索引。

A = [1 9 -2; 8 4 -5]

A = 2×3

     1     9    -2
     8     4    -5

[M,I] = max(A)

M = 1×3

     8     9    -2

I = 1×3

     2     1     1

返回线性索引

打开实时脚本

创建一个矩阵 A，并返回矩阵 M 中每行的最大值。使用 "linear" 选项还可以返回线性索引 I，满足 M = A(I)。

A = [1 2 3; 4 5 6]

A = 2×3

     1     2     3
     4     5     6

[M,I] = max(A,[],2,"linear")

maxvals = A(I)

maxvals = 2×1

     3
     6

最大元素比较

打开实时脚本

创建一个矩阵并返回其各个元素与标量相比的最大值。

A = [1 7 3; 6 2 9]

A = 2×3

     1     7     3
     6     2     9

B = 5;
C = max(A,B)

C = 2×3

     5     7     5
     6     5     9

输入参数

全部折叠

`A` — 输入数组
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

输入数组，指定为标量、向量、矩阵、多维数组、表或时间表。

如果 A 是复矩阵，则 max(A) 返回幅值最大的复数。如果幅值相等，则 max(A) 返回具有最大幅值和最大相位角的值。
如果 A 是标量，则 max(A) 返回 A。
如果 A 为 0×0 空数组，则 max(A) 也是空数组。

如果 A 的类型为 categorical，则它必须是有序的。

`dim` — 沿其运算的维度
正整数标量

沿其运算的维度，指定为正整数标量。如果不指定维度，则默认值是大小不等于 1 的第一个数组维度。

维度 dim 表示长度减至 1 的维度。size(M,dim) 为 1，而所有其他维的大小保持不变，除非 size(A,dim) 为 0。如果 size(A,dim) 为 0，则 max(A,dim) 返回与 A 大小相同的空数组。

以一个 m×n 输入矩阵 A 为例：

max(A,[],1) 计算 A 的每列中元素的最大值，并返回一个 1×n 行向量。
max(A,[],2) 计算 A 的每行中元素的最大值，并返回一个 m×1 列向量。

`vecdim` — 维度向量
正整数向量

维度向量，指定为正整数向量。每个元素代表输入数组的一个维度。指定的操作维度的输出长度为 1，而其他保持不变。

以 2×3×3 输入数组 A 为例。然后 max(A,[],[1 2]) 返回 1×1×3 数组，其元素是在 A 的每个页面上计算的最大值。

Mapping of a 2-by-3-by-3 input array to a 1-by-1-by-3 output array

`B` — 其他输入数组
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

其他输入数组，指定为标量、向量、矩阵、多维数组、表或时间表。输入 A 和 B 必须具有相同的大小或具有兼容的大小（例如，A 是一个 M×N 矩阵，B 是标量或 1×N 行向量）。有关详细信息，请参阅基本运算的兼容数组大小。

如果 A 和 B 均为数组，则它们的数据类型必须相同，除非其中一个是 double。如果是那样，另一个数组的数据类型可以是 single、duration 或任何整数类型。
如果 A 和 B 均为有序 categorical 数组，则必须具有顺序相同的同一类别集。
如果 A 或 B 是表或时间表，则另一个输入可以是数组、表或时间表。

如果 B 的类型为 categorical，则它必须是有序的。

`missingflag` — 缺失值条件
`"omitmissing"` (默认) | `"omitnan"` | `"omitnat"` | `"omitundefined"` | `"includemissing"` | `"includenan"` | `"includenat"` | `"includeundefined"`

缺失值条件，指定为下表中的值之一。

值	输入数据类型	描述
`"omitmissing"`	所有支持的数据类型	忽略输入数组中的缺失值，并基于较少的点计算最大值。如果运算维度中的所有元素都缺失，则 `M` 中的对应元素也会缺失。
`"omitnan"`	`double`, `single`, `duration`
`"omitnat"`	`datetime`
`"omitundefined"`	`categorical`
`"includemissing"`	所有支持的数据类型	计算最大值时包括输入数组中的缺失值。如果运算维度中的任一元素缺失，则 `M` 中的对应元素也会缺失。
`"includenan"`	`double`, `single`, `duration`
`"includenat"`	`datetime`
`"includeundefined"`	`categorical`

`method` — 比较方法
`"auto"` (默认) | `"real"` | `"abs"`

数值输入的比较方法，指定为以下值之一：

"auto" - 对于数值输入数组 A，当 A 为实数时，按 real(A) 比较元素，当 A 为复数时，按 abs(A) 比较元素。
"real" - 对于数值输入数组 A，当 A 是实数或复数时，按 real(A) 比较元素。如果 A 包含具有相等实部的元素，则使用 imag(A) 进行排序。
"abs" - 对于数值输入数组 A，当 A 是实数或复数时，按 abs(A) 比较元素。如果 A 包含具有相等模的元素，则使用区间 (-π,π] 中的 angle(A) 进行排序。

输出参量

全部折叠

`M` — 最大值
标量 | 向量 | 矩阵 | 多维数组 | 表

最大值，以标量、向量、矩阵、多维数组或表的形式返回。size(M,dim) 为 1，而所有其他维度的大小与 A 中的相应维度的大小匹配，除非 size(A,dim) 为 0。如果 size(A,dim) 为 0，则 M 是大小与 A 相同的空数组。

`I` — 索引
标量 | 向量 | 矩阵 | 多维数组 | 表

索引，以标量、向量、矩阵或多维数组或表形式返回。I 的大小与第一个输出相同。

当未指定 "linear" 时，I 是运算维度上的索引。当指定了 "linear" 时，I 包含最大值在 A 中的对应线性索引。

如果最大元素出现多次，则 I 包含值的第一次出现位置的索引。

`C` — `A` 或 `B` 中的最大元素
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

A 或 B 中的最大元素，以标量、向量、矩阵、多维数组、表或时间表形式返回。C 的大小由 A 和 B 的维度的隐式扩展决定。有关详细信息，请参阅基本运算的兼容数组大小。

C 的数据类型取决于 A 和 B 的数据类型：

如果 A 和 B 是相同的数据类型，则 C 与 A 和 B 的数据类型匹配。
如果 A 或 B 为 single，则 C 为 single。
如果 A 或 B 为整数数据类型且另一个为标量 double，则 C 采用整数数据类型。
如果 A 或 B 是表或时间表，则 C 也是表或时间表。

扩展功能

全部展开

tall 数组
对行数太多而无法放入内存的数组进行计算。

max 函数支持 tall 数组，但存在以下使用说明和限制：

tall 表格输入不支持索引输出。

有关详细信息，请参阅tall 数组。

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

要在运行时使用空数组作为第二个参量，必须指定一个在代码生成时具有固定大小 0×0 的数组。
如果使用参量 dim、vecdim、missingflag 和 method，它们在代码生成时必须为常量。
对于输入参量 A：
- 如果不指定维度，代码生成器将沿输入数组中具有可变大小或其大小不为 1 的第一个维度进行运算。如果此维度在代码生成时具有可变大小且在运行时为 1，则可能发生运行时错误。为避免此错误，请指定维度。
- 在生成的代码中，输入数组保持复数，即使其所有元素都具有零值虚部也是如此。在这些情况下，生成的代码产生的结果可能与 MATLAB 产生的结果不同。请参阅具有零值虚部的复数数据的代码生成 (MATLAB Coder)。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

用法说明和限制：

要在运行时使用空数组作为第二个参量，必须指定一个在代码生成时具有固定大小 0×0 的数组。
如果使用参量 dim、vecdim、missingflag 和 method，它们在代码生成时必须为常量。
如果不指定 dim 参量，代码生成器将沿 A 的具有可变大小或其大小不等于 1 的第一个维度进行运算。
如果 A 是复数，且 A 的所有元素都具有零值虚部，则 MATLAB^® 可能在调用 max(A) 之前将 A 转换为 real(A)。在这种情况下，MATLAB 按 real(A) 比较元素，但生成的代码按 abs(A) 比较元素。要使生成的代码与 MATLAB 匹配，请使用 max(real(A)) 或 max(A,'ComparisonMethod','real')。请参阅具有零值虚部的复数数据的代码生成 (MATLAB Coder)。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

用法说明和限制：

不支持三维矩阵或更大矩阵的输入。
不支持具有复数数据类型的输入。
输入矩阵或向量的大小必须相等。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

max 函数完全支持 GPU 数组。要在 GPU 上运行该函数，请将输入数据指定为 gpuArray (Parallel Computing Toolbox)。有关详细信息，请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

用法说明和限制：

分布式表格输入不支持索引输出。

有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

全部展开

R2024b: 不支持将第二个输入数组指定为字符数组

将第二个输入数组指定为字符数组会返回错误。此更改最大限度地减少了与其他可指定为字符向量的参量（如缺失值条件）的混淆。为了保持以前的功能，您可以将第二个输入数组转换为 double，例如 max(A,double(B),"includenan")。

R2023b: 不支持将第二个输入数组指定为字符数组

将第二个输入数组指定为字符数组会发出警告，并将在以后的版本中生成错误。此更改最大限度地减少了与其他可指定为字符向量的参量（如缺失值条件）的混淆。为了保持以前的功能，您可以将第二个输入数组转换为 double，例如 max(A,double(B),"includenan")。

R2023a: 指定缺失值条件

使用 "omitmissing" 或 "includemissing" 选项计算最大值时，忽略还是包括输入数组中的所有缺失值。以前，"omitnan"、"includenan"、"omitnat"、"includenat"、"omitundefined" 和 "includeundefined" 会指定特定于输入数组的数据类型的缺失值条件。

R2023a: 直接对表和时间表执行计算

max 函数可以对表或时间表中的所有变量执行计算，而无需通过索引访问这些变量。所有变量都必须具有支持计算的数据类型。有关详细信息，请参阅Direct Calculations on Tables and Timetables。

R2021b: 指定比较方法

使用 ComparisonMethod 参数指定用于确定输入最大值的实数值或绝对值方法。

R2018b: 对多个维度执行运算

一次对输入数组的多个维度执行运算。指定一个由运算维度组成的向量，或指定 "all" 选项以对所有数组维度执行运算。

max

语法

说明

示例

向量中的最大元素

最大复数元素

每个矩阵列中的最大元素

每个矩阵行中的最大元素

数组页的最大值

包括缺失值的最大元素

最大元素索引

返回线性索引

最大元素比较

输入参数

A — 输入数组 标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

dim — 沿其运算的维度 正整数标量

vecdim — 维度向量 正整数向量

B — 其他输入数组 标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

missingflag — 缺失值条件 "omitmissing" (默认) | "omitnan" | "omitnat" | "omitundefined" | "includemissing" | "includenan" | "includenat" | "includeundefined"

method — 比较方法 "auto" (默认) | "real" | "abs"

输出参量

M — 最大值 标量 | 向量 | 矩阵 | 多维数组 | 表

I — 索引 标量 | 向量 | 矩阵 | 多维数组 | 表

C — A 或 B 中的最大元素 标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

扩展功能

tall 数组 对行数太多而无法放入内存的数组进行计算。

C/C++ 代码生成 使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

GPU 代码生成 使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

HDL 代码生成 使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组 使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

版本历史记录

R2024b: 不支持将第二个输入数组指定为字符数组

R2023b: 不支持将第二个输入数组指定为字符数组

R2023a: 指定缺失值条件

R2023a: 直接对表和时间表执行计算

R2021b: 指定比较方法

R2018b: 对多个维度执行运算

另请参阅

函数

主题

`A` — 输入数组
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

`dim` — 沿其运算的维度
正整数标量

`vecdim` — 维度向量
正整数向量

`B` — 其他输入数组
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

`missingflag` — 缺失值条件
`"omitmissing"` (默认) | `"omitnan"` | `"omitnat"` | `"omitundefined"` | `"includemissing"` | `"includenan"` | `"includenat"` | `"includeundefined"`

`method` — 比较方法
`"auto"` (默认) | `"real"` | `"abs"`

`M` — 最大值
标量 | 向量 | 矩阵 | 多维数组 | 表

`I` — 索引
标量 | 向量 | 矩阵 | 多维数组 | 表

`C` — `A` 或 `B` 中的最大元素
标量 | 向量 | 矩阵 | 多维数组 | 表 | 时间表

tall 数组
对行数太多而无法放入内存的数组进行计算。

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。