プログラミング

Goでのファイルコピー方法

最終更新： 26/03/2025
1 分の読み

Go言語（Golang）を使用してファイルをコピーする方法は、シンプルでありながら非常に効率的です。ファイル操作は多くのアプリケーションにおいて基本的なタスクの一つであり、Goではこれをさまざまな方法で実行できます。この記事では、Goでファイルをコピーする3つの方法について、コード例とともに詳しく説明します。

1. io.Copy を使用したファイルのコピー

Goの標準ライブラリには、io.Copyという関数があり、これを使用してファイルを簡単にコピーすることができます。この方法は最も直感的でシンプルです。

関連記事

使い方:

io.Copyは、入力ストリームから出力ストリームへデータをコピーするために使用されます。ファイルのコピーにおいては、os.Openでファイルを開き、os.Createで新しいファイルを作成して、io.Copyを使ってデータを転送します。

サンプルコード:

go
package main

import (
	"fmt"
	"io"
	"os"
)

func copyFile(src, dst string) error {
	// ソースファイルを開く
	sourceFile, err := os.Open(src)
	if err != nil {
		return fmt.Errorf("ソースファイルを開けません: %v", err)
	}
	defer sourceFile.Close()

	// デスティネーションファイルを作成
	destFile, err := os.Create(dst)
	if err != nil {
		return fmt.Errorf("デスティネーションファイルを作成できません: %v", err)
	}
	defer destFile.Close()

	// io.Copyを使ってファイルをコピー
	_, err = io.Copy(destFile, sourceFile)
	if err != nil {
		return fmt.Errorf("ファイルコピーに失敗しました: %v", err)
	}

	return nil
}

func main() {
	err := copyFile("source.txt", "destination.txt")
	if err != nil {
		fmt.Println("エラー:", err)
	} else {
		fmt.Println("ファイルが正常にコピーされました")
	}
}

解説:

  • os.Openでソースファイルを開き、os.Createでデスティネーションファイルを作成します。

  • io.Copy関数は、ソースファイルからデスティネーションファイルへデータをコピーします。

  • コピーが完了したら、エラーハンドリングをして終了します。

2. os パッケージの os.Rename を使用したファイルのコピー

os.Renameは、ファイルを移動するために使用されますが、コピーとしても使用できます。ソースとデスティネーションが同一のファイルシステム内にある場合に、ファイルを一度移動し、その後ソースファイルを新しい場所にコピーする方法です。

サンプルコード:

go
package main

import (
	"fmt"
	"os"
)

func copyFileWithRename(src, dst string) error {
	// ファイルをリネーム（コピー）する
	err := os.Rename(src, dst)
	if err != nil {
		return fmt.Errorf("ファイルの移動に失敗しました: %v", err)
	}
	return nil
}

func main() {
	err := copyFileWithRename("source.txt", "destination.txt")
	if err != nil {
		fmt.Println("エラー:", err)
	} else {
		fmt.Println("ファイルが正常にコピーされました")
	}
}

解説:

  • os.Renameは、指定されたソースファイルをデスティネーションに移動する関数です。コピーとして使用するためには、移動先が存在していなければなりません。

  • os.Renameを使うことで、非常に効率的にファイルを移動またはコピーできますが、異なるファイルシステム間では使用できません。

3. bufio パッケージを使用した大きなファイルのコピー

大きなファイルをコピーする場合、メモリ効率を考慮する必要があります。bufioパッケージを使うと、バッファリングを行い、メモリ使用量を最小限に抑えることができます。io.Copyを使った方法よりもさらに詳細に制御することができます。

サンプルコード:

go
package main

import (
	"bufio"
	"fmt"
	"os"
)

func copyFileWithBuffer(src, dst string) error {
	// ソースファイルを開く
	sourceFile, err := os.Open(src)
	if err != nil {
		return fmt.Errorf("ソースファイルを開けません: %v", err)
	}
	defer sourceFile.Close()

	// デスティネーションファイルを作成
	destFile, err := os.Create(dst)
	if err != nil {
		return fmt.Errorf("デスティネーションファイルを作成できません: %v", err)
	}
	defer destFile.Close()

	// バッファを使ってデータを読み書き
	sourceReader := bufio.NewReader(sourceFile)
	destWriter := bufio.NewWriter(destFile)

	_, err = io.Copy(destWriter, sourceReader)
	if err != nil {
		return fmt.Errorf("ファイルコピーに失敗しました: %v", err)
	}

	// バッファの内容をファイルに書き込む
	err = destWriter.Flush()
	if err != nil {
		return fmt.Errorf("バッファのフラッシュに失敗しました: %v", err)
	}

	return nil
}

func main() {
	err := copyFileWithBuffer("source.txt", "destination.txt")
	if err != nil {
		fmt.Println("エラー:", err)
	} else {
		fmt.Println("ファイルが正常にコピーされました")
	}
}

解説:

  • bufio.NewReaderとbufio.NewWriterを使って、ファイルの読み書きをバッファリングします。

  • 大きなファイルを扱う場合、この方法が有効です。バッファリングにより、メモリ効率が良くなり、パフォーマンスが向上します。

結論

Go言語には、ファイルコピーを行うためのいくつかの方法があります。io.Copyを使う方法はシンプルで最もよく使われますが、大きなファイルをコピーする際には、bufioパッケージを使ってメモリ効率を高めることが重要です。また、ファイルを移動するためのos.Renameも便利ですが、ファイルシステムが異なる場合には利用できないため、適切な方法を選択することが大切です。

これらの方法を使いこなすことで、Goでのファイル操作が非常に効率的に行えるようになります。

最終更新： 26/03/2025
1 分の読み
Back to top button