클래스 ara::diag::DiagnosticSovdRecordContentElementDataConstIterator

클래스 ara::diag::DiagnosticSovdRecordContentElementDataConstIterator은 [SWS_DM_02264]에 따라 SOVD 레코드 내용 요소를 읽기 전용으로 순회하기 위한 상수 전진 반복자 역할을 합니다. 일치 여부 확인, 전진 및 DiagnosticSovdContentElementDataWithKey에 대한 역참조 연산자를 제공합니다([SWS_DM_02265]). 모든 연산자가 예외 안전하며 noexcept에 따라 스레드 안전(thread-safe)으로 구현되어 있으므로 유효하지 않은 반복자를 역참조하지 않는 것은 호출자의 책임입니다.

자세히 ›

컨텍스트

클래스 ara::diag::DiagnosticSovdRecordContentElementDataConstIterator은 AUTOSAR_AP_SWS_Diagnostics §8.60.8의 [SWS_DM_02264]에 의해 정의됩니다. AUTOSAR_AP_SWS_Diagnostics §8.60.8에 설명된 바와 같이 DiagnosticSovdRecordContentElementData 유형의 요소를 위한 상수 전진 또는 입력 반복자 역할을 합니다. 상호작용 대상으로는 SOVD 데이터 요소("Service-Oriented Vehicle Diagnostics") 컬렉션을 읽기 전용으로 순회하는 diag 모듈의 진단 애플리케이션과, 반복자가 역참조 중에 접근을 허용하는 DiagnosticSovdContentElementDataWithKey 유형의 참조 요소가 있습니다([SWS_DM_02265], [SWS_DM_02266]).

수명 주기

반복자의 라이프사이클은 일반적으로 SOVD 레코드 요소용 기본 데이터 구조의 인터페이스를 통해 반복자 인스턴스를 가져오는 것으로 시작됩니다(해석: 컨테이너에는 유효한 반복자 인스턴스를 제공하는 cbegin() 및 cend()과 같은 메서드가 있을 것으로 추정됨). 질문 Q-9c5e4d32ae82e7cf (열림) 동적 리소스 관리가 없는 순수 값 또는 포인터 래퍼이므로 반복자에는 명시적인 소멸 메커니즘이 없으며 복사하거나 이동할 수 있습니다. 사양은 반복자의 모든 작업에 대해 예외 안전성(exception safe) 및 완전한 스레드 안전성(thread-safe)을 보장합니다([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). 동시성과 관련하여 이는 추가적인 동기화 조치 없이 동일한 반복자 또는 서로 독립적인 인스턴스에 대해 병렬 읽기 접근을 수행할 수 있음을 의미합니다.

사용 경로

일반적인 사용 경로에는 진단 처리 루틴 내에서 일련의 SOVD 요소 데이터를 반복적으로 순회하는 작업이 포함됩니다. 호출자는 먼저 불일치 연산자 operator!=([SWS_DM_02268]) 또는 일치 연산자 operator==([SWS_DM_02267])를 통해 시퀀스의 끝에 도달했는지 확인합니다. 반복자가 유효한 동안 애플리케이션은 참조된 요소를 읽기 위해 접근합니다. 역참조 연산자 operator*는 DiagnosticSovdContentElementDataWithKey에 대한 상수 참조를 반환하고([SWS_DM_02265]), 화살표 연산자 operator->은 상수 객체에 대한 포인터를 반환합니다([SWS_DM_02266]). 그런 다음 전위 증가 연산자 operator++는 반복자를 한 위치 전진시키고 증가된 반복자에 대한 참조를 반환합니다([SWS_DM_02269]).

시퀀스 다이어그램: const 반복자를 사용한 SOVD 레코드 내용 요소의 순차 순회의 일반적인 흐름. 출처: [SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]

오류 시나리오

ara::diag::DiagnosticSovdRecordContentElementDataConstIterator의 모든 멤버 함수는 지정자 noexcept로 선언되어 있습니다([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). operator*도, operator->도, 비교 연산자도 C++ 예외를 발생시키지 않으며 ara::core::Result 오류 구조를 반환하지 않습니다. operator*, operator-> 및 operator++의 오류 없는 호출을 위한 사전 조건은 반복자의 유효성입니다. 끝 반복자(Past-the-End)의 역참조 또는 전진은 정의되지 않은 동작을 초래할 것으로 추정됩니다(해석: 인터페이스 정의에는 유효하지 않은 역참조에 대한 런타임 확인이 포함되어 있지 않음). 따라서 사용자는 접근하기 전에 항상 끝 반복자에 대한 중단 비교가 수행되는지 확인해야 합니다. 질문 Q-e26c9aa50597bf18 (열림)