save

Author: jcbhmr

content/ja/docs/README.md

@@ -0,0 +1,19 @@
+# サンプルで学ぶ Go 言語
+
+[Go](http://golang.org/) はオープンソースのプログラミング言語であり、シンプルで高速、信頼性の高いソフトウェアを作るために設計された。
+
+サンプルで学ぶ Go 言語は、説明付きのプログラムを使った、ハンズオン形式の Go 言語チュートリアルだ。 [最初の例](hello-world.md)に進んでもよいし、下にある一覧から読みたい例を探してよい。
+
+<br>
+
+<style>
+/* Make draft links from included SUMMARY.md on README.md non-clickable. */
+#content a[href=""] {
+    color: var(--sidebar-non-existant);;
+    text-decoration: none;
+    cursor: default;
+    pointer-events: none;
+}
+</style>
+
+{{#include SUMMARY.md:7:}}

content/ja/docs/SUMMARY.md

@@ -0,0 +1,81 @@
+# Summary
+
+[サンプルで学ぶ Go 言語](README.md)
+
+---
+
+- [Hello World](hello-world.md)
+- [Values](values.md)
+- [Variables](variables.md)
+- [Constants](constants.md)
+- [For](for.md)
+- [If/Else](if-else.md)
+- [Switch](switch.md)
+- [Arrays](arrays.md)
+- [Slices](slices.md)
+- [Maps](maps.md)
+- [Range](range.md)
+- [Functions](functions.md)
+- [Multiple Return Values](multiple-return-values.md)
+- [Variadic Functions](variadic-functions.md)
+- [Closures](closures.md)
+- [Recursion](recursion.md)
+- [Pointers](pointers.md)
+- [Structs](structs.md)
+- [Methods](methods.md)
+- [Interfaces](interfaces.md)
+- [Errors](errors.md)
+- [Goroutines](goroutines.md)
+- [Channels](channels.md)
+- [Channel Buffering](channel-buffering.md)
+- [Channel Synchronization](channel-synchronization.md)
+- [Channel Directions](channel-directions.md)
+- [Select](select.md)
+- [Timeouts](timeouts.md)
+- [Non-Blocking Channel Operations](non-blocking-channel-operations.md)
+- [Closing Channels](closing-channels.md)
+- [Range over Channels](range-over-channels.md)
+- [Timers](timers.md)
+- [Tickers](tickers.md)
+- [Worker Pools](worker-pools.md)
+- [WaitGroups](waitgroups.md)
+- [Rate Limiting](rate-limiting.md)
+- [Atomic Counters](atomic-counters.md)
+- [Mutexes](mutexes.md)
+- [Stateful Goroutines](stateful-goroutines.md)
+- [Sorting](sorting.md)
+- [Sorting by Functions](sorting-by-functions.md)
+- [Panic](panic.md)
+- [Defer](defer.md)
+- [Collection Functions](collection-functions.md)
+- [String Functions](string-functions.md)
+- [String Formatting](string-formatting.md)
+- [Regular Expressions](regular-expressions.md)
+- [JSON](json.md)
+- [XML](xml.md)
+- [Time](time.md)
+- [Epoch](epoch.md)
+- [Time Formatting / Parsing](time-formatting-parsing.md)
+- [Random Numbers](random-numbers.md)
+- [Number Parsing](number-parsing.md)
+- [URL Parsing](url-parsing.md)
+- [SHA1 Hashes](sha1-hashes.md)
+- [Base64 Encoding](base64-encoding.md)
+- [Reading Files](reading-files.md)
+- [Writing Files](writing-files.md)
+- [Line Filters](line-filters.md)
+- [File Paths](file-paths.md)
+- [Directories](directories.md)
+- [Temporary Files and Directories](temporary-files-and-directories.md)
+- [Testing](testing.md)
+- [Command-Line Arguments](command-line-arguments.md)
+- [Command-Line Flags](command-line-flags.md)
+- [Command-Line Subcommands](command-line-subcommands.md)
+- [Environment Variables](environment-variables.md)
+- [HTTP Clients](http-clients.md)
+- [HTTP Servers](http-servers.md)
+- [Context](context.md)
+- [Spawning Processes](spawning-processes.md)
+- [Exec'ing Processes](execing-processes.md)
+- [Signals](signals.md)
+- [Exit](exit.md)

content/ja/docs/multiple-return-values.md

@@ -0,0 +1,34 @@
+# Multiple Return Values
+```go
+// Go は<em>多値の返り値</em>を組み込みでサポートしている。
+// この機能は Go のイディオムで使われることが多く、例えば結果とエラーの両方を関数から返す場合に使う。
+
+package main
+
+import "fmt"
+
+// この関数のシグネチャにおける `(int, int)` は、この関数が2つの `int` 型の値を返すことを表している。
+func vals() (int, int) {
+	return 3, 7
+}
+
+func main() {
+
+	// ここでは2つの返り値を<em>多重代入</em>を使って受け取っている。
+	a, b := vals()
+	fmt.Println(a)
+	fmt.Println(b)
+
+	// もし返り値のうちの一部だけが必要なら、ブランク識別子 `_` を使えばよい。
+	_, c := vals()
+	fmt.Println(c)
+}
+```
+```sh
+$ go run multiple-return-values.go
+3
+7
+7
+
+# Go の関数の素敵な機能として、引数を何個でも受け取れる関数の書き方を次に紹介する。
+```

content/ja/docs/mutexes.md

@@ -0,0 +1,86 @@
+# Mutexes
+```go
+// 前の例で、単純なカウンタの状態を[アトミックな操作](atomic-counters.html)で管理する方法を紹介した。
+// より複雑な状態を管理したいときには、[<em>ミューテックス（mutex）</em>](http://en.wikipedia.org/wiki/Mutual_exclusion)を使って複数のゴルーチンから安全にデータを読み書きすることもできる。
+
+package main
+
+import (
+	"fmt"
+	"math/rand"
+	"sync"
+	"sync/atomic"
+	"time"
+)
+
+func main() {
+
+	// 状態の例としてマップを使う。
+	var state = make(map[int]int)
+
+	// この `mutex` を使って、`state` へのアクセスを同期する。
+	var mutex = &sync.Mutex{}
+
+	// 読み操作・書き操作がそれぞれ何度行われたかをカウントする。
+	var readOps uint64
+	var writeOps uint64
+
+	// 100 個のゴルーチンを作り、それぞれが1ミリ秒ごとに state を繰り返し読み出す。
+	for r := 0; r < 100; r++ {
+		go func() {
+			total := 0
+			for {
+
+				// 読み出しのたびに、アクセスするキーを選ぶ。
+				// `Lock()` で `mutex` をロックし、`state` への排他的なアクセスを獲得し、値を読み出し、`Unlock()` で `mutex` のロックを解除し、最後に `readOps` の値を1増やす。
+				key := rand.Intn(5)
+				mutex.Lock()
+				total += state[key]
+				mutex.Unlock()
+				atomic.AddUint64(&readOps, 1)
+
+				// 読み出しのたびに少し待つ。
+				time.Sleep(time.Millisecond)
+			}
+		}()
+	}
+
+	// 10個のゴルーチンを起動し、読み出しと同様のパターンで書き込みを行う。
+	for w := 0; w < 10; w++ {
+		go func() {
+			for {
+				key := rand.Intn(5)
+				val := rand.Intn(100)
+				mutex.Lock()
+				state[key] = val
+				mutex.Unlock()
+				atomic.AddUint64(&writeOps, 1)
+				time.Sleep(time.Millisecond)
+			}
+		}()
+	}
+
+	// 10個のゴルーチンが `state` や `mutex` で仕事をできるよう、一秒待つ。
+	time.Sleep(time.Second)
+
+	// 結果を読み出して、読み書き操作のカウントを報告する
+	readOpsFinal := atomic.LoadUint64(&readOps)
+	fmt.Println("readOps:", readOpsFinal)
+	writeOpsFinal := atomic.LoadUint64(&writeOps)
+	fmt.Println("writeOps:", writeOpsFinal)
+
+	// `state` をロックして、最終的にどうなったかを表示する。
+	mutex.Lock()
+	fmt.Println("state:", state)
+	mutex.Unlock()
+}
+```
+```sh
+# プログラムを実行した結果、`mutex` で同期した操作を合計で約90000回実行したことがわかる。
+$ go run mutexes.go
+readOps: 83285
+writeOps: 8320
+state: map[1:97 4:53 0:33 2:15 3:2]
+
+# 続いて、同様の状態管理をゴルーチンとチャネルだけを使って実装する方法を紹介する。
+```

content/ja/docs/non-blocking-channel-operations.md

@@ -0,0 +1,53 @@
+# Non-Blocking Channel Operations
+```go
+// 基本的なチャネルの送受信の使い方はブロックする。
+// しかし、`select` と `default` 節を使えば、<em>ノンブロッキング</em>な送受信や、選択的な受信を実装できる。
+
+package main
+
+import "fmt"
+
+func main() {
+	messages := make(chan string)
+	signals := make(chan bool)
+
+	// これはノンブロッキングな受信である。
+	// もし `messages` から値を受け取れるなら、`select` は `<-messages` の `case` 節で、その値を受け取る。
+	// そうでなければ、`default` 節に直ちに進む。
+	select {
+	case msg := <-messages:
+		fmt.Println("received message", msg)
+	default:
+		fmt.Println("no message received")
+	}
+
+	// ノンブロッキングな送信も同様だ。
+	// ここでは `msg` を `messages` チャネルに送信できない。
+	// なぜならチャネルにバッファは付いておらず、受信者もいないからである。
+	// そのため、`default` 節に進む。
+	msg := "hi"
+	select {
+	case messages <- msg:
+		fmt.Println("sent message", msg)
+	default:
+		fmt.Println("no message sent")
+	}
+
+	// `default` 節の前に複数の `case` を書けば、複数のチャネルから選択的かつノンブロッキングに受信できる。
+	// ここでは `messages` と`signals` からノンブロッキング受信を試みている。
+	select {
+	case msg := <-messages:
+		fmt.Println("received message", msg)
+	case sig := <-signals:
+		fmt.Println("received signal", sig)
+	default:
+		fmt.Println("no activity")
+	}
+}
+```
+```sh
+$ go run non-blocking-channel-operations.go 
+no message received
+no message sent
+no activity
+```

content/ja/docs/number-parsing.md

@@ -0,0 +1,52 @@
+# Number Parsing
+```go
+// 文字列から数値へのパースは、多くのプログラムに現れるパターンである。
+// ここでは、Go でのやり方を紹介する。
+
+package main
+
+// `strconv` パッケージを使って数をパースできる。
+import (
+	"fmt"
+	"strconv"
+)
+
+func main() {
+
+	// `ParseFloat` の `64` は何ビットの精度でパースするかを指定する。
+	f, _ := strconv.ParseFloat("1.234", 64)
+	fmt.Println(f)
+
+	// `ParseInt` の `0` は基数を文字列から推測させることを表す。
+	// `64` は、結果が64ビットに収まることを要求する。
+	i, _ := strconv.ParseInt("123", 0, 64)
+	fmt.Println(i)
+
+	// `ParseInt` は8進記数法で書かれた文字列をパースできる。
+	d, _ := strconv.ParseInt("0x1c8", 0, 64)
+	fmt.Println(d)
+
+	// `ParseUint` もある。
+	u, _ := strconv.ParseUint("789", 0, 64)
+	fmt.Println(u)
+
+	// `Atoi` は基数が10の `int` 型の値をパースするときに便利である。
+	k, _ := strconv.Atoi("135")
+	fmt.Println(k)
+
+	// パースする関数は、入力の形式が正しくないとエラーを返す。
+	_, e := strconv.Atoi("wat")
+	fmt.Println(e)
+}
+```
+```sh
+$ go run number-parsing.go 
+1.234
+123
+456
+789
+135
+strconv.ParseInt: parsing "wat": invalid syntax
+
+# パース対象としてこちらも頻出である URL をパースするやり方を紹介する。
+```

content/ja/docs/panic.md

@@ -0,0 +1,39 @@
+# Panic
+```go
+// `panic` は予期せぬ問題が起きたことを示すために使う。
+// これは普通は起きるはずがない問題が起きたり、うまく対処できない問題が起きた場合に、なるべく早くプログラムを停止させるために使う。
+
+package main
+
+import "os"
+
+func main() {
+
+	// このウェブサイトでは、予期せぬエラーが発生した場合に `panic` を使う。
+	// この行だけが、意図的に panic を呼んでいる箇所である。
+	panic("a problem")
+
+	// 関数がエラーを返し、そのエラーにどう対処すべきがわからない（または対処したくない）場合に、panic を呼んでプログラムを中断するのは、panic の典型的な使い方である。
+	// この例では、ファイルを作るときにエラーが発生したら、panic を呼んでいる。
+	_, err := os.Create("/tmp/file")
+	if err != nil {
+		panic(err)
+	}
+}
+```
+```sh
+# プログラムを実行するとパニックが発生し、
+# エラーメッセージとゴルーチンのトレースが表示され、
+# 非ゼロのステータスでプログラムは終了する。
+$ go run panic.go
+panic: a problem
+
+goroutine 1 [running]:
+main.main()
+	/.../panic.go:12 +0x47
+...
+exit status 2
+
+# 例外を使って多くのエラーを処理する言語とは違って、
+# Go ではエラーの有無を返り値として返すのが普通であることに注意する。
+```