[入門]Go言語でファイル読み書きをやってみよう

はじめに

• 当記事は、Go言語のファイル読み込み、書き出しの方法を記載しております。

注意点

• 読者の知識レベルは、以下の方を想定しております。

  • プログラミングの基礎的な知識がある
    • 変数とは何か、関数とは何か
    • 変数や関数を定義できるか
  • 何か言語を触ったことがある
    • C言語やJava言語、Python言語など

• 上手く実施できなかった場合や、不明な点がある際は、コメントを記載していただければ幸いです。

実行環境

• OS
  • Windows10 Pro 64-bit
• エディタ
  • VisualStudio Code
• 作業ディレクトリ
  • C:\Users\Romeo\Documents\go

ファイル読み込み

事前準備

• 今回は、テキストファイルの読み込みを実施するので、先にファイルを用意しておきましょう。
• "C:\Users\Romeo\Documents\go"配下に、test.txtを作成します。
• 内容は何でも良いですが、私は以下のように作成しました。

test.txt

Hi.
This is a test file.

ソースコード

• FileRead.goを新規作成し、以下の内容を格納します。

FileRead.go

package main

import (
    "fmt"
    "log"
    "os"
)

const BUFSIZE = 1024    //読み込む際のバッファサイズ指定

func main() {
    file, err := os.Open(`C:\Users\Romeo\Documents\test.txt`)   //ファイルオープン
    if err != nil {
        log.Fatal(err)  //ファイルが開けなかったときエラー出力
    }
    defer file.Close()  //全部の処理終了後にファイルクローズ

    buf := make([]byte, BUFSIZE)    //byte型配列に格納
    for {   //繰り返し読み込み
        n, err := file.Read(buf)    //ファイル読み込み
        if n == 0 {
            break   //中身がなくなったらbreak
        }
        if err != nil {
            log.Fatal(err)
            break   //ファイル読み込みに失敗したらbreak
        }

        fmt.Printf(string(buf[:n])) //読み込んだ内容を出力
    }
}

実行結果

C:\Users\Romeo\Documents\go> go run FileRead.go
Hi.
This is a test file.

ソースコード解説

• 基本的には、よくあるファイル読み込みアルゴリズムと同じだと思います。

• 今回インポートしたパッケージは3つです。

  • fmt
    • 標準出力のため
  • log
    • エラー出力のため
  • os
    • ファイルを取り扱うため

• ファイルオープン時には、エラー変数が返ってきます。しっかり受け取り、エラー処理まで記載しましょう。

  • deferにファイルクローズ関数を記載することを忘れずに

一部抜粋

file, err := os.Open(`C:\Users\Romeo\Documents\test.txt`)   //ファイルオープン
    if err != nil {
        log.Fatal(err)  //ファイルが開けなかったときエラー出力
    }
defer file.Close()  //ファイルクローズ

ファイル書き込み

ソースコード

• FileWrite.goを新規作成し、以下の内容を格納します。
• 今回のプログラムでは、test2.txtを新規作成し、そこに"testmessage"を書き込みます。

FileWrite.go

package main

import (
    "os"
)

func main() {
    file, err := os.Create(`C:\Users\Romeo\Documents\test2.txt`)
    if err != nil {
        log.Fatal(err)  //ファイルが開けなかったときエラー出力
    }
    defer file.Close()

    output := "testmessage"
    file.Write(([]byte)(output))
}

実行結果

test2.txt

testmessage

ソースコード解説

• こちらも、よくあるアルゴリズムだと思います。
• outputという変数に、書き込みたい内容を記載しております。

最後に

• 変数定義やエラー出力など、慣れない点も多々ありました。
• ファイル読み書きは初歩中の初歩なので、これをベースに更に勉学に励みます。