std:: regex_iterator

std::regex_iterator 는 기본 문자 시퀀스 내에서 정규 표현식의 개별 일치 항목에 접근하는 읽기 전용 반복자입니다. 이는 LegacyForwardIterator 요구 사항을 충족하지만, 역참조 가능한 값 a 와 b 가 a == b 를 만족할 때, * a 와 * b 가 동일한 객체에 바인딩되지 않는다는 점이 예외입니다.

생성 시와 모든 증가 연산 시에 std::regex_search 을 호출하고 결과를 저장합니다(즉, std:: match_results < BidirIt > 값의 복사본을 저장). 첫 번째 객체는 반복자가 생성될 때나 첫 번째 역참조가 수행될 때 읽힐 수 있습니다. 그 외의 경우, 역참조는 가장 최근에 얻은 정규식 일치의 복사본만 반환합니다.

기본 생성된 std::regex_iterator 는 시퀀스 종료 반복자입니다. 유효한 std::regex_iterator 가 마지막 매치에 도달한 후 증가되면( std::regex_search 가 false 를 반환함), 이는 시퀀스 종료 반복자와 동일해집니다. 이를 역참조하거나 추가로 증가시키는 것은 정의되지 않은 동작을 유발합니다.

std::regex_iterator 의 일반적인 구현은 기본 시퀀스에 대한 시작 및 끝 반복자( BidirIt 의 두 인스턴스), 정규 표현식에 대한 포인터( const regex_type * ), 매치 플래그( std::regex_constants::match_flag_type ), 그리고 현재 매치( std:: match_results < BidirIt > )를 보유합니다.

타입 요구사항

특수화

일반적인 문자 시퀀스 타입에 대한 여러 특수화가 정의되어 있습니다:

멤버 타입

데이터 멤버

멤버 함수

참고 사항

프로그래머의 책임으로, 반복자의 생성자에 전달된 std::basic_regex 객체가 반복자보다 오래 존재하도록 보장해야 합니다. 반복자가 regex에 대한 포인터를 저장하기 때문에, regex가 소멸된 후 반복자를 증가시키면 댕글링 포인터에 접근하게 됩니다.

정규 표현식에서 일치한 부분이 단순히 단정문(assertion) ( ^ , $ , \b , \B )인 경우, 반복자에 저장된 매치는 길이가 0인 매치입니다. 즉, match [ 0 ] . first == match [ 0 ] . second 입니다.

예제

#include <iostream>
#include <iterator>
#include <regex>
#include <string>
int main()
{
    const std::string s = "Quick brown fox.";
    std::regex words_regex("[^\\s]+");
    auto words_begin = std::sregex_iterator(s.begin(), s.end(), words_regex);
    auto words_end = std::sregex_iterator();
    std::cout << "Found " << std::distance(words_begin, words_end) << " words:\n";
    for (std::sregex_iterator i = words_begin; i != words_end; ++i)
    {
        std::smatch match = *i;
        std::string match_str = match.str();
        std::cout << match_str << '\n';
    }
}

Found 3 words:
Quick
brown
fox.

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

1. ↑ iterator_category 는 해당 결의로 변경되지 않았습니다. 이를 std::input_iterator_tag 로 변경하면 기존 코드가 너무 많이 손상될 수 있기 때문입니다.

참고 항목