Regex クラス

.NET Framework クラス ライブラリ リファレンス

Regex クラス

変更不可の正規表現を表します。

名前空間: System.Text.RegularExpressions
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class Regex
    Implements ISerializable

Visual Basic (使用法)

Dim instance As Regex

C#

[SerializableAttribute] 
public class Regex : ISerializable

C++

[SerializableAttribute] 
public ref class Regex : ISerializable

J#

/** @attribute SerializableAttribute() */ 
public class Regex implements ISerializable

JScript

SerializableAttribute 
public class Regex implements ISerializable

解説

Regex クラスには、Regex オブジェクトを明示的に作成しなくても正規表現を使用できるようにする静的メソッドがいくつかあります。静的メソッドを使用することは、Regex オブジェクトを構築し、一度使用してから破棄することと等しい操作になります。

Regex クラスは変更不可 (読み取り専用) でスレッド セーフになっています。Regex オブジェクトはどのスレッドにでも作成でき、複数のスレッド間で共有できます。詳細については、「スレッド セーフ」を参照してください。

使用例

正規表現を使用して、文字列が通貨値を表す正しい形式かどうかをチェックするコード例を次に示します。^ および $ トークンで囲むことにより、部分文字列ではなく文字列全体が正規表現に一致する必要があることを示している点に注意してください。

C#

using System;
using System.Text.RegularExpressions;

public class Test
{

    public static void Main
 ()
    {

          // Define a regular expression for currency values.
          Regex rx = new Regex(@"^-?\d+(\.\d{2})?$");
          
          // Define some test strings.
          string[] tests = {"-42", "19.99",
 "0.001", "100 USD"};
          
          // Check each test string against the regular expression.
          foreach (string test in
 tests)
          {
              if (rx.IsMatch(test))
              {
                  Console.WriteLine("{0} is a currency value.", test);
              }
              else
              {
                  Console.WriteLine("{0} is not a currency value.", test);
              }
          }
         
    }    
    
}

C++

#using <System.dll>

using namespace System;
using namespace System::Text::RegularExpressions;
int main()
{
   
   // Define a regular expression for currency values.
   Regex^ rx = gcnew Regex( "^-?\\d+(\\.\\d{2})?$" );
   
   // Define some test strings.
   array<String^>^tests = {"-42","19.99","0.001","100
 USD"};
   
   // Check each test string against the regular expression.
   System::Collections::IEnumerator^ myEnum = tests->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      String^ test = safe_cast<String^>(myEnum->Current);
      if ( rx->IsMatch( test ) )
      {
         Console::WriteLine( "{0} is a currency value.", test );
      }
      else
      {
         Console::WriteLine( "{0} is not a currency value.", test );
      }
   }
}

J#

import System.*;
import System.Text.RegularExpressions.*;

public class Test
{
    public static void main(String[]
 args)
    {
        // Define a regular expression for currency values.
        Regex rx = new Regex("^-?\\d+(\\.\\d{2})?$");

        // Define some test strings.
        String tests[] =  { "-42", "19.99", "0.001",
 "100 USD" };

        // Check each test string against the regular expression.
        for (int iCtr = 0; iCtr < tests.get_Length();
 iCtr++) {
            String test = (String)tests.get_Item(iCtr);
            if (rx.IsMatch(test)) {
                Console.WriteLine("{0} is a currency value.", test);
            }
            else {
                Console.WriteLine("{0} is not a currency value.", test);
            }
        }
    } //main 
} //Test

正規表現を使用して、文字列内で繰り返し出現する語をチェックするコード例を次に示します。(?<word>) 構成体を使用してグループに名前を付け、(\k<word>) 構成体を使用してそのグループを式内で後から参照していることに注意してください。

C#

using System;
using System.Text.RegularExpressions;

public class Test
{

    public static void Main
 ()
    {

        // Define a regular expression for repeated words.
        Regex rx = new Regex(@"\b(?<word>\w+)\s+(\k<word>)\b"
,
          RegexOptions.Compiled | RegexOptions.IgnoreCase);

        // Define a test string.        
        string text = "The the quick brown fox  fox jumped
 over the lazy dog dog.";
        
        // Find matches.
        MatchCollection matches = rx.Matches(text);

        // Report the number of matches found.
        Console.WriteLine("{0} matches found.", matches.Count);

        // Report on each match.
        foreach (Match match in matches)
        {
            string word = match.Groups["word"].Value;
            int index = match.Index;
            Console.WriteLine("{0} repeated at position {1}", word, index);
   
        }
        
    }
    
}

C++

#using <System.dll>

using namespace System;
using namespace System::Text::RegularExpressions;
int main()
{
   // Define a regular expression for repeated words.
   Regex^ rx = gcnew Regex( "\\b(?<word>\\w+)\\s+(\\k<word>)\\b",static_cast<RegexOptions>(RegexOptions::Compiled
 | RegexOptions::IgnoreCase) );

   // Define a test string.        
   String^ text = "The the quick brown fox  fox jumped over the lazy dog dog.";

   // Find matches.
   MatchCollection^ matches = rx->Matches( text );

   // Report the number of matches found.
   Console::WriteLine( "{0} matches found.", matches->Count );

   // Report on each match.
   for each (Match^ match in matches)
   {
      String^ word = match->Groups["word"]->Value;
      int index = match->Index;
      Console::WriteLine("{0} repeated at position {1}", word, index);
   
   }
}

J#

import System.*;
import System.Text.RegularExpressions.*;

public class Test
{
    public static void main(String[]
 args)
    {
        // Define a regular expression for repeated words.
        Regex rx = new Regex("\\b(?<word>\\w+)\\s+(\\k<word>)\\b",
 
            RegexOptions.Compiled | RegexOptions.IgnoreCase);

        // Define a test string.        
        String text = "The the quick brown fox  fox jumped over the "
            + "lazy dog dog.";

        // Find matches.
        MatchCollection matches = rx.Matches(text);

        // Report the number of matches found.
        Console.WriteLine("{0} matches found.", (Int32)matches.get_Count());

        // Report on each match.
        for (int iCtr = 0; iCtr < matches.get_Count();
 iCtr++) {
            Match match = matches.get_Item(iCtr);
            String word = match.get_Groups().get_Item("word").get_Value();
            int index = match.get_Index();
            Console.WriteLine("{0} repeated at position {1}", word, 
                (Int32)index);
        }
    } //main       
} //Test

継承階層

System.Object
  System.Text.RegularExpressions.Regex
     派生クラス

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Regex メンバ
System.Text.RegularExpressions 名前空間
その他の技術情報
.NET Framework の正規表現
正規表現言語要素