класс ara::diag::DiagnosticSovdArrayContentElementDataView

Использование

Функция-член Clear класса ara::diag::DiagnosticSovdArrayContentElementDataView очищает всё содержимое элемента массива SOVD ([SWS_DM_02233]). Вызов предоставляется через заголовочный файл #include "ara/diag/diagnostic_sovd_content_element_data.h". Метод имеет сигнатуру auto Clear () noexcept -> void;. Он работает синхронно, не принимает параметров и не возвращает значения ([SWS_DM_02233]).

Обработка ошибок и граничные условия

Согласно спецификации функция определена как исключебно-безопасная (exception safe) и снабжена спецификатором noexcept ([SWS_DM_02233]). Она не возвращает ни кодов ошибок, ни ara::core::Result. Обязательным требованием является то, что адресуемый DiagnosticSovdContentElementData должен иметь тип ArrayContentElementData ([SWS_DM_02233]). Поскольку ошибки не сигнализируются, соблюдение этого типа классом view, вероятно, обеспечивается уже во время конструирования. Вопрос Q-cdb2385e081c3456 (открытый)

Параллелизм

Спецификация явно классифицирует метод как потокобезопасный (thread-safe) ([SWS_DM_02233]). Поэтому вызовы Clear могут выполняться конкурентно из нескольких потоков без внешней синхронизации.

Взаимодействие в диагностической подсистеме

В структурах данных SOVD эта операция тесно связана с другими методами очистки:

• DiagnosticSovdContentElementData::Clear ([SWS_DM_02338]) представляет собой обобщённый аналог на уровне элементов, однако возвращает ara::core::Result<void> и завершается сбоем, если объект не является массивом.
• DiagnosticSovdRecordContentElementDataView::Clear ([SWS_DM_02276]) берёт на себя аналогичную очистку для структур данных типа RecordContentElementData или ContentData.
• Напротив, в контексте классической памяти неисправностей ara::diag::DTCInformation::Clear ([SWS_DM_00671]) служит для асинхронной очистки UDS-DTC через ara::core::Future.

Использование

Метод Erase класса ara::diag::DiagnosticSovdArrayContentElementDataView служит для удаления элемента из диагностических данных содержимого SOVD ([SWS_DM_02247], SWS Diagnostics §8.60.5.1.1.8 «Erase»). В качестве параметра функция принимает итератор типа DiagnosticSovdArrayContentElementDataIterator, указывающий на удаляемый элемент. Вызов выполняется как синхронная операция; вероятно, это следует из прямого возврата ara::core::Result<void> без асинхронного паттерна Future. Вопрос Q-28de22574e525c78 (открытый)

Обработка ошибок и граничные условия

Функция объявлена с noexcept и обладает свойствами exception safe, а также thread-safe ([SWS_DM_02247]). Если удаление завершается ошибкой, метод возвращает ошибку через возвращаемый ara::core::Result. Это происходит в том случае, если родительский DiagnosticSovdContentElementData не имеет требуемого типа ArrayContentElementData или элемент не удалось удалить по другим причинам ([SWS_DM_02247]).

Взаимодействие

В рамках интерфейса SOVD эта операция соответствует методу удаления Erase базового контейнера данных DiagnosticSovdContentElementData для элементов массива ([SWS_DM_02352]). Для структур записей существуют аналогичные аналоги в виде DiagnosticSovdRecordContentElementDataView::Erase, а также соответствующего метода контейнера ([SWS_DM_02294], [SWS_DM_02374]).

Синхронная функция-член PushBack служит для добавления целочисленного элемента со знаком типа std::int64_t к структуре массива элементов содержимого диагностики SOVD ([SWS_DM_02241], AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.14 «PushBack»). Она объявлена в заголовочном файле ara/diag/diagnostic_sovd_content_element_data.h и определена как noexcept ([SWS_DM_02241]).

Для успешного вызова действуют следующие предварительные условия и требования к интерфейсу:

• Контекст вызова и предварительные условия: целевой объект класса ara::diag::DiagnosticSovdArrayContentElementDataView должен представлять ArrayContentElementData, а добавляемый примитивный тип должен соответствовать типу элементов, определенному в конструкторе ([SWS_DM_02241]).
• Возвращаемое значение и обработка ошибок: функция возвращает ara::core::Result<void>. Если проверка завершается неудачно из-за того, что базовый элемент не относится к типу ArrayContentElementData, результат содержит ошибку ([SWS_DM_02241]). Интерпретация: несоответствие типу данных, заданному в конструкторе, вероятно, аналогично возвращается как ошибка в объекте результата. Вопрос Q-d4715ecbd0f12d26 (открытый)
• Параллелизм: функция специфицирована как thread-safe и exception-safe ([SWS_DM_02241]).

Метод входит в семейство типизированных перегрузок внутри DiagnosticSovdArrayContentElementDataView для беззнаковых целых чисел ([SWS_DM_02242]), чисел с плавающей запятой ([SWS_DM_02243]), логических значений ([SWS_DM_02244]), строк ([SWS_DM_02245]) и полных элементов данных ([SWS_DM_02246]). Соответствующие методы существуют также на самом классе данных DiagnosticSovdContentElementData ([SWS_DM_02346]).

Использование

Синхронная API-функция PushBack класса ara::diag::DiagnosticSovdArrayContentElementDataView добавляет 64-битное целочисленное значение без знака (std::uint64_t) в качестве примитивного элемента данных в конец существующего элемента массива SOVD [SWS_DM_02242]. Подключение выполняется через заголовочный файл ara/diag/diagnostic_sovd_content_element_data.h SWS Diagnostics §8.60.5.1.1.15 «PushBack». Условием успешного вызова является то, что текущий элемент представляет собой ArrayContentElementData, а добавляемое значение соответствует типу элементов, определенному в конструкторе [SWS_DM_02242].

Обработка ошибок и параллелизм

Функция сигнализирует о своем статусе выполнения через ara::core::Result<void> [SWS_DM_02242]. Если целевой объект не имеет типа ArrayContentElementData, функция возвращает ошибку в результате [SWS_DM_02242]. Поскольку конкретные коды ошибок не названы (интерпретация: ошибочные состояния обобщенно сигнализируются через Result), вызывающая сторона должна анализировать объект Result. Вопрос Q-95f2dd96e2681368 (открытый) Метод объявлен как noexcept, гарантирует безопасность исключений и явно специфицирован как потокобезопасный [SWS_DM_02242].

Взаимодействие

Операция относится к семейству типоспецифических перегрузок внутри DiagnosticSovdArrayContentElementDataView, которые аналогично обрабатывают целые числа со знаком через std::int64_t [SWS_DM_02241], числа с плавающей запятой через double [SWS_DM_02243], логические значения через bool [SWS_DM_02244], строки через ara::core::StringView [SWS_DM_02245] или структурированные элементы типа DiagnosticSovdContentElementData [SWS_DM_02246]. Однотипная реализация для std::uint64_t дополнительно предоставляется DiagnosticSovdContentElementData [SWS_DM_02347].

Использование

Синхронный метод PushBack предоставляется через заголовочный файл #include "ara/diag/diagnostic_sovd_content_element_data.h" в области видимости класса ara::diag::DiagnosticSovdArrayContentElementDataView ([SWS_DM_02243], AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.13 «PushBack»). Он присоединяет примитивное значение с плавающей запятой типа double в качестве элемента содержимого к существующему массиву ([SWS_DM_02243]). Единственным входным параметром являются добавляемые данные content_element.

Обработка ошибок и граничные условия

Функция возвращает ara::core::Result<void> ([SWS_DM_02243]). Успешное выполнение требует, чтобы текущий элемент был типа ArrayContentElementData, а добавляемый элемент соответствовал типу, определенному в конструкторе ArrayContentElementData ([SWS_DM_02243]). Если цель не имеет типа ArrayContentElementData, операция завершается неудачно и возвращает ошибку в Result ([SWS_DM_02243]).

Параллелизм

Функция объявлена как noexcept, обеспечивает безопасность исключений (exception safe) и согласно спецификации является thread-safe ([SWS_DM_02243]). Поэтому несколько потоков могут вызывать функцию параллельно без внешней синхронизации.

Взаимодействие

Внутри DiagnosticSovdArrayContentElementDataView существуют перегрузки для других примитивных типов данных с аналогичными типами, в том числе std::int64_t ([SWS_DM_02241]), std::uint64_t ([SWS_DM_02242]), bool ([SWS_DM_02244]), ara::core::StringView ([SWS_DM_02245]), а также для полных объектов DiagnosticSovdContentElementData ([SWS_DM_02246]). Аналогичные методы доступны также на DiagnosticSovdContentElementData (например, [SWS_DM_02348]).

Функция-член PushBack служит для добавления DiagnosticSovdContentElementData с примитивным типом данных bool к существующему элементу массива ([SWS_DM_02244]). Интерфейс определен в заголовочном файле ara/diag/diagnostic_sovd_content_element_data.h внутри класса ara::diag::DiagnosticSovdArrayContentElementDataView (AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.12 «PushBack»). В качестве входного параметра синхронная функция принимает логическое значение content_element ([SWS_DM_02244]).

Условием для вызова является то, что текущий элемент имеет тип ArrayContentElementData, а добавляемое значение совпадает с типом, который был объявлен в конструкторе структуры данных ([SWS_DM_02244]). Если целевой элемент не относится к типу ArrayContentElementData, операция завершается неудачно и возвращает ara::core::Result<void> с соответствующей ошибкой; в случае успеха результат содержит пустой void ([SWS_DM_02244]).

Что касается надежности выполнения, метод объявлен как noexcept, а также специфицирован как потокобезопасный (thread-safe) и исключебно-безопасный (exception safe) ([SWS_DM_02244]).

Метод входит в состав семейства типизированных перегрузок PushBack внутри DiagnosticSovdArrayContentElementDataView. Помимо логических значений родственные функции охватывают вставку целочисленных типов, таких как std::int64_t ([SWS_DM_02241]) и std::uint64_t ([SWS_DM_02242]), значений с плавающей запятой double ([SWS_DM_02243]), строк ara::core::StringView ([SWS_DM_02245]), а также сложных элементов данных ([SWS_DM_02246]). Соответствующие операции доступны также на уровне DiagnosticSovdContentElementData, включая логический вариант [SWS_DM_02349].

Использование

Синхронная функция-член PushBack класса ara::diag::DiagnosticSovdArrayContentElementDataView ([SWS_DM_02245], определённая в SWS Diagnostics §8.60.5.1.1.11 «PushBack») добавляет новый элемент примитивного типа «строка» в диагностический массив SOVD. Для этого должен быть подключён заголовочный файл ara/diag/diagnostic_sovd_content_element_data.h. Функция принимает добавляемый элемент через параметр content_element типа ara::core::StringView.

Обработка ошибок

В качестве типа возвращаемого значения служит ara::core::Result<void>. Ошибка возвращается в объекте результата, если текущий объект не имеет тип ArrayContentElementData или тип переданного элемента не совпадает с типом элемента, заданным в конструкторе ArrayContentElementData ([SWS_DM_02245]).

Параллелизм и ограничения

Функция объявлена со спецификатором noexcept. Она обеспечивает гарантированную безопасность исключений (exception safe) и специфицирована как безоговорочно потокобезопасная (thread-safe) ([SWS_DM_02245]).

Взаимодействие

Операция является частью семейства перегруженных методов. Внутри DiagnosticSovdArrayContentElementDataView существуют другие перегрузки для скалярных типов, таких как std::int64_t ([SWS_DM_02241]), std::uint64_t ([SWS_DM_02242]), double ([SWS_DM_02243]) и bool ([SWS_DM_02244]), а также для полных элементов типа DiagnosticSovdContentElementData ([SWS_DM_02246]). Кроме того, класс ara::diag::DiagnosticSovdContentElementData также предоставляет соответствующий интерфейс PushBack для строк ([SWS_DM_02350]).

Использование

Синхронная функция-член PushBack класса ara::diag::DiagnosticSovdArrayContentElementDataView (SWS Diagnostics §8.60.5.1.1.10 «PushBack») присоединяет элемент типа DiagnosticSovdContentElementData к существующему представлению данных массива ([SWS_DM_02246]). В качестве входного параметра она принимает добавляемый объект content_element по значению и не имеет возвращаемого значения (void). Объявление предоставляется через заголовочный файл ara/diag/diagnostic_sovd_content_element_data.h.

Параллелизм и предварительные условия

Спецификация определяет функцию как исключебно-безопасную (exception safe), потокобезопасную (thread-safe) и аннотированную с noexcept ([SWS_DM_02246]). В качестве обязательного предварительного условия операция требует, чтобы текущий элемент был типа ArrayContentElementData, а присоединяемый элемент в точности соответствовал типу, заданному в конструкторе ArrayContentElementData ([SWS_DM_02246]).

Обработка ошибок и взаимодействие

В отличие от перегрузок для примитивных типов, таких как std::int64_t ([SWS_DM_02241]), std::uint64_t ([SWS_DM_02242]), double ([SWS_DM_02243]), bool ([SWS_DM_02244]) или ara::core::StringView ([SWS_DM_02245]), которые возвращают ara::core::Result<void> для передачи ошибок, этот метод возвращает void. Поэтому, вероятно, на вызывающей стороне лежит ответственность за предварительную проверку совместимости типов, так как ошибки времени выполнения на этом интерфейсе не сигнализируются через тип Result. Вопрос Q-00739dff7d34e242 (открытый) Эквивалентный метод для присоединения элементов данных определен также на DiagnosticSovdContentElementData ([SWS_DM_02351]).

Синхронный метод Reserve класса ara::diag::DiagnosticSovdArrayContentElementDataView служит для предварительного выделения емкости памяти для элементов данных массива ([SWS_DM_02240], SWS Diagnostics §8.60.5.1.1.16 «Reserve»). Он предоставляется через заголовочный файл #include "ara/diag/diagnostic_sovd_content_element_data.h" и принимает параметр capacity типа std::size_t, определяющий предоставляемую емкость базового DiagnosticSovdArrayContentElementData ([SWS_DM_02240]). Возвращаемое значение не возвращается ([SWS_DM_02240]).

Что касается обработки ошибок, функция объявлена как исключебно-безопасная (exception safe), а также noexcept ([SWS_DM_02240]). Она не использует ни кодов ошибок через ara::core::Result, ни исключений C++. Интерпретация: при нехватке памяти выделение, вероятно, завершается сбоем внутри или приводит к аварийному завершению программы, поскольку вызывающей стороне недоступен канал передачи ошибок. Вопрос Q-348805197c004eea (открытый)

С точки зрения параллелизма операция явно специфицирована как потокобезопасная (thread-safe) ([SWS_DM_02240]). Таким образом, вызовы могут выполняться из параллельных потоков без внешней блокировки.

В общей системе интерфейс дополняет связанные функции резервирования: в то время как DiagnosticSovdRecordContentElementDataView::Reserve аналогично отвечает за структуры данных Record ([SWS_DM_02283], SWS Diagnostics §8.60.11.1.1.20 «Reserve»), общая функция базового класса DiagnosticSovdContentElementData::Reserve возвращает ara::core::Result<void>, чтобы сообщить об ошибке в случае неверного типа элемента ([SWS_DM_02345], SWS Diagnostics §8.60.6.1.2.55 «Reserve»). В отличие от непотокобезопасного резервирования памяти DiagnosticServiceDynamicAccessList::Reserve ([SWS_DM_01163], SWS Diagnostics §8.13.1.1.3.3 «Reserve»), этот view-метод работает напрямую и конкурентно над элементами массива SOVD.