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

findTask

在作业中查找任务

全页折叠

语法

tasks = findTask(j)
tasks = findTask(j,taskFcn)
[pending,running,completed] = findTask(j)
tasks = findTask(j,propertyName=Value)

说明

tasks = findTask(j) 返回作业 1 中的任务对象的 N by-j 数组。数组中的任务按照其 ID 属性的顺序排列，表明它们的创建顺序。

示例

tasks = findTask(j,taskFcn) 返回作业 j 中的任务对象数组，使用 taskFcn 属性进行过滤。taskFcn 是一个函数句柄，它接受 j.Tasks 属性作为输入参量，并返回指示要返回的任务的逻辑数组。

[pending,running,completed] = findTask(j) 对作业 j 中存储的所有任务按状态进行排序。在 pending,running,completed 数组中，软件按照创建顺序返回任务。

tasks = findTask(j,propertyName=Value) 使用一个或多个属性名称-值参量指定要查找的属性和值。有关任务属性的列表，请参阅 parallel.Task。

对象属性值必须与指定的值完全匹配。例如，如果某个任务的 Name 属性值 MyTask，则 findTask 在搜索 Name 属性值 mytask 的任务时找不到该对象。

示例

全部折叠

在默认集群上创建一个作业对象。

c = parcluster;
j = createJob(c);

创建并添加任务到作业对象。

createTask(j,@rand,1,{10})

查找现在属于作业 j 的所有任务对象。

t = findTask(j)

输入参数

全部折叠

软件在其中找到任务的作业，指定为 parallel.Job 对象。

findTask 用于过滤来自作业 j 的任务的函数，指定为函数句柄。

要查找的任务对象属性名称和值，指定为 parallel.task 属性名称-值参量。如果指定多个属性名称-值参量，findJob 将返回满足所有搜索条件的条目。有关任务对象属性的完整列表，请参阅 parallel.Task。

示例: findTask(job,Name="jsmith") 查找 Name 属性值 jsmith 的任务对象。

输出参量

全部折叠

作业中符合搜索条件的任务，以 parallel.Task 对象数组的形式返回。

作业中处于待处理状态的任务，以 parallel.Task 对象数组的形式返回。

作业中处于运行状态的任务，以 parallel.Task 对象数组的形式返回。

作业中处于完成或失败状态的任务，以 parallel.Task 对象数组的形式返回。

提示

如果作业 j 包含在远程服务中，则 findTask 会导致调用远程服务。这可能导致 findTask 需要很长时间才能完成，具体取决于检索到的任务数量和网络速度。此外，如果远程服务不再可用，软件就会抛出错误。

版本历史记录

在 R2006a 之前推出

另请参阅

| |