Description

Генератор Plus используется для повторения выполнения встроенного генератора один или несколько раз. Успешно, если встроенный генератор был успешно выполнен хотя бы один раз.

Header

// forwards to <boost/spirit/home/karma/operator/plus.hpp>
#include <boost/spirit/include/karma_plus.hpp>

См. такжеВключить структуру.

Model of

Expression Semantics

Семантика выражения определяется только там, где она отличается отUnaryGenerator.

	Note
	Все неисправные итерации встроенного генератора будут потреблять один элемент из поставляемого атрибута. Общий+будет успешным до тех пор, пока по крайней мере один вызов встроенного генератора будет успешным (если основной выходной поток не сообщает об ошибке).

Attributes

См.Составные обозначения атрибутов.

a: A --> +a: vector<A>
a: Unused --> +a: Unused

	Important
	В приведенной выше таблице используетсявектор<A>только в качестве заполнителя. Нотация вектора<A>означаетлюбой контейнер STL, содержащий элементы типаA.

Генератор Plus будет выполнять свой встроенный генератор один раз для каждого элемента в атрибуте предоставленного контейнера, пока встроенный генератор преуспевает. На каждой итерации он будет передавать следующий последовательный элемент из атрибута контейнера встроенному генератору. Поэтому количество итераций не будет больше количества элементов в контейнере, переданных в качестве его атрибута. Пустой контейнер приведет к отказу генератора плюс.

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

Tip

Самый простой способ заставить генератор плюс вести себя так, как если бы он делал буферизацию, - это завернуть его в буферную директиву (см.буфер): buffer[+a] негенерируют какой-либо выход в случае выхода из строя генератора+a. Выражение: +(buffer[a]) Он не будет генерировать какой-либо частичный выход из генератора, если он не генерирует в середине своего выхода. Общее выражение будет по-прежнему генерировать выход, произведенный всеми успешными вызовами генератораa.

Complexity

Example

	Note
	Испытательный ремень для примера (примеров) ниже представлен в разделеОсновные примеры.

Некоторые включают:

#include <boost/spirit/include/karma.hpp>
#include <boost/spirit/include/support_utree.hpp>
#include <boost/spirit/include/phoenix_core.hpp>
#include <boost/spirit/include/phoenix_operator.hpp>
#include <boost/fusion/include/std_pair.hpp>
#include <iostream>
#include <string>

Некоторые используют декларации:

using boost::spirit::karma::double_;
using boost::spirit::karma::space;

Базовое использование генератора плюс:

std::vector<double> v1;
v1.push_back(1.0);
v1.push_back(2.0);
v1.push_back(3.0);
test_generator_attr_delim("1.0 2.0 3.0 ", +double_, space, v1);

Более сложный вариант использования, показывающий, как использовать тот факт, что плюс выходит из строя для пустых контейнеров, переданных в качестве его атрибута:

std::vector<double> v2;               // empty container
test_generator_attr("empty", +double_ | "empty", v2);