класс ara::diag::DiagnosticSovdArrayContentElementDataIterator

Класс ara::diag::DiagnosticSovdArrayContentElementDataIterator служит для пошаговой итерации по элементам массива SOVD в диагностическом содержимом ([SWS_DM_02215], AUTOSAR_AP_SWS_Diagnostics §8.60.4 «Class: DiagnosticSovdArrayContentElementDataIterator»). Он предоставляет операторы для сравнения, перехода вперед с помощью префиксного инкремента, а также разыменования для получения ссылок или указателей на DiagnosticSovdContentElementData ([SWS_DM_02216], [SWS_DM_02220]). Все функции потокобезопасны и специфицированы как noexcept, поэтому корректность целевого диапазона перед разыменованием должна обеспечиваться приложением.

больше ›

Контекст

Класс ara::diag::DiagnosticSovdArrayContentElementDataIterator предоставляет специализированный итератор для элементов массива в рамках диагностической коммуникации на основе SOVD (Service-Oriented Vehicle Diagnostics) ([SWS_DM_02215], AUTOSAR_AP_SWS_Diagnostics §8.60.4 «Class: DiagnosticSovdArrayContentElementDataIterator»). Его основная ответственность заключается в предоставлении стандартизированных интерфейсов итерации для последовательной навигации по элементам массива данных. В качестве партнеров по взаимодействию выступают вызывающие диагностические приложения, а также ссылаемые целевые элементы типа DiagnosticSovdContentElementData ([SWS_DM_02216], [SWS_DM_02217]). Итератор объявлен в заголовочном файле ara/diag/diagnostic_sovd_content_element_data.h (AUTOSAR_AP_SWS_Diagnostics §8.60.4.1 «Public Member Functions»).

Жизненный цикл

Спецификация не определяет для ara::diag::DiagnosticSovdArrayContentElementDataIterator собственных открытых конструкторов; следовательно, экземпляры создаются и предоставляются соответствующими структурами контейнеров SOVD через их методы итератора (интерпретация). Вопрос Q-e1fbf51ab4acc197 (открытый) Сам итератор не владеет базовыми пользовательскими данными, а лишь хранит ссылки на соответствующие элементы в памяти. Таким образом, валидность экземпляра итератора, предположительно, строго привязана к времени жизни и валидности вышестоящей структуры данных (интерпретация). Вопрос Q-c01219664b4adc56 (открытый)

В отношении жизненного цикла и параллелизма все функции-члены специфицированы как безопасные относительно исключений (exception safe) и потокобезопасные (thread-safe) ([SWS_DM_02216], [SWS_DM_02218], [SWS_DM_02219], [SWS_DM_02220]). Это допускает одновременные операции чтения и перехода вперед из нескольких потоков при условии, что базовая структура данных не изменяется деструктивно параллельно.

Путь использования

Стандартный процесс следует типичному паттерну однонаправленных итераторов C++. Приложения сравнивают текущую позицию итератора с конечным итератором с помощью operator!= ([SWS_DM_02219]) или operator== ([SWS_DM_02218], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.5 «operator==»). Если конец еще не достигнут, доступ для чтения к текущему элементу осуществляется либо через разыменование operator* ([SWS_DM_02216]) для возврата ссылки на DiagnosticSovdContentElementData, либо через оператор «стрелка» operator-> ([SWS_DM_02217], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.4 «operator->») для возврата соответствующего указателя. Затем приложение перемещает позицию на следующий элемент массива с помощью префиксного оператора инкремента operator++ ([SWS_DM_02220], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.3 «operator++»).

Диаграмма последовательности: последовательность вызовов во время цикла итерации по элементам массива SOVD. Источники: [SWS_DM_02216], [SWS_DM_02219], [SWS_DM_02220].

Сценарии ошибок

Все методы итератора снабжены спецификацией noexcept и по определению не генерируют исключений ([SWS_DM_02216], [SWS_DM_02217], [SWS_DM_02218], [SWS_DM_02219], [SWS_DM_02220]). Коды ошибок, такие как ara::core::ErrorCode, для этих интерфейсов не предусмотрены. Корректность возлагается на условия вызова приложения: разыменование с помощью operator* или operator-> в качестве обязательного предварительного условия требует, чтобы итератор указывал на действительный элемент массива, а не на конечную позицию; обращение к недействительным итераторам, предположительно, приводит к неопределенному поведению (интерпретация). Вопрос Q-63d87e38f9886f6b (открытый)