ru:toolworks:docs:apparatus:operating [Turbopedia]

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

Более новый и функциональный способ оперировать над Цепями через процесс, называемый //оперирование// (operating).

===== Организация в C++  =====

==== Использование лямбда-выражений ====

Можно легко оперировать над Цепями через C++ лямбды и вот как следует это делать:
<code cpp>
Chain->Operate([](FMyTrait Trait)
{
    ...
});
</code>

Обратите внимание, что вам не позволяется получать ссылку на трейт, если вы итерируетесь по не-твердотельной цепи, - разрешено только копирование.
Итак, оперировать над твердотельной Цепью вам следует следующим образом:
<code cpp>
SolidChain->Operate([](FMyTrait& Trait)
{
    ...
});
</code>

Теперь можете менять свойства (поля) трейта напрямую, без привлечения копирования.

==== Параллельность ====

Твердотельные цепи также поддерживают специальный тип оперирования - мультипоточный.
К названию функции, которую надо вызвать, по такому случаю подписали ''Concurrently'', и она принимает ещё два аргумента: 
  * максимальное количество потоков, выделенных на выполнение задачи, и 
  * минимальное число слотов на каждый поток. 
Например:

<code cpp>
SolidChain->OperateConcurrently([](FMyTrait& Trait)
{
    ...
}, 4, 32);
</code>

Второй параметр помогает ограничить количество потоков. Если слишком мало доступных слотов, излишние потоки не понадобятся и они не будут помещены в очередь.

==== Доставка аргументов ====

Хорошая особенность оперирования - это то, что аргументы функции решаются и доставляются автоматически в вашу логику.
Например, если вы также модифицировали текущую сущность итерирования, то просто укажите хэндлер в самом начале кода:
<code cpp>
Chain->Operate([](FSubjectHandle Subject, FMyTrait Trait)
{
    ...
});
</code>
Это, конечно, должно соответствовать твердотельности цепи. Для твердотельной цепи код выглядит так:
<code cpp>
SolidChain->Operate([](FSolidSubjectHandle Subject, FMyTrait& Trait)
{
    ...
});
</code>

Вы можете запрашивать разную информацию контекста внутри цикла. Например:
<code cpp>
Chain->Operate([](const FChain* Chain, const FChainCursor& Cursor, ISubjective* Subjective, FMyTrait Trait, UMyDetail* Detail)
{
    ...
});
</code>

==== Индекс текущей итерации ====

В случае, если надо получить номер текущего Слота в итерации (т.е. место сущности в цепи), используйте выделенный [[appi>struct_t_chain_1_1_f_cursor.html#a18005eddb3a624bdabb76475c3863751|GetChainSlotIndex()]] метод соответствующего типа курсора. Курсор можно получить так же, как было представлено в [[#доставка_аргументов|предыдущей секции]]:<code cpp>
SolidChain->Operate([](FPlacementTrait& Placement, const FSolidChainCursor& Cursor)
{
	Placement.Number = Cursor.GetChainSlotIndex();
});
</code>

==== Остановка ====

Хотя и непонятно, зачем вдруг понадобится останавливать процесс итерирования над цепью вручную, но этого легко достичь при помощи выделенного [[appi>struct_t_chain.html#aec97fe73be3d6d9f4c279c7427ed99d6|метода]].

Например:
<code cpp>
int32 Counter = 0;
Chain->Operate([&Counter](const FChain* Chain, FMyTrait Trait)
{
    if (Counter > 100)
    {
        Chain->StopIterating();
        // Досрочно возвращаем управление, чтобы не инкрементировать счётчик:
        return;
    }
    Counter += Trait.Value;
});
</code>