C# Substring（開発者向けの動作方法）

構文とパラメーター

Substring メソッドには2つの基本形式があります:

public string Substring(int startIndex);
public string Substring(int startIndex, int length);

public string Substring(int startIndex);
public string Substring(int startIndex, int length);

1. public string Substring(int startIndex): startIndexから始まり、文字列の最後まで続く部分文字列を取得します。
2. public string Substring(int startIndex, int length): startIndexから始まり、指定された長さの部分文字列を取得します。

関連するパラメーターは次のとおりです:

• int startIndex:これは、部分文字列が始まるゼロベースのインデックスです。
• int length: (オプション) 2 番目のパラメーターです。 これが、返される部分文字列に含める文字数です。

Substring メソッドの動作方法

Substring メソッドのプロセスはシンプルです。 呼び出されると、指定されたインデックス (startIndex) から始まる元の文字列から文字を抽出します。 length パラメーターが提供されている場合、メソッドは指定された文字数を返します。 length パラメーターがない場合、文字列の終わりまで続けます。 C# の Substring を使用すると、両方のパラメーター (startIndex および length) が整数として扱われ、型の安全性が確保され、潜在的なランタイムエラーが防止されます。

文字列の終わりまでの抽出

特定のインデックスから文字列の終わりまで部分文字列を抽出する必要があるとしましょう。 以下がその方法です:

// Main method demonstrating substring extraction
public static void Main(string[] args)
{
    string text = "Hello, world!";
    string substring = text.Substring(7); // Extract from index 7 to the end
    Console.WriteLine(substring);
}

// Main method demonstrating substring extraction
public static void Main(string[] args)
{
    string text = "Hello, world!";
    string substring = text.Substring(7); // Extract from index 7 to the end
    Console.WriteLine(substring);
}

出力:

world!

この例では、Substring メソッドはインデックス 7 から始まり、"world!" の 'w' に対応し、文字列の終わりまでのすべての文字を取得します。 これは、部分文字列の長さが動的であるか、予め決まっていない場合に特に便利です。

指定された長さの部分文字列の抽出

次に、開始インデックスと部分文字列の長さの両方が指定されているシナリオを見てみましょう:

// Main method demonstrating substring extraction with specified length
public static void Main(string[] args)
{
    string text = "Hello, world!";
    string substring = text.Substring(7, 5); // Starts at index 7, length of 5
    Console.WriteLine(substring);
}

// Main method demonstrating substring extraction with specified length
public static void Main(string[] args)
{
    string text = "Hello, world!";
    string substring = text.Substring(7, 5); // Starts at index 7, length of 5
    Console.WriteLine(substring);
}

出力:

world

ここでは、部分文字列は7番目の文字から始まり、5文字の長さになります。 この方法は、部分文字列の境界を正確に制御する必要がある場合に非常に便利です。

文字列の配列から部分文字列を取得する

文字列の配列があり、指定された文字位置と長さに基づいて各文字列から部分文字列を抽出したい場合としましょう。 foreach ループを使用して配列を反復処理し、各文字列に Substring メソッドを適用できます。

// Example of extracting substrings from an array of strings
string[] array = { "apple", "banana", "orange" };
foreach (string str in array)
{
    string substring = str.Substring(1, 3); // Substring starts from index 1
    Console.WriteLine(substring);
}

// Example of extracting substrings from an array of strings
string[] array = { "apple", "banana", "orange" };
foreach (string str in array)
{
    string substring = str.Substring(1, 3); // Substring starts from index 1
    Console.WriteLine(substring);
}

このコードは次を出力します:

ppl
ana
ran

インデックスの有効性を確認する

部分文字列の抽出がエラーを引き起こさないようにするために、チェックを追加することができます:

// Main method with checks to avoid ArgumentOutOfRangeException
public static void Main(string[] args)
{
    string text = "Hello, world!";
    int startIndex = 7;
    int length = 5;
    if (startIndex >= 0 && startIndex < text.Length && startIndex + length <= text.Length)
    {
        string substring = text.Substring(startIndex, length);
        Console.WriteLine(substring);
    }
    else
    {
        Console.WriteLine("Invalid substring parameters.");
    }
}

// Main method with checks to avoid ArgumentOutOfRangeException
public static void Main(string[] args)
{
    string text = "Hello, world!";
    int startIndex = 7;
    int length = 5;
    if (startIndex >= 0 && startIndex < text.Length && startIndex + length <= text.Length)
    {
        string substring = text.Substring(startIndex, length);
        Console.WriteLine(substring);
    }
    else
    {
        Console.WriteLine("Invalid substring parameters.");
    }
}

このコードブロックは、部分文字列のパラメーターが正しいことを確認してから部分文字列を抽出するため、潜在的なランタイムエラーを回避します。

コード例: 抽出した文字列から PDF を生成する

指定されたインデックスに重要な情報が含まれる大きなテキストがあり、その情報を抽出して PDF ファイルを生成する必要があるシナリオを考えてみましょう。 以下は、IronPDF と C# の Substring メソッドの両方を使用してこれを達成するためのステップバイステップの例です。

using IronPdf;
using System;

public class PdfGenerator
{
    public static void Main(string[] args)
    {
        // Applying your license for IronPDF
        License.LicenseKey = "License-Key";
        // Original large text from which we need to extract information
        string originalText = "IronPDF helps you generate PDF documents in .NET applications easily. Discover more about IronPDF at the official site.";
        // Using the Substring method to extract the part of the string that talks about IronPDF
        string importantInfo = originalText.Substring(0, 65);  // Extracts the first sentence

        // Create a PDF document with IronPDF
        var renderer = new ChromePdfRenderer();
        // Convert the extracted text to PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf($"<h1>Extracted Information</h1><p>{importantInfo}</p>");
        // Save the PDF to a file
        pdf.SaveAs("ExtractedInfo.pdf");
        // Confirmation output
        Console.WriteLine("PDF generated successfully with extracted information.");
    }
}

using IronPdf;
using System;

public class PdfGenerator
{
    public static void Main(string[] args)
    {
        // Applying your license for IronPDF
        License.LicenseKey = "License-Key";
        // Original large text from which we need to extract information
        string originalText = "IronPDF helps you generate PDF documents in .NET applications easily. Discover more about IronPDF at the official site.";
        // Using the Substring method to extract the part of the string that talks about IronPDF
        string importantInfo = originalText.Substring(0, 65);  // Extracts the first sentence

        // Create a PDF document with IronPDF
        var renderer = new ChromePdfRenderer();
        // Convert the extracted text to PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf($"<h1>Extracted Information</h1><p>{importantInfo}</p>");
        // Save the PDF to a file
        pdf.SaveAs("ExtractedInfo.pdf");
        // Confirmation output
        Console.WriteLine("PDF generated successfully with extracted information.");
    }
}

このプロセスは、テキスト操作と PDF 作成を統合する簡単な方法を示しており、特定の情報をより大きなテキストから抽出して提示する必要がある報告書や文書の生成に特に役立ちます。