Карта сайта Kansoftware
НОВОСТИУСЛУГИРЕШЕНИЯКОНТАКТЫ
Разработка программного обеспечения

Постусловия:

Struct template match_results

Boost , The Boost C++ Libraries BoostBook Documentation Subset , Reference

Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

PrevUpHomeNext

Struct template match_results

boost::xpressive::match_results — Class template match_results<> holds the results of a regex_match() or a regex_search() as a collection of sub_match objects.

Synopsis

// In header: <boost/xpressive/match_results.hpp>
template<typename BidiIter> 
struct match_results {
  // types
  typedef iterator_value< BidiIter >::type      char_type;          
  typedef unspecified                           string_type;        
  typedef std::size_t                           size_type;          
  typedef sub_match< BidiIter >                 value_type;         
  typedef iterator_difference< BidiIter >::type difference_type;    
  typedef value_type const &                    reference;          
  typedef value_type const &                    const_reference;    
  typedef unspecified                           iterator;           
  typedef unspecified                           const_iterator;     
  typedef unspecified                           nested_results_type;
  // construct/copy/destruct
  match_results();
  match_results(match_results< BidiIter > const &);
  match_results< BidiIter > & operator=(match_results< BidiIter > const &);
  ~match_results();
  // public member functions
  size_type size() const;
  bool empty() const;
  difference_type length(size_type = 0) const;
  difference_type position(size_type = 0) const;
  string_type str(size_type = 0) const;
  template<typename Sub> const_reference operator[](Sub const &) const;
  const_reference prefix() const;
  const_reference suffix() const;
  const_iterator begin() const;
  const_iterator end() const;
  operator bool_type() const;
  bool operator!() const;
  regex_id_type regex_id() const;
  nested_results_type const & nested_results() const;
  template<typename Format, typename OutputIterator> 
    OutputIterator 
    format(OutputIterator, Format const &, 
           regex_constants::match_flag_type = regex_constants::format_default, 
           unspecified = 0) const;
  template<typename OutputIterator> 
    OutputIterator 
    format(OutputIterator, char_type const *, 
           regex_constants::match_flag_type = regex_constants::format_default) const;
  template<typename Format, typename OutputIterator> 
    string_type format(Format const &, 
                       regex_constants::match_flag_type = regex_constants::format_default, 
                       unspecified = 0) const;
  string_type format(char_type const *, 
                     regex_constants::match_flag_type = regex_constants::format_default) const;
  void swap(match_results< BidiIter > &);
  template<typename Arg> match_results< BidiIter > & let(Arg const &);
};

Description

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

Шаблон класса match_results<> соответствует требованиям последовательности, как указано в (lib.sequence.reqmts), за исключением того, что поддерживаются только операции, определенные для конст-квалифицированных последовательностей.

match_results public construct/copy/destruct

  1.  Матч_результаты;

regex_id() == 0

пустой() == истинный

str() == строка_тип()

  • < > &>>

    regex_id()=25>

    regex_id() ==24>regex_id()=25>

    regex_id() ==24>regex_id() ==24>>=24>regex_

    empty() == that.empty().

    str(n) == that.str(n) для всех положительных целых чисел n < that.size().

    prefix() == that.prefix().

    suffix() == that.suffix().

    (*this)[n] == that[n] for all positive integers n < that.size().

    length(n) == that.length(n) для всех положительных целых чисел n < that.size().

    позиция(n) == та.позиция(n) для всех положительных целых чисел n < та.size().

    <68
  • match_results> > const &, что ;4>, что ;4>, , что , , , что , , , что , , , , что , , , , , , , , , , ,            , ,  , ,  

    regex_id() == that.size() == that.empty().

    str(n) == that.str(n) == that.size().

    prefix() == that.prefix().

    suffix() == that.suffix() == that.suffix().

    [this)[n] == что[n] для всех положительных целых чисел n < that.size().

    length(n) == That.length(n) для всех положительных целых чисел n < that.size().

    position(n) == That.position(n) для всех положительных целых чисел n < that.size().

    <36

  • ~match_results();
  • match_results public member functions

    1. size_type size() const;

      Возвращает один плюс число отмеченных подвыражений в обычном выражении, которое было сопоставлено, если * это представляет результат успешного матча. В противном случае возвращается 0.

    2. bool empty() const;

      Размер возврата() == 0.

    3. difference_type length(size_type sub =0)const;

      Возврат (*это)[sub].length().

    4. difference_typeposition(size_type sub =0)const;

      Если!(*это) -1. В противном случае возвращается std::distance(base, (*this)[sub].first), где основание является итератором запуска искомой последовательности. [Примечание - если это не часть повторного поиска с regex_iterator, то основание такое же, как и приставка(). Первое - конец примечания] <27

    5. string_type str(size_type sub = 0) const;

      Возврат (*это)[суб].str().

    6. templatetypename Sub> const_referenceоператорSub const & sub;const;

      Вернет ссылку на объект sub_match, представляющий последовательность, которая соответствовала отмеченной субэкспрессионной подгруппе. Если sub == 0, то возвращается ссылка на объект sub_match, представляющий последовательность, которая соответствовала всему регулярному выражению. Если sub > = размер(), то возвращается объект sub_match, представляющий непревзойденное подвыражение.

    7. const_referenceprefix(;;

      Возвращает ссылку на объект sub_match, представляющий последовательность символов от начала сопоставляемой/изученной строки до начала найденного матча.

      Требует:

      (*это)[0].

    8. const_referenceсуффикс;

      Возвращает ссылку на объект sub_match, представляющий последовательность символов от конца матча, найденного до конца строки, подходящей/исследованной.

      Требуется:

      (*это)[0].

    9. const_iterator begin() const;

      Вернет стартовый итератор, который перечисляет все отмеченные подэкспрессионные совпадения, хранящиеся в *this.

    10. const_iterator end() const;

      Возвращает завершающий итератор, который перечисляет все отмеченные подэкспрессионные совпадения, хранящиеся в *это.

    11. оператор bool_type() const;

      Вернет истинное значение, если (*это)[0]. Сравненный, другой возвращает ложное значение.

    12. boolоператор!()конст;

      Вернётся истинным, если пустой() | | !(*это)[0]. Подтверждено, остальное возвращается ложным.

    13. regex_id_type regex_id()const;

      Возвращает идентификатор объекта basic_regex, последний раз использованного с этим объектом match_results.

    14. nested_results_type const & nested_results() const;

      Возвращает последовательность вложенных match_results элементов.

    15. templatetypename OutputIteratorформат,const ,regex_constants, match_flag_type=3>::regex_constants,const Если Format модели ForwardRange до OutputIterator Для каждого спецификатора формата или последовательности выхода в fmt замените эту последовательность либо символом(ами), который она представляет, либо последовательностью в *, к которой она относится. Указанные в флагах битмаски определяют, в каком формате распознаются спецификаторы или последовательности побегов. По умолчанию это формат, используемый ECMA-262, спецификация языка ECMAScript, глава 15 часть 5.4.11 String.prototype.replace.

      Модели FormatМодели Callablematch_resultsBidiIter>, OutputIterator, regex_constants::match_flag_type>, эта функция возвращает fmt(*this, out, flags).

      Format, эта функция возвращает fmt(*this, out).

      FormatМодели FormatМодели Callable<match_results, эта функция возвращает std(x.begin(), x.end
    16. templatetypename OutputIterator>format(char_type const  fmt, regex_constants::match_flag_typeregex_constants::format_default;const

      Это перегруженная функция члена, предусмотренная для удобства. Он отличается от вышеуказанной функции только тем, какие аргументы он принимает.

    17. templatetypename OutputIterator>string_typeFormat,regex_constants::regex_constantsregex_constants::format_defaultconst;62>Если Format модели ForwardRange или является нулевой строкой, эта функция возвращает копию последовательности символов fmt. Для каждого спецификатора формата или последовательности выхода в fmt замените эту последовательность либо символом(ами), который она представляет, либо последовательностью в *этой, к которой она относится. Указанные в flags битмаски определяют, в каком формате распознаются спецификаторы или последовательности выхода. По умолчанию это формат, используемый ECMA-262, спецификация языка ECMAScript, глава 15 часть 5.4.11 String.prototype.replace.

      Модели FormatМодели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели Модели <63

    18. string_typeформат(char_typefmt,regex_constants::match_flag_typeфлаги =regex_constants::format_default;const;

      Это перегруженная функция члена, предусмотренная для удобства. Он отличается от вышеуказанной функции только тем, какие аргументы он принимает.

    19. void swap(match_results< BidiIter > &, что);

      Сменит содержимое двух match_results объектов. Гарантировано не бросать.

      Броски:

      Параметры:

      матч_результаты возражают против замены.

      , с которым

      Постусловия:

      * содержит последовательность сопоставленных субвыражений, которые были в том, что, что содержит последовательность сопоставленных субвыражений, которые были в *это.

    20. templatetypename Arg> match_results< > > > >Arg>const &;
      TODO документ меня


    PrevUpHomeNext

    Статья Struct template match_results раздела The Boost C++ Libraries BoostBook Documentation Subset Reference может быть полезна для разработчиков на c++ и boost.




    Материалы статей собраны из открытых источников, владелец сайта не претендует на авторство. Там где авторство установить не удалось, материал подаётся без имени автора. В случае если Вы считаете, что Ваши права нарушены, пожалуйста, свяжитесь с владельцем сайта.



    :: Главная :: Reference ::


    реклама


    ©KANSoftWare (разработка программного обеспечения, создание программ, создание интерактивных сайтов), 2007
    Top.Mail.Ru

    Время компиляции файла: 2024-08-30 11:47:00
    2025-05-20 07:01:53/0.010895967483521/1