Go Academy · レッスン

Readerインターフェース

Q: 「Readerインターフェース」で何を学びますか？

Go I/Oの中心です ブラウザで直接実行するハンズオンコードでGo Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Go I/Oの中心です

「Readerインターフェース」はCoddyKit上の無料Go Academyレッスンです。これはレッスン1/4です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これはGo Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Go Academyコースには全4レッスンが含まれています。

Go I/Oの中核

io.Readerは、ファイル、ネットワーク接続、文字列、圧縮ストリームなど、Goにおけるすべての入力を統一するインターフェースです。

io.Readerを受け取るコードは任意のデータソースで動作します。

インターフェースの定義

契約は非常に小さなものです。

Read(p []byte) (n int, err error)

pに最大でlen(p)バイトを格納し、格納したバイト数（n）とエラーを返します。

文字列から読み取る

strings.NewReaderは文字列をio.Readerに変換します。

package main

import (
	"fmt"
	"strings"
)

func main() {
	r := strings.NewReader("Hello")
	buf := make([]byte, 5)
	n, _ := r.Read(buf)
	fmt.Printf("read %d bytes: %s\n", n, buf[:n])
}

nを処理してからerrを確認する規則

1回のReadで、n > 0バイトとエラーの両方が返されることがあります。必ず先にnバイトを処理し、その後でエラーを確認してください。

ループで読み取る

1回のReadで要求したバイト数より少ないバイトしか返されないことがあるため、多くのReaderではループが必要です。

package main

import (
	"fmt"
	"io"
	"strings"
)

func main() {
	r := strings.NewReader("abcdef")
	buf := make([]byte, 2)
	for {
		n, err := r.Read(buf)
		if n > 0 {
			fmt.Printf("%s ", buf[:n])
		}
		if err == io.EOF {
			break
		}
	}
	fmt.Println()
}

io.ReadAll

データのサイズが小さく上限も決まっている場合は、io.ReadAllを使ってすべてのデータをバイトスライスに読み込めます。

package main

import (
	"fmt"
	"io"
	"strings"
)

func main() {
	r := strings.NewReader("read it all")
	data, _ := io.ReadAll(r)
	fmt.Println(string(data))
}

バイトからReaderを作成する

bytes.NewReaderはバイトスライスをラップします。すでにメモリ上にデータがある場合に便利です。

package main

import (
	"bytes"
	"fmt"
	"io"
)

func main() {
	r := bytes.NewReader([]byte{72, 105})
	data, _ := io.ReadAll(r)
	fmt.Println(string(data))
}

Readerを受け取る関数

具体的な型ではなくio.Readerを受け取る関数を作成してください。そうすれば、同じ関数でファイル、ソケット、テスト用の文字列から読み取れます。

package main

import (
	"fmt"
	"io"
	"strings"
)

func countBytes(r io.Reader) int {
	data, _ := io.ReadAll(r)
	return len(data)
}

func main() {
	fmt.Println(countBytes(strings.NewReader("hello")))
}

io.EOFはエラーではない

io.EOFはストリームが終了したことを示す通常のシグナルであり、失敗として扱わないでください。それ以外のエラーだけが実際の問題を示します。

LimitReader

io.LimitReader(r, n)は、nバイト読み取ったところで停止するようにReaderをラップします。読み取る量に上限を設けるのに便利です。

package main

import (
	"fmt"
	"io"
	"strings"
)

func main() {
	r := io.LimitReader(strings.NewReader("abcdefgh"), 3)
	data, _ := io.ReadAll(r)
	fmt.Println(string(data))
}

1つのインターフェースが有効な理由

コードをデータソースから分離できる
文字列やバイトを使って簡単にテストできる
LimitReaderやgzipなどのラッパーと組み合わせられる

理解度チェック

io.Readerについての知識を確認しましょう。

まとめ

入力の中核となるインターフェースを学びました。

Read(p []byte) (int, error)が契約のすべてです
io.EOFまでループし、先にnバイトを処理します
io.ReadAll、strings/bytes.NewReader、LimitReader
APIではio.Readerを受け取るようにします

よくある質問

「Readerインターフェース」レッスンは無料ですか？

はい。「Readerインターフェース」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Go Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Go Academyコースには全4レッスンが含まれています。

「Readerインターフェース」で何を学びますか？

Go I/Oの中心ですブラウザで直接実行するハンズオンコードでGo Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Go Academyを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのGo Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。これはレッスン1/4です。

「Readerインターフェース」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このGo Academyレッスンでコードを書いて実行できますか？

はい。すべてのGo Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

← Go Academyに戻る