std::regex_iterator

std::regex_iterator est un ForwardIterator en lecture seule qui permet d'accder aux diffrents matchs d'une expression rgulire dans la chane de caractres sous-jacent .

sur la construction et sur chaque augmentation, il appelle std::regex_search et se souvient du rsultat (qui est, enregistre une copie de la valeur std::match_results<BidirIt>). Le premier objet peut tre lu lorsque l'itrateur est construit ou lorsque le drfrencement premier pas est fait. Sinon, le drfrencement retourne uniquement une copie de le match le plus rcemment obtenu regex .

La valeur par dfaut est construit std::regex_iterator l'itrateur de fin de squence. Quand un std::regex_iterator valide est incrment aprs avoir atteint le dernier match (std::regex_search retours false), elle devient gale la fin de itrateur squence. drfrencement ou incrmenter il invoque par ailleurs un comportement indfini .

Une application typique de std::regex_iterator dtient le dbut et de fin pour les itrateurs la squence sous-jacente (deux instances de BidirIt), un pointeur sur l'expression rgulire (const regex_type*) et les indicateurs de correspondance (std::regex_constants::match_flag_type), et le rsultat actuel (std::match_results<BidirIt>) .

Plusieurs spcialisations pour les types courants de squence de caractres sont dfinies:

Il est de la responsabilit du programmeur de s'assurer que l'objet std::basic_regex pass au constructeur de l'itrateur survit l'itrateur. Parce que l'itrateur stocke un pointeur vers la regex, l'incrmentation de l'itrateur aprs l'expression rationnelle a t dtruit accde un pointeur dangling .

Si la partie de l'expression rgulire qui correspond est juste une affirmation (^, $, \b, \B), le match stockes dans l'itrateur est un match de longueur nulle, c'est--match[0].first == match[0].second .

#include <regex>
#include <iterator>
#include <iostream>

int main()
{
    const std::string text = "Quick brown fox.";

    std::regex re("[^\\s]+");
    auto beg = std::sregex_iterator(text.begin(), text.end(), re);
    auto end = std::sregex_iterator();

    std::cout << "The number of words is " << std::distance(beg, end) << '\n';
}

The number of words is 3