macro/command/waitln.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
  <title>waitln</title>
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="stylesheet" href="../../style.css" type="text/css">
</head>

<body>


<h1>waitln</h1>

<p>
文字列を含む行を待つ。
</p>

<pre class="macro-syntax">
waitln &lt;string1&gt; [&lt;string2&gt; ...]
</pre>

<h2>解説</h2>

<p>
文字列 &lt;string1&gt;, [&lt;string2&gt;, ...] のうち一つを含む行をホストから受信するか、タイムアウトが発生するまで MACRO を停止させる。文字列は最大 10 個まで指定できる。
</p>

<p>
システム変数 timeout か mtimeout が 0 より大きい場合、&lt;timeout&gt;.&lt;mtimeout&gt; 秒の時間がすぎるとタイムアウトが発生する。タイムアウトの値が 0 以下の場合は、タイムアウトは発生しない。
</p>

<p>
これらのコマンドは受信した行をシステム変数 inputstr に格納し、以下の値をシステム変数 result に格納する。
</p>

<table>
 <tr>
  <th>値</th>
  <th>意味</th>
 </tr>
 <tr>
  <td>0</td>
  <td>タイムアウト。</td>
 </tr>
 <tr>
  <td>1</td>
  <td>&lt;string1&gt; を含む行を受信した。</td>
 </tr>
 <tr>
  <td>2</td>
  <td>&lt;string2&gt; を含む行を受信した。</td>
 </tr>
 <tr>
  <td>n</td>
  <td>&lt;stringn&gt; を含む行を受信した。n=1..10</td>
 </tr>
</table>

</body>
</html>