clase ara::diag::DiagnosticSovdRecordContentElementDataIterator

La clase ara::diag::DiagnosticSovdRecordContentElementDataIterator sirve como iterador para el recorrido secuencial de elementos de datos de diagnóstico de un registro SOVD ([SWS_DM_02258]). A través de los operadores de desreferenciación, las aplicaciones obtienen acceso a elementos del tipo DiagnosticSovdContentElementDataWithKey, mientras que el avance hacia adelante se realiza mediante el operador de incremento. Como condición de contorno central, todas las funciones están especificadas como noexcept y seguras para subprocesos ([SWS_DM_02263]). Interpretación: la aplicación invocadora debe comprobar de forma autónoma antes de cada acceso si se ha alcanzado el final de la secuencia, para evitar un comportamiento indefinido. Pregunta Q-819b2e03155473ad (abierta)

más ›

Contexto

La clase ara::diag::DiagnosticSovdRecordContentElementDataIterator está especificada en AUTOSAR Adaptive Platform como iterador para elementos de datos de registros SOVD (Service-Oriented Vehicle Diagnostics) ([SWS_DM_02258], AUTOSAR_AP_SWS_Diagnostics §8.60.10 «Class: DiagnosticSovdRecordContentElementDataIterator»). Dentro del subsistema de diagnóstico, sirve como interfaz de acceso estandarizada para recorrer elemento por elemento los datos de diagnóstico estructurados de un registro SOVD.

Entre los interlocutores primarios se encuentran la aplicación de diagnóstico solicitante, que procesa datos de registro, así como la estructura de datos subyacente del módulo de diagnóstico. El iterador media el acceso a elementos de datos individuales del tipo DiagnosticSovdContentElementDataWithKey proporcionando, a través de sus operadores de desreferenciación, opcionalmente referencias o punteros a estos elementos de datos ([SWS_DM_02259], [SWS_DM_02260]).

Ciclo de vida

Las instancias del iterador se crean típicamente durante operaciones de consulta sobre contenidos SOVD. La especificación no define un constructor público independiente dentro del alcance de la API para el iterador; por lo tanto, es probable que las instancias sean proporcionadas principalmente por contenedores de nivel superior o funciones de consulta y se copien como valores. Pregunta Q-e79bbdff728ef3f2 (abierta) El iterador hace referencia a datos de usuario existentes sin asumir su propiedad.

El ciclo de vida dentro de un proceso de recorrido se controla mediante pasos de avance y comparaciones de posición. Mediante el operador de incremento prefijo operator++, el iterador avanza al siguiente elemento de datos ([SWS_DM_02263]). La validez y el alcance del final de la secuencia se determinan frente a un iterador centinela o de finalización mediante los operadores de igualdad y desigualdad operator== ([SWS_DM_02261]) y operator!= ([SWS_DM_02262]).

En cuanto a la concurrencia, todas las funciones miembro de la clase están especificadas explícitamente como seguras para hilos ([SWS_DM_02259], [SWS_DM_02260], [SWS_DM_02261], [SWS_DM_02262], [SWS_DM_02263]). Esto permite accesos de lectura paralelos a instancias independientes del iterador en entornos multihilo.

Ruta de uso

El flujo típico durante la evaluación de contenidos de registros SOVD sigue el patrón clásico de iterador hacia adelante de C++:

• Comprobación de la condición de parada: antes de cada acceso, la aplicación compara la posición actual con el iterador de finalización mediante operator!= ([SWS_DM_02262]).
• Acceso a elementos: si el iterador se encuentra en un elemento válido, la aplicación accede por referencia mediante operator* al DiagnosticSovdContentElementDataWithKey ([SWS_DM_02259]) o utiliza el operador de acceso a miembros operator-> ([SWS_DM_02260]) para direccionar directamente métodos o campos del elemento de datos.
• Avance: mediante operator++, el iterador se incrementa a la siguiente posición ([SWS_DM_02263]).

Diagrama de secuencia: flujo típico del recorrido de elementos de datos de registros SOVD. Fuentes: [SWS_DM_02259], [SWS_DM_02260], [SWS_DM_02262], [SWS_DM_02263].

Escenarios de error

Todas las operaciones especificadas del iterador están declaradas como seguras frente a excepciones (exception safe) y como noexcept ([SWS_DM_02259], [SWS_DM_02260], [SWS_DM_02261], [SWS_DM_02262], [SWS_DM_02263]). Esto significa que en el funcionamiento regular no se lanzan excepciones ni se generan códigos de error para su evaluación.

Interpretación: como precondición esencial para las llamadas a operator*, operator-> y operator++ se asume que el iterador debe hacer referencia a una posición válida y no debe corresponder al iterador de finalización. Pregunta (abierta) En el contexto estándar de C++, avanzar o desreferenciar un iterador no válido probablemente provocaría un comportamiento indefinido. Por lo tanto, las aplicaciones deben comprobar estrictamente la llegada al final mediante operator!= o operator== ([SWS_DM_02261], [SWS_DM_02262]).