Description

Класс<symbols>реализует «обратную» таблицу символов: ассоциативный контейнер (или карту) пар ключевых значений, где значения являются (большинство времени) строками. Он отображает генерируемое значение (ключ) на любое другое значение, которое будет испущено вместо исходного ключа.

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

Header

// forwards to <boost/spirit/home/karma/string/symbols.hpp>
#include <boost/spirit/include/karma_symbols.hpp>

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

Namespace

Synopsis

template <typename Attrib, typename T, typename Lookup
  , typename CharEncoding, typename Tag>
struct symbols;

Template parameters

Model of

Expression Semantics

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

Генератор символов использует поставляемый атрибут в качестве ключа для поиска во внутреннем ассоциативном контейнере. Если ключ существует, генератор испускает связанное значение и преуспевает (если основной выходной поток не сообщает об ошибке). Если тип значения, хранящийся в генераторе символов<unused_type>, будет излучать ключ. Если ключа не существует, генератор выходит из строя, ничего не испуская.

Attributes

Атрибут<symbol<Attrib,T>>—<Attrib>.

Если поставляемый атрибут является последовательностьюBoost.Fusion, то генератор таблицы символов будет использовать первый элемент этой последовательностиBoost.Fusionв качестве ключа для поиска. Тип этого первого элемента должен быть конвертируемым в<Attrib>. В этом случае второй элемент последовательностиBoost.Fusionиспользуется в качестве атрибута при вызове генератора, полученного из значения, хранящегося в таблице символов для найденной записи.

Если поставляемым атрибутом является тип контейнера (<traits::is_container>разрешает<mpl::true_>), то генератор таблицы символов будет использовать первый элемент, хранящийся в этом контейнере, в качестве ключа для поиска.<value_type>(возвращается<traits::container_value>) должен быть конвертируемым в<Attrib>. В этом случае второй элемент, хранящийся в этом контейнере, используется в качестве атрибута при вызове генератора, полученного из значения, хранящегося в таблице символов для найденной записи.

Если поставляемый атрибут не является последовательностьюBoost.Fusionи не является типом контейнера, поставляемый атрибут непосредственно используется в качестве ключа для поиска элемента. Атрибут используется в качестве атрибута при вызове генератора, полученного из значения, хранящегося в таблице символов для найденной записи.

В любом случае, поскольку поставляемый ключ (т.е. либо первый элемент последовательностиBoost.Fusion, первый элемент контейнера, или атрибут иным образом) передается в качестве атрибута генератору, полученному из значения, хранящегося в таблице символов для найденной записи, таблица символов может хранить генераторы, которые будут производить выход на основе этого значения. Например:

// The symbol table maps a single character key to a rule<>
// The rule<> exposes an attribute of char as well
rule<output_iterator_type, char()> r1 = char_;
symbols<char, rule<output_iterator_type, char()> > sym;
sym.add
    ('j', r1.alias())
    ('h', r1.alias())
    ('t', r1.alias())
    ('k', r1.alias())
;
// Supplying a fusion vector as the attribute will use the first element
// (the 'j') as the key to be looked up, while the second element (the 'J') 
// is passed on as the attribute to the rule<> stored in the symbol table. 
// Consequently, the example generates a single 'J'.
BOOST_ASSERT(test("J", sym, make_vector('j', 'J')));

Complexity

Реализация по умолчанию использует<std::map<>>или<std::set<>>со сложностью:

где n - количество хранимых символов.

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

Использование генераторов<symbol>:

symbols<char, char const*> sym;
sym.add
    ('a', "Apple")
    ('b', "Banana")
    ('o', "Orange")
;
test_generator_attr("Banana", sym, 'b');