C# | TryParse：文字列から別のデータ型への変換

TryParseメソッドは、C#で文字列を特定のデータ型に変換しようとする際に使用される便利なメソッドです。

例外をスローすることなく、変換が成功したかどうかを示すブール値を返します。

string input = "123";
if (int.TryParse(input, out int result))
{
    Console.WriteLine($"変換成功: {result}");
}
else
{
    Console.WriteLine("変換失敗");
}

TryParseを使用していて考えられる主な疑問や問題点を挙げてみます。

どのようなデータ型に対応しているのか？：TryParseメソッドがどのデータ型（整数、浮動小数点数、日付など）に対応しているのかについて知りたい。
エラーハンドリングの最適な方法は？：TryParseメソッドで変換に失敗した場合のエラーハンドリングの方法や、代替手段について知りたい。
ParseとTryParseの違い：具体的な違いは何があるのか。

この記事ではこれらについて詳しく解説します。

: C# | 暗黙的キャストの活用：データ型キャストの完全ガイド
暗黙的キャストは、変数や式を明示的に型変換せずに別のデータ型に自動的に変換する方法です。 int intValue = 10; double doubleValue = intValue; // in ...

: C# | ボクシング（Boxing）：値型を参照型に変換する方法
ボクシングとは、値型のデータを参照型のオブジェクトとして扱うことを指します。C# では、値型のデータ（int、double、char など）を参照型の object や interface 型に代入す ...

TryParseメソッドとは？
TryParseの種類
TryParseの簡単な例
TryParseの使用上の注意点
エラーハンドリングの方法
ParseとTryParseの違い
まとめ

TryParseメソッドとは？

ポイント

TryParseメソッドを使用した安全な変換は、Parseメソッドと同様に文字列から別のデータ型への変換を行いますが、異なる点はエラーハンドリングの方法です。

Parseメソッドは変換に失敗した場合に例外をスローしますが、TryParseメソッドはbool型のように成功の時はtrue、失敗の時はfalseを返します。

これにより、プログラムの実行が中断されずにエラーを処理できます。

TryParseの種類

int.TryParse：文字列を整数型 (int) に変換します。
double.TryParse：文字列を倍精度浮動小数点型 (double) に変換します。
float.TryParse：文字列を単精度浮動小数点型 (float) に変換します。
decimal.TryParse：文字列を10進数型 (decimal) に変換します。
DateTime.TryParse：文字列を日付型 (DateTime) に変換します。
bool.TryParse：文字列を真偽値型 (bool) に変換します。

TryParseの簡単な例

以下の例では、文字列 "123" を整数に変換し、TryParse メソッドを使用して変換が成功したかどうかを確認しています。

using System;

public class Program
{
    public static void Main()
    {
        string numberString = "123";
        int number;

        if (int.TryParse(numberString, out number))
        {
            Console.WriteLine("変換に成功しました。: " + number);
        }
        else
        {
            Console.WriteLine("変換に失敗しました。");
        }
    }
}

コードの解説

if (int.TryParse(numberString, out number))
TryParse メソッドを使用して文字列を整数に変換し、変換の成否を判断します。
- int.TryParse メソッドは、numberString を整数に変換し、変換が成功した場合は true を返し、number パラメータに変換後の値を格納します。
- 変換に失敗した場合は false を返し、number パラメータには整数型の既定値（0）が格納されます。

TryParse メソッドは変換が成功したらどうなるの？

ねこ

たく

成功すると、true を返して、変換した値を out パラメータで指定した変数に入れてくれるよ。

失敗した場合は？

ねこ

たく

失敗すると、false を返して、指定した変数にはその型のデフォルト値が入るんだ。

TryParseの使用上の注意点

戻り値の確認
変換が成功した場合は true が返され、out パラメータに変換された値が格納されます。変換が失敗した場合は false が返され、out パラメータには各データ型のデフォルト値が設定されます。（int , longなら0）
null 文字列の処理
TryParse メソッドは、文字列が null の場合にも正しく処理されます。具体的には、null が渡された場合、TryParse メソッドは常に false を返します。out パラメーターには型の既定値が格納されます。

エラーハンドリングの方法

TryParseメソッドで変換に失敗した場合のエラーハンドリングの方法や、代替手段について紹介します。

TryParseメソッドで変換に失敗した場合のエラーハンドリングの方法

以下３点の方法について解説します。

方法１：条件分岐による処理
方法２：デフォルト値の設定
方法３：エラーメッセージの提供

方法１：条件分岐による処理： TryParseメソッドの戻り値を利用して、変換が成功したかどうかを確認し、それに応じた処理を行います。

string inputString = "123"; // 変換したい文字列
        int result;

        if (int.TryParse(inputString, out result))
        {
            // 成功した場合の処理
            Console.WriteLine($"変換成功しました。結果は {result} です。");
        }
        else
        {
            // 失敗した場合の処理
            Console.WriteLine("入力値は整数として解釈できませんでした。");
        }

方法２：デフォルト値の設定：変換に失敗した場合にはデフォルトの値を設定する方法です。これにより、後続の処理で安全に値を使用することができます。

string inputString = "abc"; // 変換したい文字列（ここでは意図的に無効な文字列を使用）
        int defaultValue = 0; // デフォルト値
        int result;

        if (!int.TryParse(inputString, out result))
        {
            result = defaultValue; // デフォルト値の設定
            Console.WriteLine("入力値は整数として解釈できませんでした。デフォルト値を使用します。");
        }
        
        Console.WriteLine($"最終的な結果は {result} です。");

方法３：エラーメッセージの提供：失敗した理由やユーザーに通知するための適切なエラーメッセージを表示する方法です。

string inputString = "abc"; // 変換したい文字列（ここでは意図的に無効な文字列を使用）
        int result;

        if (!int.TryParse(inputString, out result))
        {
            Console.WriteLine($"入力値 '{inputString}' は整数として解釈できませんでした。正しい形式で入力してください。");
        }

代替手段

TryParseメソッドの代わりにtry-catch文の例外処理を行う方法です。

string inputString = "abc"; // 変換したい文字列（ここでは意図的に無効な文字列を使用）

        try
        {
            int result = int.Parse(inputString); // 変換に失敗すると例外がスローされる
            Console.WriteLine($"変換成功しました。結果は {result} です。");
        }
        catch (FormatException ex)
        {
            Console.WriteLine($"入力値 '{inputString}' は整数として解釈できませんでした。正しい形式で入力してください。");
            // 例外がスローされた場合の追加の処理
            // 例えば、ログにエラーを記録するなどの処理が可能です。
            Console.WriteLine("エラー詳細: " + ex.Message);
        }