clase ara::diag::DiagnosticSovdRecordContentElementDataConstIterator

La clase ara::diag::DiagnosticSovdRecordContentElementDataConstIterator actúa, conforme a [SWS_DM_02264], como un iterador hacia adelante constante para el recorrido de solo lectura de elementos de contenido de registros SOVD. Ofrece operadores para comprobaciones de igualdad, avance y desreferenciación a DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265]). Dado que todos los operadores están implementados como seguros frente a excepciones y seguros para subprocesos según noexcept, la responsabilidad recae en el invocador de no desreferenciar iteradores no válidos.

más ›

Contexto

La clase ara::diag::DiagnosticSovdRecordContentElementDataConstIterator es definida por [SWS_DM_02264] en AUTOSAR_AP_SWS_Diagnostics §8.60.8. Sirve como iterador constante hacia adelante o de entrada para elementos del tipo DiagnosticSovdRecordContentElementData, según se describe en AUTOSAR_AP_SWS_Diagnostics §8.60.8. Como interlocutores actúan aplicaciones de diagnóstico del módulo diag, que recorren en modo de solo lectura colecciones de elementos de datos SOVD («Service-Oriented Vehicle Diagnostics»), así como los elementos referenciados del tipo DiagnosticSovdContentElementDataWithKey, a los cuales el iterador concede acceso durante la desreferenciación ([SWS_DM_02265], [SWS_DM_02266]).

Ciclo de vida

El ciclo de vida de un iterador comienza típicamente con la obtención de una instancia de iterador a través de la interfaz de una estructura de datos subyacente para elementos de registros SOVD (interpretación: los contenedores probablemente poseen métodos como cbegin() y cend() que proporcionan ejemplares válidos de iterador). Pregunta Q-9c5e4d32ae82e7cf (abierta) Al tratarse de un simple contenedor de valor o puntero sin gestión dinámica de recursos, el iterador no posee un mecanismo de destrucción explícito y se puede copiar o mover. La especificación garantiza para todas las operaciones del iterador seguridad frente a excepciones (exception safe), así como seguridad completa para subprocesos (thread-safe) ([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). En lo que respecta a la concurrencia, esto significa que se pueden llevar a cabo accesos de lectura paralelos sobre el mismo iterador o sobre instancias independientes entre sí sin medidas adicionales de sincronización.

Ruta de uso

La ruta de uso típica comprende el recorrido iterativo de un conjunto de datos de elementos SOVD dentro de rutinas de procesamiento de diagnóstico. Un invocador comprueba primero mediante el operador de desigualdad operator!= ([SWS_DM_02268]) o el operador de igualdad operator== ([SWS_DM_02267]) si se ha alcanzado el final de la secuencia. Mientras el iterador sea válido, la aplicación accede en modo de lectura al elemento referenciado: el operador de desreferenciación operator* proporciona una referencia constante a DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265]), mientras que el operador de flecha operator-> devuelve un puntero al objeto constante ([SWS_DM_02266]). A continuación, el operador de incremento prefijo operator++ avanza el iterador una posición y devuelve una referencia al iterador incrementado ([SWS_DM_02269]).

Diagrama de secuencias: Flujo típico del recorrido secuencial de elementos de contenido de registros SOVD mediante el iterador constante. Fuentes: [SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]

Escenarios de error

Todas las funciones miembro de ara::diag::DiagnosticSovdRecordContentElementDataConstIterator están declaradas con el especificador noexcept ([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). Ni operator* ni operator-> ni los operadores de comparación lanzan excepciones de C++ o devuelven estructuras de error ara::core::Result. La precondición para una llamada sin errores a operator*, operator-> y operator++ es la validez del iterador: la desreferenciación o el avance de un iterador de finalización (past-the-end) debería provocar un comportamiento indefinido (interpretación: la definición de la interfaz no contiene comprobaciones en tiempo de ejecución para desreferenciaciones no válidas). Pregunta Q-e26c9aa50597bf18 (abierta) Por consiguiente, los usuarios deben asegurarse de que antes del acceso siempre se realice una comparación de terminación frente al iterador de finalización.