Go の Range について学習します。

Range - Golang learning step 1-11

<a href="https://roadmap.sh/" rel="noopener noreferrer" target="_blank">roadmap.sh</a> > <a href="https://roadmap.sh/golang" rel="noopener noreferrer" target="_blank">Go</a> > Learn the Basics > Range の学習を進めていきます。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/279/01.png" width="1576" height="1146" alt="学習箇所"></div>
※ 学習メモとしての記録ですが、後にこのセクションを学ぶ道しるべとなるよう、ですます調で記載しています。
<h2 id="contents">contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#range%E3%83%AC%E3%83%B3%E3%82%B8">Range（レンジ）</a></li>
<li><a href="#%E9%85%8D%E5%88%97%E3%82%84%E3%82%B9%E3%83%A9%E3%82%A4%E3%82%B9%E3%81%AB%E5%AF%BE%E3%81%99%E3%82%8B-range">配列やスライスに対する range</a>
<ol>
<li><a href="#%E6%B3%A8%E6%84%8F%E7%82%B9">注意点</a></li>
</ol>
</li>
<li><a href="#%E3%83%9E%E3%83%83%E3%83%97%E3%81%AB%E5%AF%BE%E3%81%99%E3%82%8B-range">マップに対する range</a></li>
<li><a href="#%E6%96%87%E5%AD%97%E5%88%97%E3%81%AB%E5%AF%BE%E3%81%99%E3%82%8B-range">文字列に対する range</a>
<ol>
<li><a href="#%E6%B3%A8%E6%84%8F%E7%82%B9-1">注意点</a></li>
</ol>
</li>
<li><a href="#%E3%83%81%E3%83%A3%E3%83%8D%E3%83%AB%E3%81%AB%E5%AF%BE%E3%81%99%E3%82%8B-range">チャネルに対する range</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
<ul>
<li>チップ: Apple M2 Pro</li>
<li>OS: macOS Sonoma</li>
<li>go version: go1.23.2 darwin/arm64</li>
</ul>
<h2 id="rangeレンジ">Range（レンジ）</h2>
Go の range は、配列やスライス、マップ、文字列、チャネルなどのデータ構造をループ処理するために使われるキーワードです。特定のコレクションに対して要素を繰り返し処理するのに非常に便利です。
<ul>
<li>[official] <a href="https://go.dev/tour/moretypes/16" rel="noopener noreferrer" target="_blank">Go Ranges</a></li>
<li>[article] <a href="https://gobyexample.com/range" rel="noopener noreferrer" target="_blank">Go by Example: Range</a></li>
<li>[article] <a href="https://yourbasic.org/golang/for-loop-range-array-slice-map-channel/" rel="noopener noreferrer" target="_blank">Go ranges basic patterns</a></li>
</ul>
<h2 id="配列やスライスに対する-range">配列やスライスに対する range</h2>
range を配列やスライスに使用すると、インデックスとそのインデックスにある要素の 2 つの値が返されます。
<pre><code class="hljs language-go">numbers := []int{1, 2, 3, 4, 5}
for i, v := range numbers {
 fmt.Printf("インデックス: %d, 値: %d\n", i, v)
}
</code></pre>
<ul>
<li>i は現在のインデックスを表します。</li>
<li>v はそのインデックスにある値です。</li>
</ul>
実行結果:
<pre><code class="hljs language-shell">インデックス: 0, 値: 1
インデックス: 1, 値: 2
インデックス: 2, 値: 3
インデックス: 3, 値: 4
インデックス: 4, 値: 5
</code></pre>
もしインデックスが不要で値だけを扱いたい場合は、次のようにインデックスを無視することができます。
<pre><code class="hljs language-go">numbers := []int{1, 2, 3, 4, 5}
for _, v := range numbers {
 fmt.Printf("値: %d\n", v)
}

// 出力:
// 値: 1
// 値: 2
// 値: 3
// 値: 4
// 値: 5
</code></pre>
インデックスのみ使用することも可能です。
<pre><code class="hljs language-go">numbers := []int{1, 2, 3, 4, 5}
for i := range numbers {
 fmt.Printf("インデックス: %d\n", i)
}

// 出力:
// インデックス: 0
// インデックス: 1
// インデックス: 2
// インデックス: 3
// インデックス: 4
</code></pre>
<h3 id="注意点">注意点</h3>
range によってスライスや配列の要素が値として渡されるため、ループ内で値を変更しても元のスライスや配列には影響しません。これは、要素がコピーされてループ内で処理されるためです。元のスライスの要素を変更するには、インデックスを使ってアクセスする必要があります。
<pre><code class="hljs language-go">numbers := []int{1, 2, 3, 4, 5}
for _, v := range numbers {
 v += 10 // この操作は元のスライスに影響を与えません
}
fmt.Println(numbers) // 出力: [1 2 3 4 5]

for i := range numbers {
 numbers[i] += 10 // 直接スライスの要素を変更
}
fmt.Println(numbers) // 出力: [11 12 13 14 15]
</code></pre>
<h2 id="マップに対する-range">マップに対する range</h2>
マップに range を使用すると、キーと値のペアが返されます。
<pre><code class="hljs language-go">ages := map[string]int{"Alice": 25, "Bob": 30}
for k, v := range ages {
 fmt.Printf("キー: %s, 値: %d\n", k, v)
}
</code></pre>
<ul>
<li>k はマップのキーを表します。</li>
<li>v はそのキーに対応する値です。</li>
</ul>
実行結果:
<pre><code class="hljs language-shell">キー: Alice, 値: 25
キー: Bob, 値: 30
</code></pre>
配列同様、キーのみを使用することも可能です。
<pre><code class="hljs language-go">ages := map[string]int{"Alice": 25, "Bob": 30}
for k := range ages {
 fmt.Printf("キー: %s\n", k)
}
// 出力:
// キー: Alice
// キー: Bob
</code></pre>
ただし、Go のマップはキーの順序が保証されないため、ループの順序は毎回異なる場合があります。
<h2 id="文字列に対する-range">文字列に対する range</h2>
文字列に対して range を使用すると、インデックス（バイト位置）と Unicode コードポイント（ルーン）が返されます。Go の文字列は UTF-8 でエンコードされており、1 文字が複数バイトで構成される場合があります。
<pre><code class="hljs language-go">// ASCII文字（1バイト）の場合
word1 := "Hello"
for i, r := range word1 {
 fmt.Printf("バイト位置: %d, ルーン: %c, バイト数: %d\n", i, r, utf8.RuneLen(r))
}

// 日本語（3バイト）の場合
word2 := "こんにちは"
for i, r := range word2 {
 fmt.Printf("バイト位置: %d, ルーン: %c, バイト数: %d\n", i, r, utf8.RuneLen(r))
}
</code></pre>
<ul>
<li>i は文字の開始バイト位置を表します（UTF-8エンコーディングのため、1文字ごとに1ずつ増えるわけではありません）</li>
<li>r は Unicode コードポイントとしての文字です</li>
</ul>
実行結果:
<pre><code class="hljs language-shell">バイト位置: 0, ルーン: H, バイト数: 1
バイト位置: 1, ルーン: e, バイト数: 1
バイト位置: 2, ルーン: l, バイト数: 1
バイト位置: 3, ルーン: l, バイト数: 1
バイト位置: 4, ルーン: o, バイト数: 1

バイト位置: 0, ルーン: こ, バイト数: 3
バイト位置: 3, ルーン: ん, バイト数: 3
バイト位置: 6, ルーン: に, バイト数: 3
バイト位置: 9, ルーン: ち, バイト数: 3
バイト位置: 12, ルーン: は, バイト数: 3
</code></pre>
この例から分かるように、ASCII 文字は 1 バイトで表現されるため、インデックスは 1 ずつ増加します。一方で日本語などの Unicode 文字は 3 バイトで表現されるため、インデックスは 3 ずつ増加します。
また、絵文字などの一部のUnicode文字は 4 バイト使用する場合もあります。
<h3 id="注意点-1">注意点</h3>
<ul>
<li>バイト数を取得するには utf8.RuneLen() を使用する（要 import "unicode/utf8"）</li>
<li>文字列の長さを文字数として取得するには len(string) ではなく utf8.RuneCountInString() を使用する</li>
</ul>
<h2 id="チャネルに対する-range">チャネルに対する range</h2>
チャネルに対して range を使うと、チャネルから送信される値を反復処理できます。チャネルが閉じられるまで値を受信し続けます。
<pre><code class="hljs language-go">ch := make(chan int, 2)
ch &#x3C;- 1
ch &#x3C;- 2
close(ch)

for v := range ch {
 fmt.Println(v)
}
</code></pre>
この例では、チャネルが閉じられると range ループは自動的に終了します。
実行結果:
<pre><code class="hljs language-shell">1
2
</code></pre>
もしチャネルが閉じられない場合、range ループは無限に待機し続けるため、チャネルを閉じることが重要です。
<h2 id="まとめ">まとめ</h2>
<ul>
<li>range は、配列やスライス、マップ、文字列、チャネルに対してループ処理を行うためのキーワード。</li>
<li>配列やスライスに対する range は、インデックスと要素の値を返す。インデックスや値を無視することもできる。
<ul>
<li>値はコピーされるため、ループ内での変更は元のデータに影響しない</li>
<li>元のデータを変更するにはインデックスを使用する必要がある</li>
</ul>
</li>
<li>マップに対する range は、キーと値のペアを返すが、マップ内の順序は保証されない。</li>
<li>文字列に対する range は、バイト位置と Unicode コードポイントを返す。UTF-8 文字列の特性上、1文字が複数バイトに対応する場合がある。
<ul>
<li>バイト位置（インデックス）とUnicodeコードポイント（ルーン）を取得</li>
<li>ASCII文字は1バイト、日本語などは3バイト、絵文字は4バイトで表現</li>
<li>正確な文字数を取得するにはutf8.RuneCountInString()を使用</li>
</ul>
</li>
<li>チャネルに対する range は、チャネルから送信された値を反復処理し、チャネルが閉じられると自動的にループが終了する。
<ul>
<li>チャネルから送信される値を連続して受信</li>
<li>チャネルが閉じられるまでループが継続</li>
<li>チャネルを適切に閉じることが重要</li>
</ul>
</li>
</ul>
<hr>
<hr>
[Next] <a href="/posts/280">Step 1-12: Errors/Panic/Recover</a>
[Prev] <a href="/posts/278">Step 1-10: for 文（For Loop）</a>

<a href="https://roadmap.sh/" rel="noopener noreferrer" target="_blank">roadmap.sh</a> > <a href="https://roadmap.sh/golang" rel="noopener noreferrer" target="_blank">Go</a> > Learn the Basics > Range の学習を進めていきます。
<div class="img_wrap"><img src="/images/posts/279/01.png" width="1576" height="1146" alt="学習箇所"></div>
※ 学習メモとしての記録ですが、後にこのセクションを学ぶ道しるべとなるよう、ですます調で記載しています。
<h2 id="contents">contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#range%E3%83%AC%E3%83%B3%E3%82%B8">Range（レンジ）</a></li>
<li><a href="#%E9%85%8D%E5%88%97%E3%82%84%E3%82%B9%E3%83%A9%E3%82%A4%E3%82%B9%E3%81%AB%E5%AF%BE%E3%81%99%E3%82%8B-range">配列やスライスに対する range</a>
<ol>
<li><a href="#%E6%B3%A8%E6%84%8F%E7%82%B9">注意点</a></li>
</ol>
</li>
<li><a href="#%E3%83%9E%E3%83%83%E3%83%97%E3%81%AB%E5%AF%BE%E3%81%99%E3%82%8B-range">マップに対する range</a></li>
<li><a href="#%E6%96%87%E5%AD%97%E5%88%97%E3%81%AB%E5%AF%BE%E3%81%99%E3%82%8B-range">文字列に対する range</a>
<ol>
<li><a href="#%E6%B3%A8%E6%84%8F%E7%82%B9-1">注意点</a></li>
</ol>
</li>
<li><a href="#%E3%83%81%E3%83%A3%E3%83%8D%E3%83%AB%E3%81%AB%E5%AF%BE%E3%81%99%E3%82%8B-range">チャネルに対する range</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
<ul>
<li>チップ: Apple M2 Pro</li>
<li>OS: macOS Sonoma</li>
<li>go version: go1.23.2 darwin/arm64</li>
</ul>
<h2 id="rangeレンジ">Range（レンジ）</h2>
Go の range は、配列やスライス、マップ、文字列、チャネルなどのデータ構造をループ処理するために使われるキーワードです。特定のコレクションに対して要素を繰り返し処理するのに非常に便利です。
<ul>
<li>[official] <a href="https://go.dev/tour/moretypes/16" rel="noopener noreferrer" target="_blank">Go Ranges</a></li>
<li>[article] <a href="https://gobyexample.com/range" rel="noopener noreferrer" target="_blank">Go by Example: Range</a></li>
<li>[article] <a href="https://yourbasic.org/golang/for-loop-range-array-slice-map-channel/" rel="noopener noreferrer" target="_blank">Go ranges basic patterns</a></li>
</ul>
<h2 id="配列やスライスに対する-range">配列やスライスに対する range</h2>
range を配列やスライスに使用すると、インデックスとそのインデックスにある要素の 2 つの値が返されます。
<pre><code class="hljs language-go">numbers := []int{1, 2, 3, 4, 5}
for i, v := range numbers {
 fmt.Printf("インデックス: %d, 値: %d\n", i, v)
}
</code></pre>
<ul>
<li>i は現在のインデックスを表します。</li>
<li>v はそのインデックスにある値です。</li>
</ul>
実行結果:
<pre><code class="hljs language-shell">インデックス: 0, 値: 1
インデックス: 1, 値: 2
インデックス: 2, 値: 3
インデックス: 3, 値: 4
インデックス: 4, 値: 5
</code></pre>
もしインデックスが不要で値だけを扱いたい場合は、次のようにインデックスを無視することができます。
<pre><code class="hljs language-go">numbers := []int{1, 2, 3, 4, 5}
for _, v := range numbers {
 fmt.Printf("値: %d\n", v)
}

// 出力:
// 値: 1
// 値: 2
// 値: 3
// 値: 4
// 値: 5
</code></pre>
インデックスのみ使用することも可能です。
<pre><code class="hljs language-go">numbers := []int{1, 2, 3, 4, 5}
for i := range numbers {
 fmt.Printf("インデックス: %d\n", i)
}

// 出力:
// インデックス: 0
// インデックス: 1
// インデックス: 2
// インデックス: 3
// インデックス: 4
</code></pre>
<h3 id="注意点">注意点</h3>
range によってスライスや配列の要素が値として渡されるため、ループ内で値を変更しても元のスライスや配列には影響しません。これは、要素がコピーされてループ内で処理されるためです。元のスライスの要素を変更するには、インデックスを使ってアクセスする必要があります。
<pre><code class="hljs language-go">numbers := []int{1, 2, 3, 4, 5}
for _, v := range numbers {
 v += 10 // この操作は元のスライスに影響を与えません
}
fmt.Println(numbers) // 出力: [1 2 3 4 5]

for i := range numbers {
 numbers[i] += 10 // 直接スライスの要素を変更
}
fmt.Println(numbers) // 出力: [11 12 13 14 15]
</code></pre>
<h2 id="マップに対する-range">マップに対する range</h2>
マップに range を使用すると、キーと値のペアが返されます。
<pre><code class="hljs language-go">ages := map[string]int{"Alice": 25, "Bob": 30}
for k, v := range ages {
 fmt.Printf("キー: %s, 値: %d\n", k, v)
}
</code></pre>
<ul>
<li>k はマップのキーを表します。</li>
<li>v はそのキーに対応する値です。</li>
</ul>
実行結果:
<pre><code class="hljs language-shell">キー: Alice, 値: 25
キー: Bob, 値: 30
</code></pre>
配列同様、キーのみを使用することも可能です。
<pre><code class="hljs language-go">ages := map[string]int{"Alice": 25, "Bob": 30}
for k := range ages {
 fmt.Printf("キー: %s\n", k)
}
// 出力:
// キー: Alice
// キー: Bob
</code></pre>
ただし、Go のマップはキーの順序が保証されないため、ループの順序は毎回異なる場合があります。
<h2 id="文字列に対する-range">文字列に対する range</h2>
文字列に対して range を使用すると、インデックス（バイト位置）と Unicode コードポイント（ルーン）が返されます。Go の文字列は UTF-8 でエンコードされており、1 文字が複数バイトで構成される場合があります。
<pre><code class="hljs language-go">// ASCII文字（1バイト）の場合
word1 := "Hello"
for i, r := range word1 {
 fmt.Printf("バイト位置: %d, ルーン: %c, バイト数: %d\n", i, r, utf8.RuneLen(r))
}

// 日本語（3バイト）の場合
word2 := "こんにちは"
for i, r := range word2 {
 fmt.Printf("バイト位置: %d, ルーン: %c, バイト数: %d\n", i, r, utf8.RuneLen(r))
}
</code></pre>
<ul>
<li>i は文字の開始バイト位置を表します（UTF-8エンコーディングのため、1文字ごとに1ずつ増えるわけではありません）</li>
<li>r は Unicode コードポイントとしての文字です</li>
</ul>
実行結果:
<pre><code class="hljs language-shell">バイト位置: 0, ルーン: H, バイト数: 1
バイト位置: 1, ルーン: e, バイト数: 1
バイト位置: 2, ルーン: l, バイト数: 1
バイト位置: 3, ルーン: l, バイト数: 1
バイト位置: 4, ルーン: o, バイト数: 1

バイト位置: 0, ルーン: こ, バイト数: 3
バイト位置: 3, ルーン: ん, バイト数: 3
バイト位置: 6, ルーン: に, バイト数: 3
バイト位置: 9, ルーン: ち, バイト数: 3
バイト位置: 12, ルーン: は, バイト数: 3
</code></pre>
この例から分かるように、ASCII 文字は 1 バイトで表現されるため、インデックスは 1 ずつ増加します。一方で日本語などの Unicode 文字は 3 バイトで表現されるため、インデックスは 3 ずつ増加します。
また、絵文字などの一部のUnicode文字は 4 バイト使用する場合もあります。
<h3 id="注意点-1">注意点</h3>
<ul>
<li>バイト数を取得するには utf8.RuneLen() を使用する（要 import "unicode/utf8"）</li>
<li>文字列の長さを文字数として取得するには len(string) ではなく utf8.RuneCountInString() を使用する</li>
</ul>
<h2 id="チャネルに対する-range">チャネルに対する range</h2>
チャネルに対して range を使うと、チャネルから送信される値を反復処理できます。チャネルが閉じられるまで値を受信し続けます。
<pre><code class="hljs language-go">ch := make(chan int, 2)
ch &#x3C;- 1
ch &#x3C;- 2
close(ch)

for v := range ch {
 fmt.Println(v)
}
</code></pre>
この例では、チャネルが閉じられると range ループは自動的に終了します。
実行結果:
<pre><code class="hljs language-shell">1
2
</code></pre>
もしチャネルが閉じられない場合、range ループは無限に待機し続けるため、チャネルを閉じることが重要です。
<h2 id="まとめ">まとめ</h2>
<ul>
<li>range は、配列やスライス、マップ、文字列、チャネルに対してループ処理を行うためのキーワード。</li>
<li>配列やスライスに対する range は、インデックスと要素の値を返す。インデックスや値を無視することもできる。
<ul>
<li>値はコピーされるため、ループ内での変更は元のデータに影響しない</li>
<li>元のデータを変更するにはインデックスを使用する必要がある</li>
</ul>
</li>
<li>マップに対する range は、キーと値のペアを返すが、マップ内の順序は保証されない。</li>
<li>文字列に対する range は、バイト位置と Unicode コードポイントを返す。UTF-8 文字列の特性上、1文字が複数バイトに対応する場合がある。
<ul>
<li>バイト位置（インデックス）とUnicodeコードポイント（ルーン）を取得</li>
<li>ASCII文字は1バイト、日本語などは3バイト、絵文字は4バイトで表現</li>
<li>正確な文字数を取得するにはutf8.RuneCountInString()を使用</li>
</ul>
</li>
<li>チャネルに対する range は、チャネルから送信された値を反復処理し、チャネルが閉じられると自動的にループが終了する。
<ul>
<li>チャネルから送信される値を連続して受信</li>
<li>チャネルが閉じられるまでループが継続</li>
<li>チャネルを適切に閉じることが重要</li>
</ul>
</li>
</ul>
<hr>
<hr>
[Next] <a href="/posts/280">Step 1-12: Errors/Panic/Recover</a>
[Prev] <a href="/posts/278">Step 1-10: for 文（For Loop）</a>

Author