String::from() / to_string()

// String型の生成方法です。
let s1 = String::from("hello");         // &str からStringを生成します。
let s2 = "world".to_string();           // to_string() を使う方法です。
let s3 = String::new();                 // 空のStringを生成します。
let s4 = "hello".to_owned();            // to_owned() でもStringを作れます。

// &str（文字列スライス）はString型への参照またはリテラルです。
let literal: &str = "hello";            // 文字列リテラルは&str型です。
let borrowed: &str = &s1;              // StringへのスライスはDeref強制で取れます。
let slice: &str = &s1[0..3];           // 範囲で一部を参照します。

// String と &str の相互変換です。
let s: String = String::from("hello");
let r: &str = &s;                      // &String → &str（Deref強制）
let s2: String = r.to_string();         // &str → String

fn print_str(s: &str) {
    // &str を受け取ります。String も &String から Deref 強制で渡せます。
    println!("文字列: {}", s);
}

fn main() {
    // --- String の生成 ---
    let s1 = String::from("Hello, Rust!");
    let s2 = "Hello, World!".to_string();
    let s3 = String::new();
    let s4 = String::with_capacity(50);  // 50バイト確保します。

    println!("s1: {}", s1);
    println!("s2: {}", s2);
    println!("s3（空）: '{}'", s3);
    println!("s4（空・容量50）: len={}, capacity={}", s4.len(), s4.capacity());

    // --- &str リテラル ---
    let literal: &str = "hello";
    println!("literal: {}", literal);

    // --- String と &str の相互変換 ---
    let owned: String = "Rust".to_string();
    let borrowed: &str = &owned;         // &String → &str（自動変換）
    let owned2: String = borrowed.to_string();  // &str → String

    println!("owned: {}", owned);
    println!("borrowed: {}", borrowed);
    println!("owned2: {}", owned2);

    // --- 関数への渡し方 ---
    // &str を受け取る関数には String も &str も渡せます。
    print_str("文字列リテラル");
    print_str(&s1);          // &String → &str に自動変換されます。

    // --- スライス ---
    let hello = &s1[0..5];  // "Hello"（バイト単位の範囲指定）
    println!("スライス: {}", hello);

    // --- format! でのString生成 ---
    let name = "Alice";
    let age = 30;
    let profile = format!("名前: {}、年齢: {}歳", name, age);
    println!("{}", profile);

    // --- String か &str かを判断する基準 ---
    // 文字列の所有権が必要 → String
    // 文字列を参照するだけ（読み取り専用）→ &str
}

RustのStringは内部的にUTF-8バイト列を持つヒープ割り当てのデータ構造です。一方、『&str』はそのバイト列への参照（スライス）です。関数の引数として文字列を受け取る場合は、より汎用的な『&str』を型として使うのが慣習です（『&String』より『&str』の方が多くの型を受け付けられます）。

日本語などマルチバイト文字を含む文字列のスライスは、文字の境界でないバイト位置を指定するとパニックします。文字単位での操作には.chars()を使ってください。

文字列の結合・追加は『String::push_str() / push() / +』、長さ検索・判定は『String::len() / is_empty() / contains()』を参照してください。