classe ara::diag::DiagnosticSovdArrayContentElementDataView

Utilisation

La fonction membre Clear de la classe ara::diag::DiagnosticSovdArrayContentElementDataView vide l'intégralité du contenu d'un élément de tableau SOVD ([SWS_DM_02233]). L'appel est mis à disposition via l'en-tête #include "ara/diag/diagnostic_sovd_content_element_data.h". La méthode possède la signature auto Clear () noexcept -> void;. Elle fonctionne de manière synchrone, ne prend aucun paramètre et ne fournit aucune valeur de retour ([SWS_DM_02233]).

Gestion des erreurs et conditions limites

Conformément à la spécification, la fonction est définie comme sûre vis-à-vis des exceptions (exception safe) et dotée du spécificateur noexcept ([SWS_DM_02233]). Elle ne renvoie ni codes d'erreur ni ara::core::Result. Une exigence contraignante stipule que le DiagnosticSovdContentElementData référencé doit être de type ArrayContentElementData ([SWS_DM_02233]). Comme aucune erreur n'est signalée, le respect de ce type devrait déjà être garanti dès la construction par la classe de vue. Question Q-cdb2385e081c3456 (ouverte)

concurrence

La spécification classe expressément la méthode comme sûre pour les threads (thread-safe) ([SWS_DM_02233]). Les appels de Clear peuvent donc s'effectuer de manière concurrente depuis plusieurs threads sans synchronisation externe.

Interaction au sein du sous-système de diagnostic

Au sein des structures de données SOVD, l'opération est étroitement liée à d'autres méthodes de suppression :

• DiagnosticSovdContentElementData::Clear ([SWS_DM_02338]) forme le pendant générique au niveau des éléments, mais renvoie un ara::core::Result<void> et échoue si l'objet ne représente pas un tableau.
• DiagnosticSovdRecordContentElementDataView::Clear ([SWS_DM_02276]) prend en charge le nettoyage analogue pour les structures de données de type RecordContentElementData ou ContentData.
• Dans le contexte classique de la mémoire de défauts, ara::diag::DTCInformation::Clear ([SWS_DM_00671]) sert en revanche au nettoyage asynchrone des DTC UDS via ara::core::Future.

Utilisation

La méthode Erase de la classe ara::diag::DiagnosticSovdArrayContentElementDataView sert à supprimer un élément de données de contenu SOVD de diagnostic ([SWS_DM_02247], SWS Diagnostics §8.60.5.1.1.8 « Erase »). La fonction prend en paramètre un itérateur de type DiagnosticSovdArrayContentElementDataIterator qui référence l'élément à supprimer. L'appel s'effectue en tant qu'opération synchrone ; cela devrait résulter du retour direct de ara::core::Result<void> sans patron Future asynchrone. Question Q-28de22574e525c78 (ouverte)

Gestion des erreurs et conditions limites

La fonction est déclarée avec noexcept et possède les propriétés exception safe ainsi que thread-safe ([SWS_DM_02247]). Si la suppression échoue, la méthode renvoie une erreur via le ara::core::Result retourné. C'est le cas lorsque le DiagnosticSovdContentElementData parent n'est pas du type requis ArrayContentElementData ou que l'élément n'a pas pu être supprimé pour d'autres raisons ([SWS_DM_02247]).

Interaction

Au sein de l'interface SOVD, cette opération correspond à la méthode de suppression Erase du conteneur de données sous-jacent DiagnosticSovdContentElementData pour les éléments de tableau ([SWS_DM_02352]). Pour les structures de type record, il existe des équivalents analogues avec DiagnosticSovdRecordContentElementDataView::Erase ainsi que la méthode de conteneur correspondante ([SWS_DM_02294], [SWS_DM_02374]).

La fonction membre synchrone PushBack sert à ajouter un élément entier signé de type std::int64_t à une structure de tableau d'éléments de contenu SOVD de diagnostic ([SWS_DM_02241], AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.14 « PushBack »). Elle est déclarée dans le fichier d'en-tête ara/diag/diagnostic_sovd_content_element_data.h et définie comme noexcept ([SWS_DM_02241]).

Les préconditions et exigences d'interface suivantes s'appliquent à un appel réussi :

• Contexte d'appel et préconditions : l'objet cible de la classe ara::diag::DiagnosticSovdArrayContentElementDataView doit représenter un ArrayContentElementData, et le type primitif à ajouter doit correspondre au type d'élément défini dans le constructeur ([SWS_DM_02241]).
• Valeur de retour et gestion des erreurs : la fonction renvoie un ara::core::Result<void>. Si la vérification échoue parce que l'élément sous-jacent n'est pas de type ArrayContentElementData, le résultat contient une erreur ([SWS_DM_02241]). Interprétation : un écart par rapport au type de données prédéfini dans le constructeur devrait être signalé de manière analogue comme une erreur dans l'objet de résultat. Question Q-d4715ecbd0f12d26 (ouverte)
• Concurrence : la fonction est spécifiée comme thread-safe ainsi qu'exception-safe ([SWS_DM_02241]).

La méthode fait partie d'une famille de surcharges typées au sein de DiagnosticSovdArrayContentElementDataView pour les entiers non signés ([SWS_DM_02242]), les nombres à virgule flottante ([SWS_DM_02243]), les valeurs booléennes ([SWS_DM_02244]), les chaînes de caractères ([SWS_DM_02245]) et les éléments de données complets ([SWS_DM_02246]). Des méthodes correspondantes existent également sur la classe de données DiagnosticSovdContentElementData elle-même ([SWS_DM_02346]).

Utilisation

La fonction API synchrone PushBack de la classe ara::diag::DiagnosticSovdArrayContentElementDataView ajoute une valeur entière 64 bits non signée (std::uint64_t) en tant qu'élément de données primitif à la fin d'un élément de tableau SOVD existant [SWS_DM_02242]. L'intégration s'effectue via le fichier d'en-tête ara/diag/diagnostic_sovd_content_element_data.h SWS Diagnostics §8.60.5.1.1.15 « PushBack ». La condition préalable à la réussite de l'appel est que l'élément courant représente un ArrayContentElementData et que la valeur à ajouter corresponde au type d'élément défini dans le constructeur [SWS_DM_02242].

Gestion des erreurs et concurrence

La fonction signale son état d'exécution via ara::core::Result<void> [SWS_DM_02242]. Si l'objet cible n'est pas de type ArrayContentElementData, la fonction renvoie une erreur dans le résultat [SWS_DM_02242]. Étant donné qu'aucun code d'erreur spécifique n'est mentionné (interprétation : les états d'erreur sont signalés de manière générique par le Result), l'appelant doit évaluer l'objet Result. Question Q-95f2dd96e2681368 (ouverte) La méthode est déclarée comme noexcept, garantit la sécurité vis-à-vis des exceptions et est explicitement spécifiée comme sûre pour les threads [SWS_DM_02242].

Interaction

L'opération appartient à une famille de surcharges spécifiques au type au sein de DiagnosticSovdArrayContentElementDataView, qui traitent de façon analogue des entiers signés via std::int64_t [SWS_DM_02241], des nombres à virgule flottante via double [SWS_DM_02243], des valeurs booléennes via bool [SWS_DM_02244], des chaînes de caractères via ara::core::StringView [SWS_DM_02245] ou des éléments structurés de type DiagnosticSovdContentElementData [SWS_DM_02246]. Une implémentation similaire pour std::uint64_t est également fournie par DiagnosticSovdContentElementData [SWS_DM_02347].

Utilisation

La méthode synchrone PushBack est fournie via le fichier d'en-tête #include "ara/diag/diagnostic_sovd_content_element_data.h" dans la portée de la classe ara::diag::DiagnosticSovdArrayContentElementDataView ([SWS_DM_02243], AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.13 « PushBack »). Elle ajoute une valeur primitive à virgule flottante de type double en tant qu'élément de contenu à un tableau existant ([SWS_DM_02243]). L'unique paramètre de transmission est la donnée à ajouter content_element.

Gestion des erreurs et conditions limites

La fonction renvoie un ara::core::Result<void> ([SWS_DM_02243]). Une exécution réussie suppose que l'élément actuel soit de type ArrayContentElementData et que l'élément à ajouter corresponde au type défini dans le constructeur de ArrayContentElementData ([SWS_DM_02243]). Pour autant que la cible ne soit pas de type ArrayContentElementData, l'opération échoue et renvoie une erreur dans le Result ([SWS_DM_02243]).

concurrence

La fonction est déclarée comme noexcept, garantit la sécurité vis-à-vis des exceptions (exception safe) et est, selon la spécification, thread-safe ([SWS_DM_02243]). Plusieurs threads peuvent donc appeler la fonction de manière concurrente sans synchronisation externe.

Interaction

Au sein de DiagnosticSovdArrayContentElementDataView, il existe des surcharges de même type pour d'autres types de données primitifs, parmi lesquels std::int64_t ([SWS_DM_02241]), std::uint64_t ([SWS_DM_02242]), bool ([SWS_DM_02244]), ara::core::StringView ([SWS_DM_02245]) ainsi que pour des objets DiagnosticSovdContentElementData complets ([SWS_DM_02246]). Des méthodes analogues sont également disponibles sur DiagnosticSovdContentElementData (par ex. [SWS_DM_02348]).

La fonction membre PushBack sert à ajouter un DiagnosticSovdContentElementData avec le type de données primitif bool à un élément de tableau existant ([SWS_DM_02244]). L'interface est définie dans l'en-tête ara/diag/diagnostic_sovd_content_element_data.h au sein de la classe ara::diag::DiagnosticSovdArrayContentElementDataView (AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.12 « PushBack »). En tant que paramètre d'entrée, la fonction synchrone reçoit la valeur booléenne content_element ([SWS_DM_02244]).

La condition préalable à l'appel est que l'élément actuel soit de type ArrayContentElementData et que la valeur à ajouter concorde avec le type déclaré dans le constructeur de la structure de données ([SWS_DM_02244]). Si l'élément cible n'est pas de type ArrayContentElementData, l'opération échoue et renvoie un ara::core::Result<void> contenant une erreur correspondante ; en cas de succès, le résultat contient un void vide ([SWS_DM_02244]).

Concernant la sécurité d'exécution, la méthode est déclarée comme noexcept et spécifiée comme sûre pour les threads (thread-safe) et sans danger au niveau des exceptions (exception safe) ([SWS_DM_02244]).

La méthode fait partie d'une famille de surcharges PushBack typées au sein de DiagnosticSovdArrayContentElementDataView. En plus des valeurs booléennes, des fonctions sœurs couvrent l'insertion de types entiers tels que std::int64_t ([SWS_DM_02241]) et std::uint64_t ([SWS_DM_02242]), de valeurs à virgule flottante double ([SWS_DM_02243]), de chaînes de caractères ara::core::StringView ([SWS_DM_02245]) ainsi que d'éléments de données complexes ([SWS_DM_02246]). Des opérations correspondantes sont en outre disponibles au niveau de DiagnosticSovdContentElementData, notamment la variante booléenne [SWS_DM_02349].

Utilisation

La fonction membre synchrone PushBack de la classe ara::diag::DiagnosticSovdArrayContentElementDataView ([SWS_DM_02245], définie dans SWS Diagnostics §8.60.5.1.1.11 « PushBack ») ajoute un nouvel élément ayant le type primitif chaîne de caractères à un tableau SOVD de diagnostic. Pour cela, l'en-tête ara/diag/diagnostic_sovd_content_element_data.h doit être inclus. La fonction prend en charge l'élément à ajouter via le paramètre content_element de type ara::core::StringView.

Gestion des erreurs

ara::core::Result<void> sert de type de retour. Une erreur est renvoyée dans l'objet résultat si l'objet actuel n'est pas de type ArrayContentElementData ou si le type de l'élément transmis ne correspond pas au type d'élément défini dans le constructeur de ArrayContentElementData ([SWS_DM_02245]).

Concurrence et restrictions

La fonction est déclarée avec le spécificateur noexcept. Elle offre une sécurité garantie vis-à-vis des exceptions (exception safe) et est spécifiée comme étant sans restriction thread-safe (thread-safe) ([SWS_DM_02245]).

Interaction

L'opération fait partie d'une famille de méthodes surchargées. Au sein de DiagnosticSovdArrayContentElementDataView, d'autres surcharges existent pour des types scalaires tels que std::int64_t ([SWS_DM_02241]), std::uint64_t ([SWS_DM_02242]), double ([SWS_DM_02243]) et bool ([SWS_DM_02244]) ainsi que pour des éléments complets de type DiagnosticSovdContentElementData ([SWS_DM_02246]). De plus, la classe ara::diag::DiagnosticSovdContentElementData met également à disposition une interface PushBack correspondante pour les chaînes de caractères ([SWS_DM_02350]).

Utilisation

La fonction membre synchrone PushBack de la classe ara::diag::DiagnosticSovdArrayContentElementDataView (SWS Diagnostics §8.60.5.1.1.10 « PushBack ») ajoute un élément de type DiagnosticSovdContentElementData à une vue de données de tableau existante ([SWS_DM_02246]). Comme paramètre de transmission, elle prend par valeur l'objet à ajouter content_element et ne possède aucune valeur de retour (void). La déclaration est mise à disposition via le fichier d'en-tête ara/diag/diagnostic_sovd_content_element_data.h.

Concurrence et préconditions

La spécification définit la fonction comme sans danger au niveau des exceptions (exception safe), sûre pour les threads (thread-safe) et annotée avec noexcept ([SWS_DM_02246]). Comme précondition obligatoire, l'opération exige que l'élément actuel soit de type ArrayContentElementData et que l'élément à ajouter corresponde exactement au type défini dans le constructeur de ArrayContentElementData ([SWS_DM_02246]).

Traitement des erreurs et interaction

À la différence des surcharges pour types primitifs tels que std::int64_t ([SWS_DM_02241]), std::uint64_t ([SWS_DM_02242]), double ([SWS_DM_02243]), bool ([SWS_DM_02244]) ou ara::core::StringView ([SWS_DM_02245]), qui renvoient un ara::core::Result<void> pour la transmission des erreurs, cette méthode renvoie void. Il devrait donc relever de la responsabilité de l'appelant de vérifier au préalable la compatibilité des types, car les erreurs d'exécution sur cette interface ne sont pas signalées via un type Result. Question Q-00739dff7d34e242 (ouverte) Une méthode équivalente pour l'ajout d'éléments de données est également définie sur DiagnosticSovdContentElementData ([SWS_DM_02351]).

La méthode synchrone Reserve de la classe ara::diag::DiagnosticSovdArrayContentElementDataView sert à la préallocation de capacité mémoire pour des éléments de données de tableau ([SWS_DM_02240], SWS Diagnostics §8.60.5.1.1.16 « Reserve »). Elle est mise à disposition via l'en-tête #include "ara/diag/diagnostic_sovd_content_element_data.h" et accepte le paramètre capacity de type std::size_t, qui définit la capacité à fournir de la DiagnosticSovdArrayContentElementData sous-jacente ([SWS_DM_02240]). Aucune valeur de retour n'est renvoyée ([SWS_DM_02240]).

Concernant la gestion des erreurs, la fonction est déclarée comme sûre vis-à-vis des exceptions (exception safe) ainsi que noexcept ([SWS_DM_02240]). Elle n'utilise ni codes d'erreur via ara::core::Result ni exceptions C++. Interprétation : en cas de pénurie de mémoire, l'allocation devrait échouer en interne ou conduire à l'interruption du programme, étant donné qu'aucun canal d'erreur n'est à la disposition de l'appelant. Question Q-348805197c004eea (ouverte)

Pour la concurrence, l'opération est explicitement spécifiée comme sûre pour les threads (thread-safe) ([SWS_DM_02240]). Les appels peuvent donc être effectués depuis des threads parallèles sans verrouillage externe.

Dans le système global, l'interface complète des fonctions de réservation apparentées : tandis que DiagnosticSovdRecordContentElementDataView::Reserve est chargée de manière analogue des structures de données d'enregistrement ([SWS_DM_02283], SWS Diagnostics §8.60.11.1.1.20 « Reserve »), la fonction générique de classe de base DiagnosticSovdContentElementData::Reserve renvoie un ara::core::Result<void> afin de signaler une erreur en cas de type d'élément incorrect ([SWS_DM_02345], SWS Diagnostics §8.60.6.1.2.55 « Reserve »). Contrairement à la réservation de mémoire non sûre pour les threads DiagnosticServiceDynamicAccessList::Reserve ([SWS_DM_01163], SWS Diagnostics §8.13.1.1.3.3 « Reserve »), cette méthode de vue opère directement et de façon concurrente sur des éléments de tableau SOVD.