clase ara::diag::DiagnosticSovdArrayContentElementDataIterator

La clase ara::diag::DiagnosticSovdArrayContentElementDataIterator sirve para la iteración paso a paso sobre elementos de un array SOVD en contenidos de diagnóstico ([SWS_DM_02215], AUTOSAR_AP_SWS_Diagnostics §8.60.4 «Class: DiagnosticSovdArrayContentElementDataIterator»). Proporciona operadores de comparación, avance mediante incremento prefijo y desreferenciación para suministrar referencias o punteros a DiagnosticSovdContentElementData ([SWS_DM_02216], [SWS_DM_02220]). Todas las funciones son seguras para subprocesos y están especificadas como noexcept, motivo por el cual la validez del rango de destino debe ser garantizada por la aplicación antes de la desreferenciación.

más ›

Contexto

La clase ara::diag::DiagnosticSovdArrayContentElementDataIterator proporciona un iterador específico para elementos de array dentro de la comunicación de diagnóstico basada en SOVD (Service-Oriented Vehicle Diagnostics) ([SWS_DM_02215], AUTOSAR_AP_SWS_Diagnostics §8.60.4 «Class: DiagnosticSovdArrayContentElementDataIterator»). Su responsabilidad primordial radica en proporcionar interfaces de iteración estandarizadas para navegar secuencialmente por elementos de un array de datos. Como interlocutores actúan aplicaciones de diagnóstico invocadoras, así como los elementos de destino referenciados del tipo DiagnosticSovdContentElementData ([SWS_DM_02216], [SWS_DM_02217]). El iterador está declarado en la cabecera ara/diag/diagnostic_sovd_content_element_data.h (AUTOSAR_AP_SWS_Diagnostics §8.60.4.1 «Public Member Functions»).

Ciclo de vida

La especificación no define constructores públicos propios para ara::diag::DiagnosticSovdArrayContentElementDataIterator; por consiguiente, las instancias son creadas y proporcionadas por las estructuras de contenedor SOVD correspondientes a través de sus métodos de iterador (interpretación). Pregunta Q-e1fbf51ab4acc197 (abierta) El iterador en sí no posee la propiedad de los datos útiles subyacentes, sino que únicamente mantiene referencias a los elementos respectivos en memoria. Por tanto, la validez de una instancia de iterador debería estar estrictamente ligada a la vida útil y validez de la estructura de datos de nivel superior (interpretación). Pregunta Q-c01219664b4adc56 (abierta)

En lo que respecta al ciclo de vida y la concurrencia, todas las funciones miembro están especificadas como seguras frente a excepciones (exception safe) y seguras para subprocesos (thread-safe) ([SWS_DM_02216], [SWS_DM_02218], [SWS_DM_02219], [SWS_DM_02220]). Esto permite operaciones simultáneas de lectura y avance a través de múltiples subprocesos, siempre que la estructura de datos subyacente no se modifique destructivamente de manera concurrente.

Ruta de uso

El flujo regular sigue el patrón típico de los iteradores hacia adelante de C++. Las aplicaciones comparan la posición actual del iterador con un iterador de finalización mediante operator!= ([SWS_DM_02219]) o operator== ([SWS_DM_02218], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.5 «operator==»). Si aún no se ha alcanzado el final, el acceso de lectura al elemento actual se realiza bien mediante la desreferenciación operator* ([SWS_DM_02216]) para devolver una referencia a DiagnosticSovdContentElementData, o bien a través del operador de flecha operator-> ([SWS_DM_02217], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.4 «operator->») para devolver un puntero correspondiente. A continuación, la aplicación avanza la posición al siguiente elemento del campo con el operador de incremento prefijo operator++ ([SWS_DM_02220], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.3 «operator++»).

Diagrama de secuencias: Secuencia de llamadas durante un bucle de iteración sobre elementos de un array SOVD. Fuentes: [SWS_DM_02216], [SWS_DM_02219], [SWS_DM_02220].

Escenarios de error

Todos los métodos del iterador están provistos de la especificación noexcept y, por definición, no lanzan excepciones ([SWS_DM_02216], [SWS_DM_02217], [SWS_DM_02218], [SWS_DM_02219], [SWS_DM_02220]). Códigos de error como ara::core::ErrorCode no están previstos para estas interfaces. La corrección recae en las condiciones de invocación de la aplicación: una desreferenciación mediante operator* u operator-> presupone de forma obligatoria como precondición que el iterador apunte a un elemento de campo válido y no a la posición final; un acceso a iteradores no válidos debería dar lugar a un comportamiento indefinido (interpretación). Pregunta Q-63d87e38f9886f6b (abierta)