ci: generate pages at b53a272 [ci skip]

Author: bn-e

docs/print.html

@@ -12612,9 +12612,16 @@ <h1 id="ファイル-io"><a class="header" href="#ファイル-io">ファイル
 -->
 <p><a href="https://doc.rust-lang.org/std/fs/struct.OpenOptions.html"><code>OpenOptions</code></a>構造体を利用して、ファイルの開き方を設定できます。</p>
 <div style="break-before: page; page-break-before: always;"></div><h1 id="read_lines"><a class="header" href="#read_lines"><code>read_lines</code></a></h1>
-<h2 id="a-naive-approach"><a class="header" href="#a-naive-approach">A naive approach</a></h2>
-<p>This might be a reasonable first attempt for a beginner's first
-implementation for reading lines from a file.</p>
+<!--
+## A naive approach
+-->
+<h2 id="単純なやり方"><a class="header" href="#単純なやり方">単純なやり方</a></h2>
+<!--
+This might be a reasonable first attempt for a beginner's first
+implementation for reading lines from a file.
+-->
+<p>テキストファイルの行を読み込むのを、初心者が初めて実装した場合、
+以下のようになるでしょう。</p>
 <pre><pre class="playground"><code class="language-rust norun edition2021"><span class="boring">#![allow(unused)]
 </span><span class="boring">fn main() {
 </span>use std::fs::read_to_string;
@@ -12629,37 +12636,63 @@ <h2 id="a-naive-approach"><a class="header" href="#a-naive-approach">A naive app
     result
 }
 <span class="boring">}</span></code></pre></pre>
-<p>Since the method <code>lines()</code> returns an iterator over the lines in the file,
+<!--
+Since the method `lines()` returns an iterator over the lines in the file,
 we can also perform a map inline and collect the results, yielding a more
-concise and fluent expression.</p>
+concise and fluent expression.
+-->
+<p><code>lines()</code>メソッドはファイルの各行のイテレータを返すので、
+インラインでマップを実行し結果を収集することもできます。
+そうすると、より簡潔で読みやすい表現となります。</p>
 <pre><pre class="playground"><code class="language-rust norun edition2021"><span class="boring">#![allow(unused)]
 </span><span class="boring">fn main() {
 </span>use std::fs::read_to_string;
 
 fn read_lines(filename: &amp;str) -&gt; Vec&lt;String&gt; {
     read_to_string(filename) 
         .unwrap()  // panic on possible file-reading errors
+                   // ファイル読み込みエラーの場合はパニックする。
         .lines()  // split the string into an iterator of string slices
+                  // 文字列のスライスのイテレータに分割する。
         .map(String::from)  // make each slice into a string
+                            // スライスを文字列に変換する。
         .collect()  // gather them together into a vector
+                    // ベクタにまとめる。
 }
 <span class="boring">}</span></code></pre></pre>
-<p>Note that in both examples above, we must convert the <code>&amp;str</code> reference
-returned from <code>lines()</code> to the owned type <code>String</code>, using <code>.to_string()</code>
-and <code>String::from</code> respectively.</p>
-<h2 id="a-more-efficient-approach"><a class="header" href="#a-more-efficient-approach">A more efficient approach</a></h2>
-<p>Here we pass ownership of the open <code>File</code> to a <code>BufReader</code> struct. <code>BufReader</code> uses an internal
-buffer to reduce intermediate allocations.</p>
-<p>We also update <code>read_lines</code> to return an iterator instead of allocating new
-<code>String</code> objects in memory for each line.</p>
+<!--
+Note that in both examples above, we must convert the `&str` reference
+returned from `lines()` to the owned type `String`, using `.to_string()`
+and `String::from` respectively.
+-->
+<p>上の例では、<code>lines()</code>から返された<code>&amp;str</code>を
+それぞれ<code>to_string()</code>と<code>String::from</code>を使って、
+所有権のある<code>String</code>型に変換しなければならない点に注意してください。</p>
+<!--
+## A more efficient approach
+-->
+<h2 id="より効率的なやり方"><a class="header" href="#より効率的なやり方">より効率的なやり方</a></h2>
+<!--
+Here we pass ownership of the open `File` to a `BufReader` struct. `BufReader` uses an internal
+buffer to reduce intermediate allocations.
+-->
+<p>ここでは、開いた<code>File</code>の所有権を<code>BufReader</code>構造体に渡します。
+<code>BufReader</code>は内部的なバッファを使い、中間のメモリ割り当てを削減します。</p>
+<!--
+We also update `read_lines` to return an iterator instead of allocating new
+`String` objects in memory for each line.
+-->
+<p><code>read_lines</code>を更新して、それぞれの行に対してメモリ上に新しい<code>String</code>オブジェクトを割り当てるのではなく、イテレータを返すようにします。</p>
 <pre><pre class="playground"><code class="language-rust no_run edition2021">use std::fs::File;
 use std::io::{self, BufRead};
 use std::path::Path;
 
 fn main() {
     // File hosts.txt must exist in the current path
+    // hosts.txtファイルは現在のパスに存在しなければならない。
     if let Ok(lines) = read_lines(&quot;./hosts.txt&quot;) {
         // Consumes the iterator, returns an (Optional) String
+        // イテレータを消費し、Option型のStringを返す。
         for line in lines {
             if let Ok(ip) = line {
                 println!(&quot;{}&quot;, ip);
@@ -12670,21 +12703,34 @@ <h2 id="a-more-efficient-approach"><a class="header" href="#a-more-efficient-app
 
 // The output is wrapped in a Result to allow matching on errors
 // Returns an Iterator to the Reader of the lines of the file.
+// 出力はResult型にラップされ、エラーをマッチできるようになる。
+// ファイルの各行のReaderへのイテレータを返す。
 fn read_lines&lt;P&gt;(filename: P) -&gt; io::Result&lt;io::Lines&lt;io::BufReader&lt;File&gt;&gt;&gt;
 where P: AsRef&lt;Path&gt;, {
     let file = File::open(filename)?;
     Ok(io::BufReader::new(file).lines())
 }</code></pre></pre>
-<p>Running this program simply prints the lines individually.</p>
+<!--
+Running this program simply prints the lines individually.
+-->
+<p>このプログラムを実行すると、単に各行をプリントします。</p>
 <pre><code class="language-shell">$ echo -e &quot;127.0.0.1\n192.168.0.1\n&quot; &gt; hosts.txt
 $ rustc read_lines.rs &amp;&amp; ./read_lines
 127.0.0.1
 192.168.0.1
 </code></pre>
-<p>(Note that since <code>File::open</code> expects a generic <code>AsRef&lt;Path&gt;</code> as argument, we define our
-generic <code>read_lines()</code> method with the same generic constraint, using the <code>where</code> keyword.)</p>
-<p>This process is more efficient than creating a <code>String</code> in memory with all of the file's
-contents. This can especially cause performance issues when working with larger files.</p>
+<!--
+(Note that since `File::open` expects a generic `AsRef<Path>` as argument, we define our
+generic `read_lines()` method with the same generic constraint, using the `where` keyword.)
+-->
+<p><code>File::open</code>はジェネリックな<code>AsRef&lt;Path&gt;</code>を引数にとるので、
+ジェネリックな<code>read_lines</code>メソッドも、<code>where</code>キーワードを使って、同じジェネリックな制約を持たせています。</p>
+<!--
+This process is more efficient than creating a `String` in memory with all of the file's
+contents. This can especially cause performance issues when working with larger files.
+-->
+<p>この処理は、ファイルの中身全てをメモリ上の<code>String</code>にするよりも効率的です。
+メモリ上に<code>String</code>を作ると、より大きなファイルを取り扱う際に、パフォーマンスの問題につながります。</p>
 <div style="break-before: page; page-break-before: always;"></div><!--
 # Child processes
 -->

docs/searchindex.js

@@ -146,9 +146,16 @@ <h1 class="menu-title">Rust By Example 日本語版</h1>
                 <div id="content" class="content">
                     <main>
                         <h1 id="read_lines"><a class="header" href="#read_lines"><code>read_lines</code></a></h1>
-<h2 id="a-naive-approach"><a class="header" href="#a-naive-approach">A naive approach</a></h2>
-<p>This might be a reasonable first attempt for a beginner's first
-implementation for reading lines from a file.</p>
+<!--
+## A naive approach
+-->
+<h2 id="単純なやり方"><a class="header" href="#単純なやり方">単純なやり方</a></h2>
+<!--
+This might be a reasonable first attempt for a beginner's first
+implementation for reading lines from a file.
+-->
+<p>テキストファイルの行を読み込むのを、初心者が初めて実装した場合、
+以下のようになるでしょう。</p>
 <pre><pre class="playground"><code class="language-rust norun edition2021"><span class="boring">#![allow(unused)]
 </span><span class="boring">fn main() {
 </span>use std::fs::read_to_string;
@@ -163,37 +170,63 @@ <h2 id="a-naive-approach"><a class="header" href="#a-naive-approach">A naive app
     result
 }
 <span class="boring">}</span></code></pre></pre>
-<p>Since the method <code>lines()</code> returns an iterator over the lines in the file,
+<!--
+Since the method `lines()` returns an iterator over the lines in the file,
 we can also perform a map inline and collect the results, yielding a more
-concise and fluent expression.</p>
+concise and fluent expression.
+-->
+<p><code>lines()</code>メソッドはファイルの各行のイテレータを返すので、
+インラインでマップを実行し結果を収集することもできます。
+そうすると、より簡潔で読みやすい表現となります。</p>
 <pre><pre class="playground"><code class="language-rust norun edition2021"><span class="boring">#![allow(unused)]
 </span><span class="boring">fn main() {
 </span>use std::fs::read_to_string;
 
 fn read_lines(filename: &amp;str) -&gt; Vec&lt;String&gt; {
     read_to_string(filename) 
         .unwrap()  // panic on possible file-reading errors
+                   // ファイル読み込みエラーの場合はパニックする。
         .lines()  // split the string into an iterator of string slices
+                  // 文字列のスライスのイテレータに分割する。
         .map(String::from)  // make each slice into a string
+                            // スライスを文字列に変換する。
         .collect()  // gather them together into a vector
+                    // ベクタにまとめる。
 }
 <span class="boring">}</span></code></pre></pre>
-<p>Note that in both examples above, we must convert the <code>&amp;str</code> reference
-returned from <code>lines()</code> to the owned type <code>String</code>, using <code>.to_string()</code>
-and <code>String::from</code> respectively.</p>
-<h2 id="a-more-efficient-approach"><a class="header" href="#a-more-efficient-approach">A more efficient approach</a></h2>
-<p>Here we pass ownership of the open <code>File</code> to a <code>BufReader</code> struct. <code>BufReader</code> uses an internal
-buffer to reduce intermediate allocations.</p>
-<p>We also update <code>read_lines</code> to return an iterator instead of allocating new
-<code>String</code> objects in memory for each line.</p>
+<!--
+Note that in both examples above, we must convert the `&str` reference
+returned from `lines()` to the owned type `String`, using `.to_string()`
+and `String::from` respectively.
+-->
+<p>上の例では、<code>lines()</code>から返された<code>&amp;str</code>を
+それぞれ<code>to_string()</code>と<code>String::from</code>を使って、
+所有権のある<code>String</code>型に変換しなければならない点に注意してください。</p>
+<!--
+## A more efficient approach
+-->
+<h2 id="より効率的なやり方"><a class="header" href="#より効率的なやり方">より効率的なやり方</a></h2>
+<!--
+Here we pass ownership of the open `File` to a `BufReader` struct. `BufReader` uses an internal
+buffer to reduce intermediate allocations.
+-->
+<p>ここでは、開いた<code>File</code>の所有権を<code>BufReader</code>構造体に渡します。
+<code>BufReader</code>は内部的なバッファを使い、中間のメモリ割り当てを削減します。</p>
+<!--
+We also update `read_lines` to return an iterator instead of allocating new
+`String` objects in memory for each line.
+-->
+<p><code>read_lines</code>を更新して、それぞれの行に対してメモリ上に新しい<code>String</code>オブジェクトを割り当てるのではなく、イテレータを返すようにします。</p>
 <pre><pre class="playground"><code class="language-rust no_run edition2021">use std::fs::File;
 use std::io::{self, BufRead};
 use std::path::Path;
 
 fn main() {
     // File hosts.txt must exist in the current path
+    // hosts.txtファイルは現在のパスに存在しなければならない。
     if let Ok(lines) = read_lines(&quot;./hosts.txt&quot;) {
         // Consumes the iterator, returns an (Optional) String
+        // イテレータを消費し、Option型のStringを返す。
         for line in lines {
             if let Ok(ip) = line {
                 println!(&quot;{}&quot;, ip);
@@ -204,21 +237,34 @@ <h2 id="a-more-efficient-approach"><a class="header" href="#a-more-efficient-app
 
 // The output is wrapped in a Result to allow matching on errors
 // Returns an Iterator to the Reader of the lines of the file.
+// 出力はResult型にラップされ、エラーをマッチできるようになる。
+// ファイルの各行のReaderへのイテレータを返す。
 fn read_lines&lt;P&gt;(filename: P) -&gt; io::Result&lt;io::Lines&lt;io::BufReader&lt;File&gt;&gt;&gt;
 where P: AsRef&lt;Path&gt;, {
     let file = File::open(filename)?;
     Ok(io::BufReader::new(file).lines())
 }</code></pre></pre>
-<p>Running this program simply prints the lines individually.</p>
+<!--
+Running this program simply prints the lines individually.
+-->
+<p>このプログラムを実行すると、単に各行をプリントします。</p>
 <pre><code class="language-shell">$ echo -e &quot;127.0.0.1\n192.168.0.1\n&quot; &gt; hosts.txt
 $ rustc read_lines.rs &amp;&amp; ./read_lines
 127.0.0.1
 192.168.0.1
 </code></pre>
-<p>(Note that since <code>File::open</code> expects a generic <code>AsRef&lt;Path&gt;</code> as argument, we define our
-generic <code>read_lines()</code> method with the same generic constraint, using the <code>where</code> keyword.)</p>
-<p>This process is more efficient than creating a <code>String</code> in memory with all of the file's
-contents. This can especially cause performance issues when working with larger files.</p>
+<!--
+(Note that since `File::open` expects a generic `AsRef<Path>` as argument, we define our
+generic `read_lines()` method with the same generic constraint, using the `where` keyword.)
+-->
+<p><code>File::open</code>はジェネリックな<code>AsRef&lt;Path&gt;</code>を引数にとるので、
+ジェネリックな<code>read_lines</code>メソッドも、<code>where</code>キーワードを使って、同じジェネリックな制約を持たせています。</p>
+<!--
+This process is more efficient than creating a `String` in memory with all of the file's
+contents. This can especially cause performance issues when working with larger files.
+-->
+<p>この処理は、ファイルの中身全てをメモリ上の<code>String</code>にするよりも効率的です。
+メモリ上に<code>String</code>を作ると、より大きなファイルを取り扱う際に、パフォーマンスの問題につながります。</p>
 
                     </main>