<p>CLI で作業をするときに、どのように情報が入力されて出力をされるかを知っておくと良いです。</p>
<h2 id="標準入出力とは">標準入出力とは<a aria-hidden="true" tabindex="-1" href="#標準入出力とは"><span class="heading-link-icon" aria-hidden="true"></span></a></h2>
<p>Linuxでは、</p>
<ul>
<li>プログラムがデータを受け取る方法として「標準入力」(stdin)</li>
<li>データを出力する方法として「標準出力」(stdout)</li>
<li>「標準エラー出力」(stderr)</li>
</ul>
<p>があります。これらは以下のような特性を持っています：</p>
<h3 id="stdin">stdin<a aria-hidden="true" tabindex="-1" href="#stdin"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p>通常はキーボードからの入力を指します。デフォルトでは、ユーザがキーボードで入力したデータはstdinを通じてプログラムに送られます。</p>
<h3 id="stdout">stdout<a aria-hidden="true" tabindex="-1" href="#stdout"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p>通常は画面（コンソールやターミナル）に出力されるデータを指します。プログラムが処理結果を出力する際には、通常stdoutが使われ、その内容は画面に表示されます。</p>
<h3 id="stderr">stderr<a aria-hidden="true" tabindex="-1" href="#stderr"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p>通常は画面に出力されるデータを指しますが、stdoutとは別に<code>エラーメッセージ</code>や診断メッセージ専用の出力ストリームです。エラーメッセージは通常、stdoutとは別の出力ストリームであるstderrに出力されます。</p>
<hr>
<p>この３つのチャネルは内部では数値として扱われます。</p>
<table>
<thead>
<tr>
<th align="center">チャネル</th>
<th align="center">数値</th>
</tr>
</thead>
<tbody>
<tr>
<td align="center">stdin</td>
<td align="center">0</td>
</tr>
<tr>
<td align="center">stdout</td>
<td align="center">1</td>
</tr>
<tr>
<td align="center">stderr</td>
<td align="center">2</td>
</tr>
</tbody>
</table>
<p>入力にはキーボード、出力にはディスプレイが使われることが多いのですが、それらは変更することができて、正確には<code>標準入力へ入力し、標準出力に出力する。</code>です。</p>
<p>変更先は入力だったらファイルにしたり、出力をプリンターにすることもできます。</p>
<p>stdout と stderr は同じ出力ですが、別れており、別々に扱うことができ便利です。</p>
<h2 id="リダイレクト">リダイレクト<a aria-hidden="true" tabindex="-1" href="#リダイレクト"><span class="heading-link-icon" aria-hidden="true"></span></a></h2>
<p>リダイレクトはそのまま、<code>標準入力へ入力し、標準出力に出力する。</code>の入力と出力の対象を変更することです。</p>
<h3 id="stdin-の対象を変更する">stdin の対象を変更する<a aria-hidden="true" tabindex="-1" href="#stdin-の対象を変更する"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p><code>&#x3C; 入力元</code> で入力元を指定します。</p>
<p>例として、catコマンドのよくある使い方は、ファイル名を引数として受け取り、その内容を表示することです。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token comment"># file.txt の内容を表示する</span>
$ <span class="token function">cat</span> file.txt
</code></pre></div>
<p>しかし、本来 cat は標準入力された内容をそのまま標準出力に出力するコマンドです。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token comment"># 標準入力された内容をそのまま標準出力に出力する</span>
$ <span class="token function">cat</span>
入力待機されて入力したものが表示される

<span class="token comment"># 入力先を指定して file.txt の内容を表示する</span>
$ <span class="token function">cat</span> <span class="token operator">&#x3C;</span> file.txt
</code></pre></div>
<p><code>cat &#x3C; file.txt</code> の方が自然なコマンドの使い方です。</p>
<h3 id="stdout-の対象を変更する">stdout の対象を変更する<a aria-hidden="true" tabindex="-1" href="#stdout-の対象を変更する"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p><code>> 出力先</code> で出力先を指定します。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token comment"># すでに file.txt が存在する場合は上書きされる</span>
$ <span class="token function">ls</span> <span class="token operator">></span> file.txt
</code></pre></div>
<p><code>ls</code> の出力結果が <code>file.txt</code> に書き込まれます。</p>
<p>事前に出力先のファイルを作成することは<code>不要</code>です。</p>
<p>また、<code>></code> はファイルの内容を上書きします。<code>追記したい場合</code>は <code>>></code> を使います。</p>
<p><code>>></code> で<code>新規作成もできる</code>ため、誤って以前の内容を消さないようにこちらの方を使うのが良いでしょう。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token comment"># すでに file.txt が存在する場合は追記される</span>
$ <span class="token function">ls</span> <span class="token operator">>></span> file.txt
</code></pre></div>
<h3 id="stderr-の対象を変更する">stderr の対象を変更する<a aria-hidden="true" tabindex="-1" href="#stderr-の対象を変更する"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p><code>2> 出力先</code> で出力先を指定します。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token comment"># 存在しないディレクトリを指定するとエラーが出力される</span>
$ <span class="token function">ls</span> /nonexistent_directory <span class="token operator"><span class="token file-descriptor important">2</span>></span> error.txt
</code></pre></div>
<p><code>ls</code> のエラー結果が <code>error.txt</code> に書き込まれます。</p>
<p>また <code>2>></code> で追記することもできます。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token comment"># error.txt が存在しない場合は新規作成され、存在する場合は追記される</span>
$ <span class="token function">ls</span> /nonexistent_directory <span class="token operator"><span class="token file-descriptor important">2</span>>></span> error.txt
</code></pre></div>
<h2 id="devnull">/dev/null<a aria-hidden="true" tabindex="-1" href="#devnull"><span class="heading-link-icon" aria-hidden="true"></span></a></h2>
<p><code>/dev/null</code> は、特殊なファイルで、書き込まれた内容は破棄されます。</p>
<p><code>/dev/null</code> に書き込むと、何も出力されないので、出力を捨てたい場合に使います。</p>
<p>また入力先に指定しても、何も入力されないので、入力を捨てたい場合にも使います。</p>
<h2 id="スニペット">スニペット<a aria-hidden="true" tabindex="-1" href="#スニペット"><span class="heading-link-icon" aria-hidden="true"></span></a></h2>
<h3 id="stdoutとstderrで出力先を別々に指定する方法">stdoutとstderrで出力先を別々に指定する方法<a aria-hidden="true" tabindex="-1" href="#stdoutとstderrで出力先を別々に指定する方法"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p>stdoutとstderrをそれぞれ別のファイルにリダイレクトする。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token builtin class-name">command</span> <span class="token operator">></span> stdout.txt <span class="token operator"><span class="token file-descriptor important">2</span>></span> stderr.txt
</code></pre></div>
<h3 id="stdoutとstderrを同じファイルに出力する方法">stdoutとstderrを同じファイルに出力する方法<a aria-hidden="true" tabindex="-1" href="#stdoutとstderrを同じファイルに出力する方法"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p><code>2>&#x26;1</code>で stdout と stderr を同じファイルにリダイレクトする。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token builtin class-name">command</span> <span class="token operator">></span> output.txt <span class="token operator"><span class="token file-descriptor important">2</span>></span><span class="token file-descriptor important">&#x26;1</span>
</code></pre></div>
<p><code>2>&#x26;1</code> は 2(エラー出力)を1(標準出力)にリダイレクトするという意味になります。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell">$ <span class="token builtin class-name">command</span> <span class="token operator">&#x26;></span> output.txt
</code></pre></div>
<p><code>&#x26;></code> は <code>2>&#x26;1</code> と同じ意味になります。</p>
<h3 id="エラーメッセージだけを表示する">エラーメッセージだけを表示する<a aria-hidden="true" tabindex="-1" href="#エラーメッセージだけを表示する"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p>エラーメッセージだけ表示するには stdout を捨てて、stderrだけを残せば可能です。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token comment"># stdout は捨てられるためエラーメッセージだけが表示される</span>
<span class="token builtin class-name">command</span> <span class="token operator">></span> /dev/null
</code></pre></div>
<h3 id="stdout-だけを表示する">stdout だけを表示する<a aria-hidden="true" tabindex="-1" href="#stdout-だけを表示する"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p>エラーメッセージだけを表示するの逆で、stderr を捨てて、stdoutだけを残せば可能です。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token comment"># stderr は捨てられるためエラーメッセージだけが表示される</span>
<span class="token builtin class-name">command</span> <span class="token operator"><span class="token file-descriptor important">2</span>></span> /dev/null
</code></pre></div>
<h3 id="何も表示させなくする">何も表示させなくする<a aria-hidden="true" tabindex="-1" href="#何も表示させなくする"><span class="heading-link-icon" aria-hidden="true"></span></a></h3>
<p>stdout と stderr を捨てます。</p>
<div class="remark-highlight"><pre class="language-shell"><code class="language-shell"><span class="token comment"># stdout と stderr は捨てられるため何も表示されない</span>
<span class="token builtin class-name">command</span> <span class="token operator">></span> /dev/null <span class="token operator"><span class="token file-descriptor important">2</span>></span><span class="token file-descriptor important">&#x26;1</span>
</code></pre></div>
<h2 id="tip">TIP<a aria-hidden="true" tabindex="-1" href="#tip"><span class="heading-link-icon" aria-hidden="true"></span></a></h2>
<p>Linux でコマンドを作るとき、ファイルを指定するよりも、標準入力から受け取るようにすると、そのプログラムの汎用性が高まります。</p>

Tag: stdin