Get the Iterator pointing to the End of a Container Attribute . Boost , Spirit 2.5.2 , Extract Attribute Values to Generate Output from a Container (Karma)

Get the Iterator pointing to the End of a Container Attribute

end_container

Шаблон end_container представляет собой тип, используемый в качестве точки настройки атрибута. Он вызывается повторяющимися генераторами Karma (такими как List (%), Kleene (универсал *), Plus (универсал +), и Repeat) для того, чтобы получить итератор, указывающий на конец контейнера, удерживающего атрибуты для генерации вывода.

Module Headers

#include <boost/spirit/home/support/container.hpp>

Кроме того, см. Включить структуру .

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

Namespace

Имя
`boost::spirit::traits`

Synopsis

template <typename Container, typename Enable>
struct end_container
{
    static typename container_iterator<Container>::type
    call(Container& c);
};

Template parameters

Параметр	Описание	По умолчанию
`Контейнер`	Тип, `Контейнер` , для которого итератор, указывающий на первый элемент, должен быть возвращен	нет
`Включить`	Параметр шаблона помощника, используемый для выборочного включения или отключения определенных специализаций `end_container` с использованием SFINAE (т.е. `boost::enable_if` или `boost::disable_if`).	`void`

Notation

C: Тип контейнера, для которого должен быть возвращен конечный итератор.
c: Пример контейнера, C.

Expression Semantics

Выражение

Семантика

end_container<C>::call(c>

Возврат итератора, пригодного для сравнения с другим итератором, чтобы определить, достиг ли другой итератор конца данного контейнера, c. Тип возвращаемого итератора, как ожидается, будет таким же, как тип, возвращаемый точкой настройки признаков ::container_iterator.

Predefined Specializations

Spirit предопределяет специализацию этой точки настройки для нескольких типов. В следующей таблице перечислены эти типы вместе с типами, возвращаемыми встроенным typedef type:

Параметры шаблонов	Семантика
`C`	Возврат `c.end()`.
`C const`	Возврат `c.end()`.
`unused_type`	Возврат `& неиспользованный` .

When to implement

Точка настройки end_container должна быть реализована для конкретного типа, когда этот тип должен использоваться в качестве атрибута вместо контейнера STL. Он применим только для генераторов (Spirit.Karma). Как правило, он должен быть реализован всякий раз, когда определенный тип должен быть передан в качестве атрибута генератора, обычно обнажающего STL-контейнер, C и если тип не обнажает интерфейс STL-контейнера (т.е. is_container<C>::type обычно возвращает mpl::false_).

Related Attribute Customization Points

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

Имя	Когда внедрять
`черты::is_container`	Необходимо реализовать всякий раз, когда тип используется в качестве атрибута контейнера в Karma.
`черты::контейнер_итер`	Карма: Список (`%`), Клин (единственный `*`), Плюс (единственный `+`), Повторите.
`признаков::begin_tainer`	Карма: Список (`%`), Клин (единственный `*`), Плюс (единственный `+`), Повторите.
`черты::контейнер`	Карма: Список (`%`), Клин (единственный `*`), Плюс (единственный `+`), Повторите.
`черты::deref_iterator`	Карма: Список (`%`), Клин (единственный `*`), Плюс (единственный `+`), Повторите.
`черты::next_iterator`	Карма: Список (`%`), Клин (единственный `*`), Плюс (единственный `+`), Повторите.
`черты::сравните_итераторы`	Карма: Список (`%`), Клин (единственный `*`), Плюс (единственный `+`), Повторите.

Example

Примеры использования точки настройки end_container см. здесь: embedded_container_example, use_as_container и counter_example.