本页采用了机器翻译。点击此处可查看最新英文版本。

load

从批处理作业加载工作区变量

全页折叠

    语法

    load(j)
    load(j,variables)
    S = load(___)

    说明

    load(j) 从运行脚本或表达式的 batch 作业 j 加载所有变量。变量被分配到当前工作区中。如果当前工作区中存在同名的变量，则会被覆盖。

    作业的工作区变量存储在该作业运行的集群的 JobStorageLocation 属性指定的位置。当您运行 load 时，该数据不会从 JobStorageLocation 中删除。要删除工作区数据，请使用 delete 函数删除单个任务或整个作业。

    如果出现以下情况，load 函数将会抛出错误：

    • 作业 j 的 State 属性不是 'finished'。

    • 作业 j 的 State 属性为 'finished'，并且作业 j 的 Tasks 属性给出的任务之一遇到错误。

    提示

    要查看作业 j 上的任何任务是否在遇到错误后失败，请检查 j.Tasks.Error 是否为空。如果返回的数组为空，则表示作业 j 上的所有任务均未遇到任何错误。

    如果某些任务成功完成，您可以使用任务的 OutputArguments 属性直接访问该任务的输出参量。

    示例

    load(j,variables) 将作业 j 中的变量加载到当前工作区。

    S = load(___) 创建一个包含来自作业的变量的结构体。例如，S = load(j) 将作业 j 中的所有变量加载到 S 中。

    示例

    全部折叠

    运行批处理作业，然后检索该作业的输出。

    将值 3 分配给变量 x。然后，使用 batch 使用默认集群配置文件创建作业。在该作业中，在工作单元上运行表达式 'y = magic(x)'。

    x = 3;
j = batch('y = magic(x)');

    当您创建作业时，变量 x 会自动从客户端工作区复制到运行批处理作业的工作单元。

    等待作业完成。然后，使用 load 将作业中的变量加载到客户端工作区。

    wait(j)
load(j);

    变量 x 和 y 现在可在客户端上使用。显示 y 中的值。

    y
    ans =

     8     1     6
     3     5     7
     4     9     2

    输入参数

    全部折叠

    批处理作业，指定为 parallel.Job 对象。要创建批处理作业，请使用 batch。

    要加载的变量的名称，指定为一个或多个字符向量或字符串标量。

    variables 可以采用下列形式之一。

    variables 输入的形式要加载的变量
    var1,...,varN加载列出的变量，指定为单独的字符向量或字符串。
    使用 '*' 通配符来匹配模式。
    '-regexp',expr1,...,exprN仅加载名称与正则表达式匹配的变量或字段，指定为字符向量或字符串。

    示例: load(j,'A*')

    示例: load(j,'A','B*','C')

    示例: load(j,'-regexp','^Mon',^Tues')

    输出参量

    全部折叠

    加载的变量，以结构体标量形式返回。

    版本历史记录

    在 R2008a 中推出

    另请参阅

    | | |