31 Regular expressions library [re]

Шаблон классаmatch_­results обозначает набор последовательностей символов, представляющих результат совпадения регулярного выражения. Хранилище для коллекции выделяется и освобождается по мере необходимости функциями-членами шаблона классаmatch_­results.

Шаблон классаmatch_­results удовлетворяет требованиям контейнера, поддерживающего распределитель, и контейнера последовательности ([container.requirements.general],[sequence.reqmts]), за исключением того, что поддерживаются только операции, определенные для контейнеров последовательностей, квалифицированных как const, и что семантика функций сравнения отличается от семантики, требуемой для контейнера.

Созданный по умолчаниюmatch_­results объект не имеет полностью установленного состояния результата. Результат совпадения - этоready когда, как следствие завершенного совпадения регулярного выражения, изменяющего такой объект, его состояние результата становится полностью установленным. Эффекты вызова большинства функций-членов изmatch_­results неготового объекта не определены.

sub_­match Объект , хранящийся в индексе 0 представляет подвыражение 0, т.е. весь матч. В этом случаеsub_­match член matched всегдаtrue.sub_­match Объект , хранящийся в индексеn означает , что совпавший отмеченные суб-выражение вn пределах согласованного выражения. Если подвыражениеn участвовало в совпадении регулярного выражения, тогдаsub_­match членmatched оцениваетtrue, и элементыfirst иsecond обозначают диапазон символов, [first, second) которые сформировали это совпадение. В противном случаеmatched этоfalse, и членыfirst иsecond точка в конце последовательности, обыскали. [  Note: Этиsub_­match объекты , представляющие различные подвыражения , которые не участвовали в матче регулярного выражения не должны быть различны. ] — end note 

namespace std {
  template <class BidirectionalIterator,
            class Allocator = allocator<sub_match<BidirectionalIterator>>>
    class match_results {
    public:
      using value_type      = sub_match<BidirectionalIterator>;
      using const_reference = const value_type&;
      using reference       = value_type&;
      using const_iterator  = implementation-defined;
      using iterator        = const_iterator;
      using difference_type =
              typename iterator_traits<BidirectionalIterator>::difference_type;
      using size_type       = typename allocator_traits<Allocator>::size_type;
      using allocator_type  = Allocator;
      using char_type       =
              typename iterator_traits<BidirectionalIterator>::value_type;
      using string_type     = basic_string<char_type>;

      // [re.results.const], construct/copy/destroy
      explicit match_results(const Allocator& a = Allocator());
      match_results(const match_results& m);
      match_results(match_results&& m) noexcept;
      match_results& operator=(const match_results& m);
      match_results& operator=(match_results&& m);
      ~match_results();

      // [re.results.state], state
      bool ready() const;

      // [re.results.size], size
      size_type size() const;
      size_type max_size() const;
      bool empty() const;

      // [re.results.acc], element access
      difference_type length(size_type sub = 0) const;
      difference_type position(size_type sub = 0) const;
      string_type str(size_type sub = 0) const;
      const_reference operator[](size_type n) const;

      const_reference prefix() const;
      const_reference suffix() const;
      const_iterator begin() const;
      const_iterator end() const;
      const_iterator cbegin() const;
      const_iterator cend() const;

      // [re.results.form], format
      template <class OutputIter>
        OutputIter
          format(OutputIter out,
                 const char_type* fmt_first, const char_type* fmt_last,
                 regex_constants::match_flag_type flags = regex_constants::format_default) const;
      template <class OutputIter, class ST, class SA>
        OutputIter
          format(OutputIter out,
                 const basic_string<char_type, ST, SA>& fmt,
                 regex_constants::match_flag_type flags = regex_constants::format_default) const;
      template <class ST, class SA>
        basic_string<char_type, ST, SA>
          format(const basic_string<char_type, ST, SA>& fmt,
                 regex_constants::match_flag_type flags = regex_constants::format_default) const;
      string_type
        format(const char_type* fmt,
               regex_constants::match_flag_type flags = regex_constants::format_default) const;

      // [re.results.all], allocator
      allocator_type get_allocator() const;

      // [re.results.swap], swap
      void swap(match_results& that);
    };
}