このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
findTask
ジョブ オブジェクトに属するタスク オブジェクト
構文
tasks = findTask(j)
tasks = findTask(j, taskFcn)
[pending running completed] = findTask(j)
tasks = findTask(j,'p1
',v1,'p2
',v2,...)
引数
| ジョブ オブジェクト |
| 返されるタスク オブジェクト |
| ジョブ |
| ジョブ |
| ジョブ |
| 照合するタスク オブジェクト プロパティ |
| 対応するオブジェクト プロパティの値 |
説明
tasks = findTask(j)
は、ジョブ オブジェクト j
に属するタスク オブジェクトからなる 1 行 N 列の配列を返します。配列内のタスクは、タスクの作成順を示す ID
プロパティによって順序付けられています。
tasks = findTask(j, taskFcn)
は、taskFcn
を使用して、ジョブ j
に属するタスク オブジェクトの配列を選択して返します。taskFcn
は入力引数として j.Tasks
を受け入れる関数ハンドルであり、返すタスクを示す logical 配列を返します。
[pending running completed] = findTask(j)
は、ジョブ オブジェクト j
に保存されているすべてのタスク オブジェクトからなる、state
別に並べ替えられた配列を返します。各配列 (pending
、running
および completed
) 内では、タスクは作成順に返されます。
tasks = findTask(j,'
は、ジョブ オブジェクト p1
',v1,'p2
',v2,...) j
に属するタスク オブジェクトからなる配列を返します。返されるタスク オブジェクトは、p1
、v1
、p2
、v2
など、指定されたプロパティと値のペアに一致するもののみとなります。プロパティ名は文字ベクトルでなければならず、その値はそのプロパティに適した型でなければなりません。一致と認められるには、オブジェクト プロパティの値が、大文字と小文字の区別も含めて、指定された値と厳密に同じでなければなりません。たとえば、タスクの Name
プロパティ値が MyTask
の場合、mytask
という Name
プロパティ値を検索しても、findTask
はこのオブジェクトを検出しません。
例
ジョブ オブジェクトを作成します。
c = parcluster(); j = createJob(c);
ジョブ オブジェクトにタスクを追加します。
createTask(j,@rand,1,{10})
ジョブ j
に追加されたすべてのタスク オブジェクトを検索します。
t = findTask(j)
ヒント
ジョブ j
がリモート サービスに含まれる場合、findTask
によりそのリモート サービスが呼び出されます。このため、取得されるタスクの数とネットワーク速度次第で、findTask
の完了に長時間かかる可能性があります。また、リモート サービスが使用可能でなくなるとエラーがスローされます。
バージョン履歴
R2006a より前に導入