Sophie: yash-doc-2.28-1.fc14 noarch

yash-doc-2.28-1.fc14.noarch.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
    "http://www.w3.org/TR/html4/strict.dtd">
<html lang="ja">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="Content-Script-Type" content="text/javascript">
<meta http-equiv="Content-Style-Type" content="text/css">
<meta name="author" content="magicant">
<meta name="description" content="Yash の read 組込みコマンドについて">
<title>Yash マニュアル: read 組込みコマンド</title>
<link rel="Contents" href="../index.html" title="目次">
<link rel="Prev" href="pwd.html" title="Pwd 組込みコマンド">
<link rel="Next" href="readonly.html" title="Readonly 組込みコマンド">
<link rel="Stylesheet" href="../style.css">

<div class="breadcrumb"><a href="../index.html">目次</a> >
<a rel="Up" href="index.html">組込みコマンド一覧</a></div>
<h1>Read 組込みコマンド</h1>

<p><dfn>Read 組込みコマンド</dfn>は標準入力から行を読み込み変数に代入します。

<h2 id="syntax">構文</h2>
<ul>
<li><code>read [-Ar] <var>変数名</var>…</code>
</ul>

<h2 id="description">説明</h2>
<p>Read コマンドは標準入力から一行の文字列を読み込み、それを<a href="../params.html#variables">変数</a>に代入します。シェルが<a href="../interact.html">対話モード</a>で、<a href="../lineedit.html">行編集</a>を利用するオプションが有効ならば、読み込みに行編集を使用します。
<p><code>-r</code> (<code>--raw-mode</code>) オプションを付けない場合、読み込んだ文字列の中のバックスラッシュ (<code>\</code>) は<a href="../syntax.html#quotes">引用符</a>として働きます。バックスラッシュが行末にあるときは行の連結を行います。<a href="../interact.html">対話モード</a>のシェルが 2 行目以降を読み込むとき、標準入力が端末ならば <a href="../params.html#sv-ps2"><code>PS2</code> 変数</a>の値がプロンプトとして出力されます。
<p><code>-r</code> (<code>--raw-mode</code>) オプションを付けると、行内のバックスラッシュは通常の文字と同様に扱われます。
<p>読み込んだ文字列は、<a href="../expand.html#split">単語分割</a>によって分割します。分割後の各文字列が、それぞれオペランドで指定された変数の値に順に設定されます。指定された変数の数より分割結果のほうが多い場合は、最後の変数に残りの分割結果の全てが入ります。分割結果の数より指定された変数のほうが多い場合は、余った変数には空文字列が入ります。

<h2 id="options">オプション</h2>
<dl>
<dt><code>-A</code>, <code>--array</code>
<dd>最後に指定した変数を<a href="../params.html#arrays">配列</a>にします。分割後の各文字列が配列の要素として設定されます。
<dt><code>-r</code>, <code>--raw-mode</code>
<dd>読み込んだ文字列の中のバックスラッシュを引用符として扱わないようにします。
</dl>

<h2 id="operands">オペランド</h2>
<dl>
<dt><var>変数名</var>
<dd>読み込んだ文字列を格納する変数の名前です。
</dl>

<h2 id="exitstatus">終了ステータス</h2>
<p>エラーがない限り read コマンドの終了ステータスは 0 です。

<h2 id="notes">補足</h2>
<p>Read コマンドは<a href="../builtin.html#types">準特殊組込みコマンド</a>です。
<p>POSIX には <code>-A</code> (<code>--array</code>) オプションに関する規定はありません。よってこのオプションは <a href="../posix.html">POSIX 準拠モード</a>では使えません。