文字列

Java – formatメソッドを使った文字列の置換方法

JavaのString.formatメソッドは、フォーマット指定子を使用して文字列を動的に生成する方法を提供します。

%sは文字列、%dは整数、%fは浮動小数点数など、指定子に対応する値を引数として渡します。

例えば、String.format("Hello, %s!", "World")は"Hello, World!"を返します。

引数の順序や型に注意が必要です。

目次から探す

formatメソッドの基本的な使い方
フォーマット指定子の種類と使用例
formatメソッドの応用例
formatメソッドの注意点
まとめ

formatメソッドの基本的な使い方

JavaのStringクラスには、文字列をフォーマットするためのformatメソッドがあります。

このメソッドを使用することで、変数の値を文字列に埋め込むことができます。

基本的な構文は以下の通りです。

String formattedString = String.format("フォーマット文字列", 引数1, 引数2, ...);

以下のコードは、formatメソッドを使って、名前と年齢を埋め込んだ文字列を作成する例です。

import java.util.Locale; // Localeクラスをインポート
public class App {
    public static void main(String[] args) {
        String name = "太郎"; // 名前
        int age = 25; // 年齢
        // formatメソッドを使用して文字列をフォーマット
        String formattedString = String.format("私の名前は%sで、年齢は%d歳です。", name, age);
        
        // フォーマットされた文字列を出力
        System.out.println(formattedString);
    }
}

私の名前は太郎で、年齢は25歳です。

このように、formatメソッドを使うことで、変数の値を簡単に文字列に埋め込むことができます。

%sは文字列、%dは整数を表すフォーマット指定子です。

これにより、可読性の高いコードを書くことが可能になります。

フォーマット指定子の種類と使用例

formatメソッドでは、さまざまなフォーマット指定子を使用して、異なるデータ型を文字列に埋め込むことができます。

以下に、主なフォーマット指定子とその使用例を示します。

フォーマット指定子	説明	使用例
`%s`	文字列	`String.format("名前: %s", "太郎")`
`%d`	整数	`String.format("年齢: %d", 25)`
`%f`	浮動小数点数	`String.format("価格: %.2f", 123.45)`
`%x`	16進数	`String.format("16進数: %x", 255)`
`%b`	ブール値	`String.format("真偽値: %b", true)`
`%t`	日付と時刻	`String.format("日付: %tF", new Date())`

以下のコードは、さまざまなフォーマット指定子を使用して、異なるデータ型の値を埋め込んだ文字列を作成する例です。

import java.util.Date; // Dateクラスをインポート
public class App {
    public static void main(String[] args) {
        String name = "太郎"; // 名前
        int age = 25; // 年齢
        double price = 123.456; // 価格
        boolean isStudent = true; // 学生かどうか
        Date date = new Date(); // 現在の日付
        // 各フォーマット指定子を使用して文字列をフォーマット
        String formattedString = String.format(
            "名前: %s\n年齢: %d\n価格: %.2f\n学生: %b\n日付: %tF",
            name, age, price, isStudent, date
        );
        
        // フォーマットされた文字列を出力
        System.out.println(formattedString);
    }
}

名前: 太郎
年齢: 25
価格: 123.46
学生: true
日付: 2023-10-01

このように、フォーマット指定子を使うことで、異なるデータ型の値を簡単に文字列に埋め込むことができます。

特に、浮動小数点数のフォーマットでは、小数点以下の桁数を指定することができ、表示形式を柔軟に調整できます。

formatメソッドの応用例

formatメソッドは、単純な文字列の埋め込みだけでなく、さまざまな応用が可能です。

ここでは、複数の変数を使ったフォーマットや、数値の整形、日付のフォーマットなどの応用例を紹介します。

1. 複数の変数を使ったフォーマット

複数の変数を同時に埋め込むことができます。

以下の例では、名前、年齢、趣味を一度に表示します。

public class App {
    public static void main(String[] args) {
        String name = "花子"; // 名前
        int age = 30; // 年齢
        String hobby = "読書"; // 趣味
        // 複数の変数を使ったフォーマット
        String formattedString = String.format("名前: %s, 年齢: %d, 趣味: %s", name, age, hobby);
        
        // フォーマットされた文字列を出力
        System.out.println(formattedString);
    }
}

名前: 花子, 年齢: 30, 趣味: 読書

2. 数値の整形

数値を特定の形式で表示することも可能です。

以下の例では、浮動小数点数を小数点以下2桁で表示します。

public class App {
    public static void main(String[] args) {
        double price = 9876.54321; // 価格
        // 数値を小数点以下2桁でフォーマット
        String formattedString = String.format("価格: ¥%,.2f", price);
        
        // フォーマットされた文字列を出力
        System.out.println(formattedString);
    }
}

価格: ¥9,876.54

3. 日付のフォーマット

日付を特定の形式で表示することもできます。

以下の例では、日付を「年-月-日」の形式で表示します。

import java.util.Date; // Dateクラスをインポート
public class App {
    public static void main(String[] args) {
        Date date = new Date(); // 現在の日付
        // 日付を「年-月-日」の形式でフォーマット
        String formattedString = String.format("今日の日付: %tY-%<tm-%<td", date);
        
        // フォーマットされた文字列を出力
        System.out.println(formattedString);
    }
}

今日の日付: 2023-10-01

これらの応用例からもわかるように、formatメソッドは非常に柔軟で強力な機能を持っています。

さまざまなデータ型や形式に対応できるため、実際のアプリケーションでの利用が広がります。

formatメソッドの注意点

formatメソッドを使用する際には、いくつかの注意点があります。

これらを理解しておくことで、エラーを避けたり、より効果的にメソッドを活用したりすることができます。

以下に主な注意点を挙げます。

1. フォーマット指定子の不一致

フォーマット指定子と引数の型が一致しない場合、IllegalFormatExceptionが発生します。

例えば、整数を期待している場所に文字列を渡すとエラーになります。

public class App {
    public static void main(String[] args) {
        String name = "太郎"; // 名前
        // 整数を期待しているが文字列を渡している
        String formattedString = String.format("年齢: %d", name); // エラー
    }
}

2. 引数の不足または過剰

指定したフォーマット指定子の数と引数の数が一致しない場合もエラーが発生します。

引数が不足しているとMissingFormatArgumentException、過剰だとIllegalFormatExceptionが発生します。

public class App {
    public static void main(String[] args) {
        String name = "太郎"; // 名前
        // 引数が不足している
        String formattedString = String.format("名前: %s, 年齢: %d", name); // エラー
    }
}

3. 特殊文字のエスケープ

フォーマット文字列内で%を使用する場合は、%%と記述する必要があります。

これを忘れると、IllegalFormatConversionExceptionが発生します。

public class App {
    public static void main(String[] args) {
        double price = 1000.0; // 価格
        // %を表示するためには%%を使用
        String formattedString = String.format("価格: ¥%.2f%%", price); // エラー
    }
}

4. Localeの考慮

formatメソッドは、デフォルトのロケールを使用しますが、特定のロケールを指定することも可能です。

ロケールを考慮しないと、数値や日付の表示が期待通りにならないことがあります。

import java.util.Locale; // Localeクラスをインポート
public class App {
    public static void main(String[] args) {
        double price = 1234567.89; // 価格
        // 日本のロケールを指定
        String formattedString = String.format(Locale.JAPAN, "価格: ¥%,.2f", price);
        
        // フォーマットされた文字列を出力
        System.out.println(formattedString);
    }
}

5. パフォーマンスへの影響

formatメソッドは便利ですが、パフォーマンスに影響を与える可能性があります。

特に大量の文字列をフォーマットする場合は、StringBuilderを使用することを検討してください。

public class App {
    public static void main(String[] args) {
        StringBuilder sb = new StringBuilder(); // StringBuilderを使用
        for (int i = 0; i < 1000; i++) {
            sb.append(String.format("アイテム%d\n", i)); // formatメソッドを使用
        }
        System.out.println(sb.toString()); // 出力
    }
}

これらの注意点を理解し、適切に対処することで、formatメソッドをより効果的に活用することができます。

エラーを避け、期待通りの結果を得るために、事前に確認しておくことが重要です。