Description

Опциональный генератор используется для условного выполнения встроенного генератора. Это всегда удается.

Header

// forwards to <boost/spirit/home/karma/operator/optional.hpp>
#include <boost/spirit/include/karma_optional.hpp>

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

Model of

Expression Semantics

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

Attributes

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

a: A --> -a: optional<A>
a: Unused --> -a: Unused

	Important
	В таблице выше используется<optional<A>>только в качестве заполнителя.<optional<A>>обозначает тип данных<boost::optional<A>>.

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

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

	Tip
	Самый простой способ заставить необязательный генератор вести себя так, как если бы он делал буферизацию, — это завернуть его в буферную директиву (см.<buffer>).: 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_;

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

boost::optional<double> val(1.0);
test_generator_attr("1.0", -double_, val);
test_generator_attr("2.0", -double_, 2.0);

Использование и результат работы пустого опционального генератора:

boost::optional<double> val;          // empty optional
test_generator_attr("", -double_, val);