namespace std {
  template <class charT,
            class traits = regex_traits<charT> >
  class basic_regex;

  using regex  = basic_regex<char>;
  using wregex = basic_regex<wchar_t>;
}

概要

basic_regexクラステンプレートは、charT型の文字列から構築する正規表現を表す。 charTは、char型、wchar_t型のような文字型である。 traitsは正規表現の文字・変換に関する特性である。 利便性のために、charTをchar特殊化したregexと、charTをwchar_t特殊化したwregexが用意されている。

basic_regexオブジェクトの内部表現や、正規表現アルゴリズムがbasic_regexオブジェクトの内部表現にどのようにアクセスするかは規定されない。 ユーザーはそれらを意識することなく、basic_regexオブジェクトを正規表現アルゴリズムに渡すだけでよい。

このクラス中で発生したエラーは、正規表現アルゴリズムがregex_error型の例外を送出することで通知される。

メンバ関数

構築

代入

定数操作

ロケール

交換

メンバ定数

静的メンバ定数は利便性のためにstd::regex_constantsで定義される定数の同義語として提供される。

メンバ型

非メンバ関数

交換

推論補助

例

#include <iostream>
#include <regex>
#include <string>

int main()
{
  std::string input = "12345";

  // 全てが数字か判定するための正規表現
  std::regex re(R"(^\d+$)");

  if (std::regex_match(input, re)) {
    std::cout << "全て数字です" << std::endl;
  }
  else {
    std::cout << "数字以外が含まれています" << std::endl;
  }
}

出力

全て数字です

バージョン

言語

• C++11

処理系

• Clang: 3.0 ✅, 3.1 ✅, 3.2 ✅, 3.3 ✅, 3.4 ✅, 3.5 ✅, 3.6 ✅
• GCC: 4.9.0 ✅, 4.9.1 ✅, 4.9.2 ✅, 5.0.0 ✅
• Visual C++: ??

参照

• LWG Issue 2001. Class template basic_regex uses non existent string_type
  • C++11で、メンバ型traits_typeとstring_typeが追加された。ほかの箇所でこれらの型名が使われていたが、定義されていなかった
• LWG Issue 2029. Missing 'noexcept' on basic_regex move-assignment operator
  • C++11で、ムーブ代入演算子にnoexceptが付加された