主要内容

parfevalOnAll

在后台在所有工作单元上运行函数

    说明

    F = parfevalOnAll(backgroundPool,fcn,numFcnOut,X1,...,Xm) 将函数 fcn 调度到在后台在所有工作单元上运行。当 MATLAB® 正在运行函数 fcn 时,您可以运行其他代码。有关工作单元和后台的详细信息,请参阅Background Workers

    注意

    仅当您有 Parallel Computing Toolbox™ 时,BackgroundPool 才有多个工作单元。

    使用 backgroundPool 在后台运行代码时,无需使用 parfevalOnAll 设置环境变量。

    要在一个并行池中的所有工作单元上运行函数,请参阅 parfevalOnAll (Parallel Computing Toolbox)

    MATLAB 使用 X1X2、…、Xm 输入参量对每个工作单元以异步方式计算函数 fcn,并返回 numFcnOut 个输出参量。

    MATLAB 在函数 fcn 在所有后台工作单元上运行完毕之前返回 Future 对象 F。您可以使用 fetchOutputs 从 future 对象检索结果。要停止运行函数 fcn,请使用 cancel 函数。有关 future 对象的详细信息,请参阅 Future

    F = parfevalOnAll(fcn,numFcnOut,X1,...,Xm) 调度要运行的函数 fcn

    MATLAB 在函数 fcn 完成运行之前返回 Future 对象 F

    在设计用于 Parallel Computing Toolbox 的代码中使用此语法。

    • 如果您没有 Parallel Computing Toolbox,则不能使用任何并行资源。该函数以串行方式运行。

    • 如果您有 Parallel Computing Toolbox,parfevalOnAll 会自动使用并行资源。

    输入参数

    全部折叠

    要运行的函数,指定为函数句柄。

    示例: fcn = @magic

    函数 fcn 请求的输出参量数目,指定为非负整数标量。

    numFcnOut 是您在运行 fcn(X1,...,Xm) 时请求的输出参量的数目。

    数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    输入参量,指定为以逗号分隔的变量或表达式列表。

    输出参量

    全部折叠

    输出 Future,以 parallel.Future 对象形式返回。

    扩展功能

    全部展开

    另请参阅

    (Parallel Computing Toolbox) | | | | | | |