polidog lab

Rust入門：基本的な概念と機能の解説

Rust プログラミング

Rust入門：基本的な概念と機能の解説

Rustは安全性、パフォーマンス、並行性に優れたシステムプログラミング言語です。この記事では、Rustの重要な基本概念について説明します。初心者の方からRustに興味を持った方まで、参考になれば幸いです。

目次

  1. Cargoの--featuresオプション
  2. 構造体とアクセス修飾子
  3. implブロックによるメソッド実装
  4. Result型とunwrap
  5. エラーハンドリングの改善
  6. アトリビュートと条件付きコンパイル
  7. モジュールシステムとインポート

Cargoの--featuresオプション

基本概念

Cargoの--featuresオプションは、Rustのパッケージ（クレート）で定義された条件付き機能を有効にするための仕組みです。フィーチャーとは、クレートの「オプショナルな機能」を表します。これにより、ユーザーは必要な機能だけを選択的に有効化できるため、不要な依存関係をインクルードせずに済み、コンパイル時間の短縮やバイナリサイズの削減が可能になります。

使用方法

1

cargo build --features "feature1 feature2"

または複数のフィーチャーをカンマ区切りで指定することもできます：

1

cargo build --features feature1,feature2

Cargo.tomlでの定義方法

クレート作者はCargo.tomlファイルでフィーチャーを以下のように定義します：

1
2
3
4
5
6
7
8

[features]
# デフォルトで有効になるフィーチャー
default = ["feature1"]

# 個別のフィーチャー定義
feature1 = []
feature2 = ["dep1"]
feature3 = ["dep1/feature1", "dep2"]

fullフィーチャー

多くのRustクレートでは、fullという名前のフィーチャーが「すべての機能を有効にする」ためのショートカットとして提供されています。

1
2
3
4
5
6

[features]
json = []
yaml = ["dep-yaml"]
async = ["tokio"]
compression = ["flate2"]
full = ["json", "yaml", "async", "compression"]  # すべてを含む

使用例：

1

cargo build --features full

デフォルトの動作

--featuresを指定しない場合、Cargo.tomlファイルの[features]セクションでdefaultとして指定された機能だけが有効になります。デフォルト機能も含めて何も有効にしたくない場合は、--no-default-featuresフラグを使用できます。

構造体とアクセス修飾子

Rustには構造体（struct）という機能があり、関連するデータをグループ化するために使用されます。

基本的な構造体の定義

1
2
3
4

struct Person {
    name: String,
    age: u32,
}

Rustのアクセス修飾子（可視性）

Rustには伝統的なpublic/private/protectedという名前のアクセス修飾子はありませんが、代わりに以下の可視性制御機能があります：

  1. pub - 公開（public）。他のモジュールからアクセス可能
  2. デフォルト - 非公開（private）。同じモジュール内からのみアクセス可能

例：

1
2
3
4

pub struct User {
    pub username: String,  // 公開フィールド
    password: String,      // 非公開フィールド（同じモジュール内のみ）
}

詳細な可視性制御

より細かい制御のために、Rustには以下の可視性修飾子もあります：

  • pub(crate) - クレート内でのみ公開
  • pub(super) - 親モジュールにのみ公開
  • pub(in path) - 指定したパスにのみ公開
1
2
3
4
5

pub struct Config {
    pub name: String,             // どこからでもアクセス可能
    pub(crate) api_key: String,   // 同じクレート内からのみアクセス可能
    internal_id: u64,             // 同じモジュール内からのみアクセス可能
}

implブロック

Rustでは構造体にメソッドを追加するためにimplキーワード（implementation「実装」の略）を使用します。

基本的なimplの使い方

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

struct Rectangle {
    width: u32,
    height: u32,
}

// Rectangleにメソッドを実装
impl Rectangle {
    // インスタンスメソッド（&selfを受け取る）
    fn area(&self) -> u32 {
        self.width * self.height
    }
    
    // 関連関数（selfを受け取らない）- 静的メソッドのようなもの
    fn new(width: u32, height: u32) -> Self {
        Rectangle { width, height }
    }
}

fn main() {
    // 関連関数の呼び出し
    let rect = Rectangle::new(10, 5);
    
    // インスタンスメソッドの呼び出し
    println!("面積: {}", rect.area());
}

implブロックの特徴

  1. 複数のimplブロック: 同じ構造体に対して複数のimplブロックを定義できます。

  2. ジェネリック構造体への実装:

     1
 2
 3
 4
 5
 6
 7
 8
 9
10

    struct Point<T> {
    x: T,
    y: T,
}

impl<T> Point<T> {
    fn get_x(&self) -> &T {
        &self.x
    }
}

  3. トレイトの実装にも使用:

    1
2
3
4
5

    impl Display for Rectangle {
    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
        write!(f, "Rectangle({}x{})", self.width, self.height)
    }
}

Result型とunwrap

Result型の基本

Result<T, E>はRustのエラー処理のための標準的な列挙型で、次のように定義されています：

1
2
3
4

enum Result<T, E> {
    Ok(T),    // 成功した値を保持
    Err(E),   // エラー値を保持
}

この型は、失敗する可能性のある操作の結果を表現するために使用されます。例えば、ファイル操作やネットワーク通信などです。

unwrapメソッドの説明

unwrapはResult型に対して以下の動作を行うメソッドです：

1
2
3
4
5
6

fn main() {
    let file_result = std::fs::File::open("config.txt");
    
    // unwrapの使用例
    let file = file_result.unwrap(); // ファイルが存在しない場合はパニック
}

動作メカニズム

  • ResultがOk(value)の場合：内部の値valueを取り出して返します
  • ResultがErr(e)の場合：プログラムがパニックを起こし、実行を中断します

unwrapの危険性

unwrapは便利ですが、以下の理由から本番コードでは注意が必要です：

  1. エラーが発生するとプログラムが強制終了する
  2. カスタムエラーメッセージがなく、デバッグが難しい場合がある
  3. エラー処理の機会を逃してしまう

エラーハンドリングの改善

unwrap()を避けるためのより良い方法を紹介します。以下はAxumベースのウェブサーバーの例です：

1. ?演算子を使用する

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // loggingの初期化
    let log_level = env::var("RUST_LOG").unwrap_or("info".to_string());
    env::set_var("RUST_LOG", log_level);
    tracing_subscriber::fmt::init();

    // ルーティングの定義
    let app = Router::new()
        .route("/", get(root))
        .route("/users", post(create_user));
    
    // Listenポートの指定 - unwrapの代わりに?を使用
    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await?;

    tracing::debug!("listening on 3000");

    // ここも?を使用
    axum::serve(listener, app).await?;
    
    Ok(())
}

2. より詳細なエラーハンドリング

エラーの理由に基づいて異なる処理を行う場合：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

#[tokio::main]
async fn main() {
    // loggingの初期化
    let log_level = env::var("RUST_LOG").unwrap_or("info".to_string());
    env::set_var("RUST_LOG", log_level);
    tracing_subscriber::fmt::init();

    // ルーティングの定義
    let app = Router::new()
        .route("/", get(root))
        .route("/users", post(create_user));
    
    // エラーを明示的に処理
    let listener = match tokio::net::TcpListener::bind("0.0.0.0:3000").await {
        Ok(listener) => {
            tracing::info!("サーバーを3000番ポートで起動しました");
            listener
        },
        Err(e) => {
            tracing::error!("サーバーの起動に失敗しました: {}", e);
            // 別のポートを試す、設定から読み込む、または終了する
            std::process::exit(1);
        }
    };

    if let Err(e) = axum::serve(listener, app).await {
        tracing::error!("サーバーの実行中にエラーが発生しました: {}", e);
    }
}

3. expect()の使用

少なくともunwrap()よりは情報量の多いパニックメッセージを提供できます：

1
2

let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await
    .expect("3000番ポートでリッスンできませんでした。ポートが既に使用されているか権限がありません");

その他の便利なメソッド

  • unwrap_or(default): エラーの場合にデフォルト値を返す
  • unwrap_or_else(|err| ...): エラーの場合にクロージャを実行
  • map_err(|err| ...): エラー型を変換

アトリビュートと条件付きコンパイル

アトリビュート

Rustの #[] はアトリビュート（attribute）と呼ばれています。アトリビュートはRustのコードに付加的な情報やメタデータを提供するための機能で、コンパイラへの指示やコード生成のヒントを与えるために使用されます。

代表的なアトリビュートの例：

  • #[derive(Debug, Clone)] - 自動的にトレイト実装を生成
  • #[cfg(test)] - 条件付きコンパイル（testビルド時のみコンパイル）
  • #[allow(dead_code)] - 特定の警告を抑制
  • #[tokio::main] - 非同期ランタイムのエントリーポイントを定義

cfgアトリビュート

#[cfg]アトリビュートは「Configuration（設定）」の略で、条件付きコンパイルを実現するための機能です。特定の条件が満たされた場合にのみ、コードの一部をコンパイルすることができます。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

// Linuxプラットフォームでのみコンパイルされる
#[cfg(target_os = "linux")]
fn linux_only() {
    println!("This function is only compiled on Linux");
}

// テストコード
#[cfg(test)]
mod tests {
    use super::*;
    
    #[test]
    fn it_works() {
        assert_eq!(2 + 2, 4);
    }
}

複合条件

論理演算子を使用した複雑な条件：

1
2
3
4
5

// LinuxまたはmacOSで、かつ64ビットアーキテクチャの場合
#[cfg(all(any(target_os = "linux", target_os = "macos"), target_pointer_width = "64"))]
fn specific_implementation() {
    // 実装
}

モジュールシステムとインポート

use super::*;の意味

use super::*;は、Rustのモジュールシステムにおける「親モジュールからすべての公開アイテムをインポートする」という命令です。

  • use - 他の場所で定義されたものを現在のスコープに持ち込む
  • super - 親モジュール（現在のモジュールの上位モジュール）を指す
  • :: - パス区切り文字
  • * - ワイルドカード（すべての公開アイテムを意味する）

実際の例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

// lib.rs または main.rs (親モジュール)
pub fn add(a: i32, b: i32) -> i32 {
    a + b
}

pub struct User {
    pub name: String,
    pub age: u32,
}

// サブモジュール
mod tests {
    // 親モジュールの公開アイテムをすべてインポート
    use super::*;
    
    #[test]
    fn test_add() {
        // 親モジュールの`add`関数を直接使用できる
        assert_eq!(add(2, 2), 4);
    }
    
    #[test]
    fn test_user() {
        // 親モジュールの`User`構造体も直接使用できる
        let user = User {
            name: "Alice".to_string(),
            age: 30,
        };
        assert_eq!(user.name, "Alice");
    }
}

Rustのモジュールパス参照キーワード

Rustのモジュールシステムでは、相対パスを指定するために以下のキーワードが使われます：

  • self - 現在のモジュール自身
  • super - 親モジュール（一つ上のレベル）
  • crate - 現在のクレートのルート

推奨されるインポートスタイル

本番コードでは、名前の衝突を避けるため、*によるワイルドカードインポートは控え、必要なアイテムを個別に指定することが推奨されています：

1
2

// より明示的なインポート（一般的に推奨）
use super::{add, User};

まとめ

この記事では、Rustの基本的な概念について解説しました。Rustの特徴的な機能であるフィーチャーフラグ、構造体とその可視性制御、implブロックでのメソッド実装、エラーハンドリングのパターン、アトリビュートによる条件付きコンパイル、そしてモジュールシステムについて学びました。

Rustは最初は学習曲線が急かもしれませんが、これらの概念を理解することで、安全で効率的なコードを書くことができるようになります。さらに深く学ぶためには、The Rust Programming Language（通称「The Book」）を読むことをお勧めします。

カテゴリ

tech
この記事をXで共有
comments powered by Disqus