Description

Генераторы струн, описанные в этом разделе:

Генератор<string>излучает строку символов. Генератор<string>неявно дословно:<delimit>парсер не применяется между символами строки.<string>Генератор имеет ассоциированныйКодирование символов пространства имен. Это необходимо при выполнении основных операций, таких как принуждение нижнего или верхнего корпуса. Примеры:

string("Hello")
string(L"Hello")
string(s)         // s is a std::string

<lit>, как<string>, также излучает строку символов. Главное отличие состоит в том, что<lit>не потребляет атрибут. При этом, например,<"hello">или<std::basic_string>,<lit>. Примеры:

"Hello"
lit("Hello")
lit(L"Hello")
lit(s)            // s is a std::string

Header

// forwards to <boost/spirit/home/karma/string/lit.hpp>
#include <boost/spirit/include/karma_string.hpp>

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

Namespace

В приведенной выше таблице<ns>представленоПространство имен символов, используемое соответствующим генератором строк.

Model of

Expression Semantics

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

	Note
	Генераторы<lit(s)>и<string(s)>могут быть инициализированы либо с использованием строкового буквального значения (то есть<"abc">), либо с использованием<std::basic_string<char_type, ...>>, где<char_type>является требуемым типом значения базовой последовательности символов.

	Caution
	Генератор<string(s)>до версии 2.4.1 Spirit имеет недокументированную особенность.<s>—<s>,<s>,<s>,<s>,<s>,<s>,<s>. Эта проблема была исправлена в Spirit V2.4.2.

Attributes

	Note
	В дополнение к их обычному атрибуту типа<S>все перечисленные генераторы также принимают экземпляр<boost::optional<S>>. Если<boost::optional<>>инициализируется (имеет значение), генераторы ведут себя так, как если бы их атрибут был экземпляром<S>и испускают значение, сохраненное в<boost::optional<>>. В противном случае генераторы не сработают.

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::lit;
using boost::spirit::ascii::string;

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

test_generator("abc", "abc");
test_generator("abc", lit("abc"));
test_generator("abc", lit(std::string("abc")));
test_generator_attr("abc", string, "abc");
test_generator("abc", string("abc"));
test_generator("abc", string(std::string("abc")));
test_generator_attr("abc", string("abc"), "abc");
test_generator_attr("", string("abc"), "cba");     // fails (as "abc" != "cba")