Description

Все компоненты генератора (кромеАльтернативного (<|>)генератора) передают генерируемый ими выход непосредственно в основной выходной поток. Если генератор выходит из строя на полпути, выход, генерируемый до сих пор, не откатывается назад. Директива буферного генератора позволяет избежать этого нежелательного вывода. Он временно перенаправляет выход, производимый встроенным генератором, в буфер. Этот буфер смывается в основной поток только после того, как встроенный генератор преуспел, но отбрасывается в противном случае.

Header

// forwards to <boost/spirit/home/karma/directive/buffer.hpp>
#include <boost/spirit/include/karma_buffer.hpp>

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

Model of

Expression Semantics

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

	Tip
	Если вы хотите добиться успеха буферизованного генератора независимо от результата встроенного генератора, просто заверните<buffer[a]>в дополнительную опцию:<-buffer[a]>(см.Факультативная<->).

Attributes

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

a: A --> buffer[a]: A
a: Unused --> buffer[a]: Unused

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::buffer;

Основное использование директивы буферного генератора. Он показывает, как частичный выход, генерируемый в первом примере, не отображается в генерируемом выходе, поскольку генератор плюс выходит из строя (нет данных, см.Plus (унитарный<+>)).

std::vector<double> v;                // empty container
test_generator_attr("", -buffer['[' << +double_ << ']'], v);
v.push_back(1.0);                     // now, fill the container
v.push_back(2.0);
test_generator_attr("[1.02.0]", buffer['[' << +double_ << ']'], v);