Parseint C#（開発者向けの仕組み）

整数のパースの基本

C#では、文字列値（例えば「123」）を整数に変換するには、int.Parse()またはConvert.ToInt32()を使用するのが一般的です。 これらのメソッドは、文字列データを計算やバリデーションのための使用可能な数値に変換するために開発者を支援します。

• int.Parse(string s): 文字列を整数に変換します。 文字列が有効な整数でない場合は例外をスローします。
• Convert.ToInt32(string s): null入力を異なる方法で処理し、文字列を整数に変換します。

int.Parse()を使用して文字列を変換する例を以下に示します。

string numberString = "123";
// Convert the string to an integer using int.Parse
int num = int.Parse(numberString);
Console.WriteLine(num); // Output: 123

string numberString = "123";
// Convert the string to an integer using int.Parse
int num = int.Parse(numberString);
Console.WriteLine(num); // Output: 123

Dim numberString As String = "123"
' Convert the string to an integer using int.Parse
Dim num As Integer = Integer.Parse(numberString)
Console.WriteLine(num) ' Output: 123

もう一方で、Convertクラスを利用する方法もあります。

string numericString = "123";
// Convert the string to an integer using Convert.ToInt32
int result = Convert.ToInt32(numericString);
Console.WriteLine(result); // Outputs: 123

string numericString = "123";
// Convert the string to an integer using Convert.ToInt32
int result = Convert.ToInt32(numericString);
Console.WriteLine(result); // Outputs: 123

Dim numericString As String = "123"
' Convert the string to an integer using Convert.ToInt32
Dim result As Integer = Convert.ToInt32(numericString)
Console.WriteLine(result) ' Outputs: 123

Convertクラスを用いることで、安全に文字列や他のデータ型を変換できます。 特に、文字列変数がnullまたは無効な値を表す可能性がある場合に有用で、Convert.ToInt32()は例外をスローする代わりにデフォルト値（この場合は0）を返します。

デフォルト値とエラー処理

文字列を整数に変換する際に開発者がよく直面する問題の一つは、無効または数値でない入力を扱うことです。 数値の文字列表現が正しい形式でない場合、int.Parse()のようなメソッドは例外をスローします。 しかし、Convert.ToInt32()には無効な文字列に対する組み込みのフォールバックメカニズムがあります。

パース時にデフォルト値を処理する方法を示す例を以下に示します。

string invalidString = "abc";
// Convert will return 0 instead of throwing an exception for invalid input
int result = Convert.ToInt32(invalidString);
Console.WriteLine(result); // Outputs: 0

string invalidString = "abc";
// Convert will return 0 instead of throwing an exception for invalid input
int result = Convert.ToInt32(invalidString);
Console.WriteLine(result); // Outputs: 0

Dim invalidString As String = "abc"
' Convert will return 0 instead of throwing an exception for invalid input
Dim result As Integer = Convert.ToInt32(invalidString)
Console.WriteLine(result) ' Outputs: 0

int.TryParse()を使用すれば、変換が成功したかどうかを示すブール値を返すため、制御のある文字列変換が可能です：

string invalidInput = "abc";
// Attempt to parse using TryParse, which avoids exceptions for invalid input
if (int.TryParse(invalidInput, out int result))
{
    Console.WriteLine(result);
}
else
{
    Console.WriteLine("Parsing failed.");
}

string invalidInput = "abc";
// Attempt to parse using TryParse, which avoids exceptions for invalid input
if (int.TryParse(invalidInput, out int result))
{
    Console.WriteLine(result);
}
else
{
    Console.WriteLine("Parsing failed.");
}

Dim invalidInput As String = "abc"
' Attempt to parse using TryParse, which avoids exceptions for invalid input
Dim result As Integer
If Integer.TryParse(invalidInput, result) Then
	Console.WriteLine(result)
Else
	Console.WriteLine("Parsing failed.")
End If

この場合、TryParse()は変換された整数を格納するための出力パラメータを使用し、例外をスローすることなく値を返すことができます。 変換に失敗すると、プログラムを単にクラッシュさせる代わりにelse文が実行されます。 さもなければ、プログラムは入力文字列から成功裏にパースされた数値の結果を表示します。 int.TryParseを使用することは、変換の失敗が予想され、プログラムのクラッシュを避けたい場合に役立ちます。

なぜIronPDFをデータパースに使用するのか？

PDFを扱う際、文字列値に含まれる数値データを含む表や非構造化テキストに遭遇することがあります。 このデータを抽出して処理するためには、文字列を整数に変換することが重要です。 IronPDFはこのプロセスを簡単にし、PDFコンテンツを読み取って文字列を数値に変換する操作を行うという柔軟性と力を提供します。

以下はIronPDFが提供する主な特徴のいくつかです：

• HTML to PDF変換: IronPDFは、HTMLコンテンツ（CSS、画像、JavaScriptを含む）を完全にフォーマットされたPDFに変換できます。 これは、動的なウェブページやレポートをPDFとしてレンダリングするのに特に有用です。
• PDF編集: IronPDFを使えば、既存のPDFドキュメントにテキスト、画像、グラフィックスを追加したり、既存ページのコンテンツを編集することができます。
• テキストと画像の抽出: ライブラリは、PDFからテキストと画像を抽出することを可能にし、PDFコンテンツの解析と分析を簡単にします。
• ウォーターマーキング: ブランド化や著作権保護のためにPDF文書にウォーターマークを追加することもできます。

IronPDFの始め方

// Command to install IronPDF package via the Package Manager Console
Install-Package IronPdf

using IronPdf;

using IronPdf;

Imports IronPdf

例: PDFからの数値抽出と解析

using IronPdf;
using System.Text.RegularExpressions;

public class Program
{
    public static void Main(string[] args)
    {
        // Load a PDF file
        PdfDocument pdf = PdfDocument.FromFile("example.pdf");

        // Extract all text from the PDF
        string text = pdf.ExtractAllText();

        // Print the extracted text (for reference)
        Console.WriteLine("Extracted Text: ");
        Console.WriteLine(text);

        // Parse and print all numbers found in the extracted text
        Console.WriteLine("\nParsed Numbers:");

        // Use regular expression to find all number patterns, including integers and decimals
        var numberMatches = Regex.Matches(text, @"\d+(\.\d+)?");

        // Iterate through all matched numbers and print them
        foreach (Match match in numberMatches)
        {
            // Print each matched number
            Console.WriteLine($"{match.Value}");
        }
    }
}

using IronPdf;
using System.Text.RegularExpressions;

public class Program
{
    public static void Main(string[] args)
    {
        // Load a PDF file
        PdfDocument pdf = PdfDocument.FromFile("example.pdf");

        // Extract all text from the PDF
        string text = pdf.ExtractAllText();

        // Print the extracted text (for reference)
        Console.WriteLine("Extracted Text: ");
        Console.WriteLine(text);

        // Parse and print all numbers found in the extracted text
        Console.WriteLine("\nParsed Numbers:");

        // Use regular expression to find all number patterns, including integers and decimals
        var numberMatches = Regex.Matches(text, @"\d+(\.\d+)?");

        // Iterate through all matched numbers and print them
        foreach (Match match in numberMatches)
        {
            // Print each matched number
            Console.WriteLine($"{match.Value}");
        }
    }
}

Imports Microsoft.VisualBasic
Imports IronPdf
Imports System.Text.RegularExpressions

Public Class Program
	Public Shared Sub Main(ByVal args() As String)
		' Load a PDF file
		Dim pdf As PdfDocument = PdfDocument.FromFile("example.pdf")

		' Extract all text from the PDF
		Dim text As String = pdf.ExtractAllText()

		' Print the extracted text (for reference)
		Console.WriteLine("Extracted Text: ")
		Console.WriteLine(text)

		' Parse and print all numbers found in the extracted text
		Console.WriteLine(vbLf & "Parsed Numbers:")

		' Use regular expression to find all number patterns, including integers and decimals
		Dim numberMatches = Regex.Matches(text, "\d+(\.\d+)?")

		' Iterate through all matched numbers and print them
		For Each match As Match In numberMatches
			' Print each matched number
			Console.WriteLine($"{match.Value}")
		Next match
	End Sub
End Class

コードの説明

1. PDFからテキストを抽出:

   コードは、IronPDFを用いてPDFファイルを読み込むことから始まります。 その後、PDFからすべてのテキストを抽出します。

2. 正規表現を使用して数値を検索:

   コードは正規表現（テキストをマッチするパターン）を使用して、抽出されたテキストの中から任意の数値を検索します。 正規表現は、整数（例えば12345）と小数（例えば50.75）の両方を探します。

3. 数値をパースして表示:

   数値が見つかったら、プログラムはそれぞれをコンソールに表示します。 これには整数と小数が含まれています。

4. なぜ正規表現か:

   正規表現はテキスト内のパターン（例: 数字）を見つけるための強力なツールです。 通貨記号のような記号を持つ数値も扱うことができ、プロセスをより柔軟にします。

PDF内の不正なフォーマット

PDFにはしばしば「1,234.56」や「12,345 USD」のように形式化された数値が含まれます。 これらを正しく処理するためには、数値の文字列表現がパース用に正しい形式であることを確認する必要があります。 IronPDFを使用すると、テキストをきれいに抽出でき、文字列操作メソッド（例えばReplace()）を使用して変換前にフォーマットを調整できます。

例:

string formattedNumber = "1,234.56"; // String value with commas
// Remove commas from the string to clean it
string cleanNumber = formattedNumber.Replace(",", "");
// Convert the cleaned string to an integer by first converting to double then to integer
int result = Convert.ToInt32(Convert.ToDouble(cleanNumber));
Console.WriteLine(result); // Outputs: 1234

string formattedNumber = "1,234.56"; // String value with commas
// Remove commas from the string to clean it
string cleanNumber = formattedNumber.Replace(",", "");
// Convert the cleaned string to an integer by first converting to double then to integer
int result = Convert.ToInt32(Convert.ToDouble(cleanNumber));
Console.WriteLine(result); // Outputs: 1234

Dim formattedNumber As String = "1,234.56" ' String value with commas
' Remove commas from the string to clean it
Dim cleanNumber As String = formattedNumber.Replace(",", "")
' Convert the cleaned string to an integer by first converting to double then to integer
Dim result As Integer = Convert.ToInt32(Convert.ToDouble(cleanNumber))
Console.WriteLine(result) ' Outputs: 1234

テキスト中の複数の数値を扱う

複雑なPDFでは、数値が異なる形式で現れたり、異なる場所に散らばっていることがあります。 IronPDFを使用すると、すべてのテキストを抽出し、その後、正規表現を使用して効果的に文字列を整数に変換できます。