Rustのタプルを活用した複数戻り値の書き方とベストプラクティス

Rustは安全性とパフォーマンスを両立したシステムプログラミング言語として、2026年現在も多くの開発現場で採用されています。

効率的なコーディングを行う上で、関数から複数の値を返したい場面は非常に多く存在します。

Rustでは「タプル」を用いることで、複数の異なる型の値を一つの戻り値としてスマートに扱うことが可能です。

本記事では、Rustにおけるタプルを活用した複数戻り値の書き方から、コードの可読性を高めるためのベストプラクティスまでを詳しく解説します。

開発効率を向上させるためのテクニックを、具体的なサンプルコードを交えて学んでいきましょう。

Rustにおけるタプルの基本構造と役割

タプルは、複数の異なる型の値を一つの複合型としてまとめることができるデータ構造です。

Rustのタプルは固定長であり、一度宣言するとそのサイズを変更することはできません。

例えば、(i32, f64, u8) のように、数値型や浮動小数点型を自由に組み合わせて定義できます。

タプル内の各要素には、0から始まるインデックスを使用して tuple.0 や tuple.1 のようにアクセスすることが可能です。

しかし、関数からの戻り値として利用する場合は、インデックスによるアクセスよりも「分配束縛」を利用するのが一般的です。

タプルは、明示的な名前付きフィールドを必要としない、一時的なデータのまとまりを表現するのに最適な選択肢となります。

関数から複数戻り値を返す実装方法

関数から複数の値を返すには、関数の戻り値の型としてタプルを指定します。

以下のコードは、数値のリストから「最大値」と「最小値」を同時に計算して返す例です。

// 数値のスライスを受け取り、(最大値, 最小値)を返す関数
fn find_min_max(numbers: &[i32]) -> (i32, i32) {
    let mut min = numbers[0];
    let mut max = numbers[0];

    for &num in numbers {
        if num < min {
            min = num;
        }
        if num > max {
            max = num;
        }
    }

    // タプルとして複数の値を返す
    (min, max)
}

fn main() {
    let data = vec![10, 5, 8, 20, 3];
    let result = find_min_max(&data);

    println!("最小値: {}, 最大値: {}", result.0, result.1);
}

最小値: 3, 最大値: 20

このように、戻り値の型を (i32, i32) と定義し、関数の最後で (min, max) を返すだけで実装が完了します。

Rustの関数はデフォルトで一つの値しか返せませんが、タプルで包むことにより実質的に複数の情報を伝播できます。

戻り値の受け取り方と分配束縛の活用

タプルで返された値を個別の変数として展開することを、Rustでは「分配束縛(Destructuring)」と呼びます。

分配束縛を利用することで、result.0 のようなマジックナンバーに近いアクセスを避け、コードの意図を明確にできます。

fn main() {
    let data = vec![10, 5, 8, 20, 3];
    
    // 分配束縛を用いて個別の変数に代入
    let (min_val, max_val) = find_min_max(&data);

    println!("最小値は {} です。", min_val);
    println!("最大値は {} です。", max_val);
}

この書き方により、どの変数が何を意味しているのかが一目で理解できるようになります。

もし特定の戻り値が必要ない場合は、アンダースコア _ を使用して値を無視することも可能です。

例えば let (min_val, _) = find_min_max(&data); と記述すれば、最大値のみを破棄して最小値だけを受け取ることができます。

これは関数のシグネチャを変更せずに、必要なデータだけを抽出したい場合に非常に便利です。

タプルを使用する際のメリットとデメリット

タプルによる複数戻り値の実装には、明確な利点と注意点があります。

状況に応じてタプルを使うべきか、あるいは別のデータ構造を検討すべきか判断が必要です。

タプルのメリット

• 記述が簡潔である： 新しく構造体を定義する手間が省け、コードの記述量を抑えられます。
• 型安全性が保たれる： 各要素の型が厳密にチェックされるため、実行時の型エラーを防げます。
• 一時的なデータに最適： 関数内だけで完結する計算結果の受け渡しなどに適しています。

タプルのデメリット

• 意味が伝わりにくい： (i32, i32, String) とだけ書かれていても、それぞれの値が何を指すのか不明確です。
• メンテナンス性の低下： 戻り値の数が増えると、どの順番で値が並んでいるのかを把握するのが困難になります。
• 拡張性の欠如： 後からフィールドを追加したり、メソッドを定義したりすることができません。

一般的に、戻り値が3つを超える場合は、タプルではなく構造体の使用を検討すべきです。

タプルから構造体への移行基準

プロジェクトが大規模化するにつれ、タプルでは情報の整理が追いつかなくなることがあります。

以下の表は、タプルと構造体の使い分けの基準をまとめたものです。

例えば、座標情報を返す関数を考えてみましょう。

(f64, f64) を返すよりも、Point { x: f64, y: f64 } という構造体を返すほうが、後からコードを読む開発者にとって親切です。

特に、「そのデータが何を意味しているか」を名前で説明したい場合は、迷わず構造体を選択してください。

実践的なユースケース：Result型との組み合わせ

Rustの強力なエラーハンドリング機構である Result 型とタプルを組み合わせる手法も一般的です。

成功時に複数の値を返し、失敗時にエラーを返すようなパターンです。

fn divide_and_remainder(dividend: i32, divisor: i32) -> Result<(i32, i32), String> {
    if divisor == 0 {
        return Err(String::from("0で割ることはできません"));
    }
    let quotient = dividend / divisor;
    let remainder = dividend % divisor;
    Ok((quotient, remainder))
}

fn main() {
    match divide_and_remainder(10, 3) {
        Ok((q, r)) => println!("商: {}, 余り: {}", q, r),
        Err(e) => println!("エラー: {}", e),
    }
}

商: 3, 余り: 1

このように Result<(T, U), E> という形式にすることで、エラーチェックと複数値の受け取りを同時に行えます。

このパターンは、Rustにおける標準的なライブラリ設計でも頻繁に見られるベストプラクティスの一つです。

さらに、2026年の最新のRustプラクティスでは、非同期処理 async/await の戻り値としてもタプルが広く利用されています。

タプル活用のベストプラクティス

タプルを効果的に使いこなすために、以下のポイントを意識してください。

第一に、タプルの要素数は最小限に留めることです。

第二に、公開APIの戻り値には極力構造体を使うことを推奨します。

内部的なヘルパー関数であればタプルで十分ですが、ライブラリの利用者に提供するインターフェースでは名前付きのフィールドが求められます。

第三に、型エイリアスを活用することで可読性を補うことができます。

type Coordinates = (f64, f64); のように定義することで、そのタプルが何を表しているのかを示すヒントになります。

最後に、パターンマッチングを積極的に活用することです。

if let や match 文と組み合わせることで、タプルの中身に応じた柔軟な制御フローを構築できます。

まとめ

Rustのタプルを活用した複数戻り値の制御は、簡潔で強力なコーディングを可能にします。

タプルは、データの構造を即座に定義し、複数の値を一つの単位として扱うための最も手軽な手段です。

しかし、その手軽さに甘えて要素を増やしすぎると、コードの可読性やメンテナンス性を損なう原因にもなり得ます。

基本はタプルで素早く実装し、複雑さが増した段階で構造体へリファクタリングするというアプローチが理想的です。

本記事で紹介した分配束縛や Result 型との組み合わせ、構造体への移行基準を参考に、より安全でクリーンなRustコードを目指してください。

適切なデータ構造の選択は、堅牢なシステムを構築するための第一歩となります。