클래스 ara::diag::DiagnosticSovdRecordContentElementDataView

사용

동기 함수 [SWS_DM_02288]은(는) 지정된 키 key(ara::core::StringView) 아래에 부호 있는 정수 값(std::int64_t)을 SOVD 데이터 구조에 삽입합니다. 이 함수는 ara::diag::DiagnosticSovdRecordContentElementDataView 클래스의 메서드로 선언되어 있으며 헤더 ara/diag/diagnostic_sovd_content_element_data.h을(를) 통해 포함됩니다.

전제 조건 및 오류 처리

[SWS_DM_02288]에 따르면 기반이 되는 DiagnosticSovdContentElementData 객체는 RecordContentElementData 또는 ContentData 유형이어야 하며, 추가할 요소 자체는 ContentData이(가) 아니어야 합니다. 이 함수는 noexcept(으)로 정의되며 ara::core::Result<void>을(를) 반환합니다. 대상 컨테이너에 호환되지 않는 유형이 있거나 요소를 추가할 수 없는 등의 이유로 연산이 실패하면 결과에 오류 코드가 포함됩니다. 해석: 이는 일반적으로 키 충돌 시에도 해당할 것으로 보입니다. 질문 Q-524c832a794559b7 (열림)

동시성 및 상호 작용

실행은 스레드 안전 및 예외 안전으로 명시되어 있습니다 [SWS_DM_02288]. 인터페이스 내에는 부호 없는 정수([SWS_DM_02289]), 부동소수점 수([SWS_DM_02290]), 부울 값([SWS_DM_02291]), 문자열([SWS_DM_02292]) 및 중첩된 데이터 요소([SWS_DM_02293])에 대한 동일 유형의 오버로드가 존재합니다. 동일한 메서드가 기본 클래스 DiagnosticSovdContentElementData에서도 제공됩니다([SWS_DM_02368]).

클래스 ara::diag::DiagnosticSovdRecordContentElementDataView의 동기 멤버 함수 Add은 지정된 키([SWS_DM_02289]) 아래에 부호 없는 64비트 정수 값을 추가하는 역할을 합니다. ASAM SOVD에 따른 진단 통신을 제공하는 Diagnostic Management의 SOVD 기능 범위 내에서 사용됩니다(AUTOSAR_AP_SWS_Diagnostics §1.0 “Introduction and functional overview”, [SWS_DM_01369]).

사용 및 호출

이 메서드는 헤더 ara/diag/diagnostic_sovd_content_element_data.h을 통해 포함됩니다. 매개변수로 식별자 key을 ara::core::StringView로, 추가할 값 content_element을 std::uint64_t로 기대합니다([SWS_DM_02289]). 호출은 동기식으로 수행되고 noexcept으로 지정되어 있으며 결과를 ara::core::Result<void> 형식으로 반환합니다.

오류 처리 및 제약 조건

• 타입 조건: 인스턴스화된 DiagnosticSovdContentElementData은 RecordContentElementData 또는 ContentData 타입이어야 합니다. 또한 추가할 요소 자체가 ContentData 타입이어서는 안 됩니다([SWS_DM_02289]).
• 오류 동작: 이러한 타입 요구사항 중 하나가 위반되거나 요소를 추가할 수 없는 경우, 함수는 오류 상태의 ara::core::Result을 반환합니다([SWS_DM_02289]). 사양에서는 이 부분에 특정 오류 코드를 명시하지 않았으며, Result 객체가 진단 도메인의 해당 오류 코드를 반환할 것으로 추정됩니다. 질문 Q-ffca131eece93b35 (열림)
• 동시성: 이 함수는 명시적으로 thread-safe 및 exception safe로 지정되어 있습니다([SWS_DM_02289]).

상호 작용

이 메서드는 부호 있는 정수([SWS_DM_02288]) 및 구조화된 하위 요소([SWS_DM_02293])를 위한 변형을 포함하여 원시 및 복합 데이터 요소를 캡처하기 위한 형식화된 오버로드 제품군에 속합니다. 동등한 인터페이스가 클래스 DiagnosticSovdContentElementData에서도 병렬로 제공됩니다([SWS_DM_02369]).

ara::diag::DiagnosticSovdRecordContentElementDataView 클래스의 동기 멤버 함수 Add은(는) 지정된 키 key 아래에 double 타입의 원시 부동소수점 값을 데이터 레코드에 추가합니다[SWS_DM_02290]. 이 함수는 Diagnostic Management의 SOVD 서버 기능을 위한 구조화된 진단 데이터를 구성하는 데 사용됩니다[SWS_DM_01369].

실행에는 다음과 같은 타입 관련 사전 조건이 적용됩니다[SWS_DM_02290]:

• 대상 객체는 RecordContentElementData 또는 ContentData 타입이어야 합니다.
• 추가할 요소 자체가 ContentData 타입이어서는 안 됩니다.

이 메서드는 noexcept(으)로 선언되어 있으며(exception safe) 동시 접근에 대해 스레드 안전(thread-safe)으로 지정되어 있습니다[SWS_DM_02290]. 객체 타입이 호환되지 않거나 요소를 삽입할 수 없는 등 추가에 실패하면 반환된 ara::core::Result<void>을(를) 통해 오류가 보고됩니다[SWS_DM_02290]. 해석: 정확한 오류 원인은 Result 객체의 ara::core::ErrorCode에 매핑될 것으로 보입니다. 질문 Q-c987f75d785d3e90 (열림)

Add의 관련 오버로드와 결합하여, 이 메서드는 정수 값([SWS_DM_02288], [SWS_DM_02289]), 불리언 값 [SWS_DM_02291], 문자열 [SWS_DM_02292] 또는 더 복잡한 요소 데이터 [SWS_DM_02293]를 사용해 SOVD 데이터 레코드를 구조화된 방식으로 채울 수 있도록 합니다.

ara::diag::DiagnosticSovdRecordContentElementDataView 클래스의 Add 함수는 지정된 키 아래에 불리언 기본형 값을 SOVD 데이터 요소 [SWS_DM_02291]에 추가하는 역할을 합니다. 호출은 헤더 파일 ara/diag/diagnostic_sovd_content_element_data.h을 통해 수행되며, ara::core::StringView 타입의 매개변수 이름 key 및 bool 타입의 페이로드 값 content_element을 전달합니다[SWS_DM_02291]. 메서드가 즉시 ara::core::Result<void>를 반환하고 비동기성이 명시되어 있지 않으므로, 이 작업은 동기적으로 실행될 것으로 추정됩니다. 질문 Q-a16b08bf68f8590b (열림)

오류 처리는 반환된 ara::core::Result<void>을 통해 이루어집니다. 기반이 되는 DiagnosticSovdContentElementData이 RecordContentElementData 또는 ContentData 타입이 아니거나 요소를 추가할 수 없는 경우 오류가 보고됩니다[SWS_DM_02291]. 구체적인 오류 코드는 명세서 발췌본에 상세히 명시되어 있지 않습니다.

동시성 및 실행 안전성 측면에서 이 메서드는 thread-safe로 분류되며 예외 안전성(noexcept)을 제공합니다[SWS_DM_02291]. 구조적 제약 사항으로서 명세서에서는 추가할 요소 자체가 ContentData 타입이 아니어야 한다고 규정합니다[SWS_DM_02291].

전체 시스템에서 이 메서드는 부호 있는 정수 [SWS_DM_02288], 부호 없는 정수 [SWS_DM_02289], 부동 소수점 수 [SWS_DM_02290], 문자열 [SWS_DM_02292] 및 하위 콘텐츠 요소 [SWS_DM_02293]를 위한 관련 오버로드를 보완합니다. 또한 Diagnostic Management[SWS_DM_01369]의 SOVD 서버 기능 컨텍스트에서 DiagnosticSovdContentElementData 클래스[SWS_DM_02371]에도 유사한 인터페이스가 존재합니다.

사용

ara::diag::DiagnosticSovdRecordContentElementDataView 클래스의 동기 메서드 Add은 키와 기본형 문자열 값을 갖는 엔트리를 SOVD 데이터 요소 [SWS_DM_02292]에 추가하는 데 사용됩니다. 호출은 각각 ara::core::StringView로 전달되는 두 매개변수 key 및 content_element를 통해 이루어집니다[SWS_DM_02292]. 반환값으로 함수는 작업 결과를 알리기 위한 ara::core::Result<void>을 제공합니다[SWS_DM_02292].

오류 처리

추가에 실패하면 메서드는 ara::core::Result에 오류를 반환합니다[SWS_DM_02292]. 이는 기반 객체가 RecordContentElementData 또는 ContentData 타입이 아니거나 요소를 추가할 수 없을 때 발생합니다[SWS_DM_02292]. 해석: 명세서의 함수 정의에 구체적인 오류 코드가 명시적으로 나열되어 있지 않으므로, 이는 구현의 해당 오류 도메인에 의해 결정될 것으로 추정됩니다. 질문 Q-ba196615f0cd8fc8 (열림)

동시성 및 제약 조건

이 작업은 스레드 안전(thread-safe) 및 예외 안전(exception safe)으로 선언되어 있으며 noexcept로 주석 처리되어 있습니다[SWS_DM_02292]. 필수적인 사전 조건으로서 매개변수로 전달된 요소 자체가 ContentData 타입이 아니어야 합니다[SWS_DM_02292].

상호 작용

이 함수는 Adaptive PlatformAUTOSAR_AP_SWS_Diagnostics §1 “Introduction and functional overview”용 SOVD를 구현하기 위한 AUTOSAR Diagnostic Management(DM)의 구성 요소이며, 여기서 DM은 SOVD 서버 역할을 합니다[SWS_DM_01369]. 동일한 스코프에 대해 부호 있는 정수 [SWS_DM_02288], 부호 없는 정수 [SWS_DM_02289], 부동 소수점 수 [SWS_DM_02290], 불리언 값 [SWS_DM_02291] 및 복합 데이터 요소 [SWS_DM_02293]를 위한 Add의 유사한 오버로드가 존재합니다. 또한 ara::diag::DiagnosticSovdContentElementData도 해당 문자열 오버로드를 제공합니다[SWS_DM_02372].

ara::diag::DiagnosticSovdRecordContentElementDataView 클래스의 동기 함수 Add은(는) 지정된 키 key 아래의 데이터 요소에 DiagnosticSovdContentElementData 유형의 중첩된 요소를 추가합니다 [SWS_DM_02293]. 이는 Adaptive Platform의 Diagnostic Management(DM)에서 지원하는 SOVD(Service-Oriented Vehicle Diagnostics) 프레임워크 내에서 진단 데이터를 구조화하여 제공하는 데 사용됩니다([SWS_DM_01369], AUTOSAR_AP_SWS_Diagnostics §1 “Introduction and functional overview”).

사용 시 다음의 필수 유형 요구 사항을 준수해야 합니다:

• 호출하는 데이터 객체는 RecordContentElementData 또는 ContentData 유형이어야 합니다 [SWS_DM_02293].
• 추가할 요소 content_element은(는) 명시적으로 ContentData 유형이 아니어야 합니다 [SWS_DM_02293].
• 복합 데이터 구조 외에도 기본값에 대해 별도의 오버로드가 제공되며, 예를 들어 DiagnosticSovdContentElementData에도 정의되어 있는 것과 같이 정수 값([SWS_DM_02288], [SWS_DM_02289]), 부동소수점 수 [SWS_DM_02290], 진리값 [SWS_DM_02291] 또는 문자열 [SWS_DM_02292]에 대한 오버로드가 있습니다 [SWS_DM_02373].

오류 처리를 위해 함수는 ara::core::Result<void>을(를) 반환합니다. 유형 전제 조건이 위반되거나 요소를 삽입할 수 없는 등의 이유로 연산이 실패하면 결과에 오류가 포함됩니다 [SWS_DM_02293]. 정확한 오류 코딩은 아마도 진단 관리의 도메인 특화 오류를 기반으로 할 것으로 보입니다. 질문 Q-56c929209d0c7358 (열림) 동시성 및 안전성과 관련하여 이 메서드는 noexcept(으)로 선언되었고 예외 안전(exception safe)으로 간주되며 동시 액세스에 대해 스레드 안전(thread-safe)으로 명시되어 있습니다 [SWS_DM_02293].

사용법 및 의미론

ara::diag::DiagnosticSovdRecordContentElementDataView 클래스의 Clear 메서드는 RecordContentElementData [SWS_DM_02276]에서 모든 콘텐츠 요소를 동기식으로 제거하는 역할을 합니다. 호출은 헤더 #include "ara/diag/diagnostic_sovd_content_element_data.h"을(를) 통해 매개변수 없이 수행되며 반환값이 없습니다(void) [SWS_DM_02276].

실행을 위한 전제 조건으로 기본 데이터 인스턴스가 RecordContentElementData 또는 ContentData 타입이어야 한다고 정의되어 있습니다 [SWS_DM_02276]. 해석: 이 함수는 noexcept(으)로 선언되어 있고 오류 상태를 보고하지 않으므로, 이 데이터 타입의 준수는 뷰 객체 생성 시 이미 사전에 확보되었을 것으로 보입니다. 질문 Q-93e43eee235a8f12 (열림)

오류 처리 및 동시성

실행 안전성과 관련하여 이 메서드는 exception safe로 명시되어 있으며 noexcept 선언으로 인해 예외를 발생시키지 않습니다 [SWS_DM_02276]. 또한 호출은 명시적으로 thread-safe로 분류되어 동시 접근이 허용됩니다 [SWS_DM_02276].

상호작용 및 구분

SOVD 환경에서 이 함수는 배열 요소를 위해 정의되어 있고 ara::core::Result<void>을(를) 반환하는 DiagnosticSovdContentElementData [SWS_DM_02338]의 Clear 메서드와 구분됩니다. 마찬가지로 배열용 뷰 메서드 [SWS_DM_02233] 및 ara::core::Future<void>을(를) 반환하고 스레드 안전하지 않은 ara::diag::DTCInformation::Clear을(를) 통한 비동기 DTC 삭제와도 기능적으로 구별됩니다 [SWS_DM_00671].

ara::diag::DiagnosticSovdRecordContentElementDataView 클래스의 멤버 함수 Erase은(는) 진단 데이터 레코드에서 하위 콘텐츠 요소를 제거하는 역할을 합니다([SWS_DM_02294], AUTOSAR_AP_SWS_Diagnostics §8.60.11.1.1.14 “Erase”). 선언은 헤더 #include "ara/diag/diagnostic_sovd_content_element_data.h"을(를) 통해 제공됩니다([SWS_DM_02294]).

사용 및 시맨틱: 입력 매개변수로 함수는 구체적으로 삭제할 요소를 가리키는 DiagnosticSovdRecordContentElementDataIterator 타입의 반복자 iterator을(를) 전달받습니다([SWS_DM_02294]). 해석: 이 함수는 noexcept(으)로 선언되어 있고 퓨처 객체 대신 ara::core::Result<void>을(를) 직접 반환하므로, 삭제 작업은 호출자의 스레드에서 동기식으로 실행될 것으로 보입니다. 질문 Q-148ae95c28910b16 (열림) 성공적으로 실행되면 메서드는 빈 ara::core::Result<void>을(를) 반환합니다([SWS_DM_02294]).

오류 처리: 대상 데이터 요소가 RecordContentElementData 및 ContentData 타입 중 어느 것도 아니거나 컨테이너에서 요소를 제거할 수 없는 경우 작업이 실패합니다([SWS_DM_02294]). 이러한 오류 발생 시 함수는 오류 코드 DiagErrc::kInvalidArgument이(가) 포함된 오류를 반환합니다([SWS_DM_02294]).

동시성 및 상호작용: 호출에 대해 인터페이스는 thread-safe 및 exception safe로 명시되어 있습니다([SWS_DM_02294]). 기능적으로 이 함수는 배열 변형인 ara::diag::DiagnosticSovdArrayContentElementDataView::Erase([SWS_DM_02247], AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.8 “Erase”)에 대응하며, 배열([SWS_DM_02352]) 및 레코드([SWS_DM_02374])를 위한 컨테이너 클래스 DiagnosticSovdContentElementData의 기본 삭제 연산과 상호작용합니다.

뷰 클래스 ara::diag::DiagnosticSovdRecordContentElementDataView의 동기 멤버 함수 Find는 키를 기반으로 요소를 찾는 역할을 합니다([SWS_DM_02285], AUTOSAR_AP_SWS_Diagnostics §8.60.11.1.1.15 “Find”). 매개변수로 ara::core::StringView 타입의 key이(가) 전달되며, 결과로 함수는 DiagnosticSovdRecordContentElementDataIterator 타입의 수정 가능한 반복자를 반환합니다([SWS_DM_02285]). 사용을 위한 전제 조건은 연관된 DiagnosticSovdContentElementData이(가) RecordContentElementData 또는 ContentData 타입이어야 한다는 것입니다([SWS_DM_02285]).

오류 처리 및 동시성과 관련하여 이 함수는 noexcept(으)로 선언되어 있고, 예외 안전(exception safe)한 것으로 간주되며, 사양에 따라 스레드 안전(thread-safe)합니다([SWS_DM_02285]). 반환 타입이 ara::core::Result이(가) 아닌 반복자 자체이므로 함수는 특정 오류 코드를 보고하지 않으며, 찾는 키가 존재하지 않는 경우에는 끝 반복자(end iterator)가 반환될 것으로 보입니다. 질문 Q-a34054c9851517ae (열림)

관련 인터페이스와의 상호작용 측면에서 동일한 뷰 클래스에 DiagnosticSovdRecordContentElementDataConstIterator을(를) 반환하는 상수 오버로드([SWS_DM_02286], AUTOSAR_AP_SWS_Diagnostics §8.60.11.1.1.16 “Find”)가 존재합니다. 클래스 DiagnosticSovdRecordContentElementDataConstView 또한 유사한 상수 인터페이스를 제공합니다([SWS_DM_02306], AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.7 “Find”). 반면 DiagnosticSovdContentElementData의 메서드 Find는 유효하지 않은 타입이나 누락된 키를 오류로 나타내기 위해 자신의 반복자를 ara::core::Result 내에 캡슐화합니다([SWS_DM_02365], [SWS_DM_02366], AUTOSAR_AP_SWS_Diagnostics §8.60.6.1.2.25 “Find”).

ara::diag::DiagnosticSovdRecordContentElementDataView 클래스의 동기 멤버 함수 Find은(는) 키를 기반으로 데이터 요소를 읽기 전용으로 찾는 데 사용됩니다([SWS_DM_02286], AUTOSAR AP SWS Diagnostics §8.60.11.1.1.16 “Find”).

사용법 및 매개변수

이 함수는 검색할 키 key을(를) ara::core::StringView(으)로 전달받습니다([SWS_DM_02286]). 호출을 위한 전제 조건은 인스턴스가 진단 타입 RecordContentElementData 또는 ContentData이어야 한다는 점입니다([SWS_DM_02286]). 반환값으로는 DiagnosticSovdRecordContentElementDataConstIterator 타입의 상수 반복자를 동기식으로 제공합니다([SWS_DM_02286]). 키와 일치하는 요소가 존재하지 않는 경우 시퀀스 끝을 표시하는 반복자가 반환될 것으로 추정됩니다(해석). 질문 Q-41a1eba77c0bc236 (열림)

오류 처리 및 동시성

이 인터페이스는 noexcept(으)로 선언되어 있어 예외 안전성(exception safe)을 보장하며, 동시 접근에 대해 스레드 안전(thread-safe)으로 명시되어 있습니다([SWS_DM_02286]). ara::diag::DiagnosticSovdContentElementData의 메서드([SWS_DM_02366])와 달리 ara::core::Result을(를) 통한 반환이 이루어지지 않으므로 오류 사례가 오류 코드를 통해 표현되지 않습니다.

상호 작용

동일한 뷰에 대한 쓰기 또는 수정 접근을 위해 변경 가능한 반복자를 사용하는 비상수 오버로드 [SWS_DM_02285]이(가) 존재합니다. 순수 읽기 뷰의 경우 DiagnosticSovdRecordContentElementDataConstView 클래스가 유사한 Find 함수를 제공합니다([SWS_DM_02306]).

ara::diag::DiagnosticSovdRecordContentElementDataView 클래스의 동기 멤버 함수 Remove은(는) 키를 기반으로 항목을 목표로 하여 제거하는 데 사용됩니다[SWS_DM_02287]. ara/diag/diagnostic_sovd_content_element_data.h 헤더에 정의되어 있으며 ara::core::StringView 유형의 key 매개변수를 처리합니다AUTOSAR_AP_SWS_Diagnostics §8.60.11.1.1.19 “Remove”.

반환값으로 함수는 ara::core::Result<bool>을(를) 반환합니다[SWS_DM_02287]:

• 성공 시 포함된 부울 값은 어드레싱된 요소가 실제로 제거될 수 있었는지를 나타냅니다.
• 요소가 RecordContentElementData 또는 ContentData 유형이 아니거나 지정된 키를 찾을 수 없는 경우 ara::core::Result을(를) 통해 오류가 보고됩니다[SWS_DM_02287].

동시성 및 제한 사항과 관련하여 이 함수는 예외 안전(exception safe) 및 스레드 안전(thread-safe)으로 지정되어 있으며 noexcept(으)로 선언되어 있습니다[SWS_DM_02287]. 호출 조건으로 사양은 기본 인스턴스가 RecordContentElementData 또는 ContentData 유형일 것을 엄격히 요구합니다[SWS_DM_02287].

해석: 시그니처, 매개변수 및 오류 시나리오가 완전히 동일하게 지정되어 있으므로, 기능적으로 이 연산은 데이터 클래스 ara::diag::DiagnosticSovdContentElementData::Remove에서의 제거에 해당할 것으로 추정됩니다[SWS_DM_02367]AUTOSAR_AP_SWS_Diagnostics §8.60.6.1.2.54 “Remove”. 질문 Q-5a9ac29a9b5814be (열림)

클래스 ara::diag::DiagnosticSovdRecordContentElementDataView([SWS_DM_02283], AUTOSAR_AP_SWS_Diagnostics §8.60.11.1.1.20 “Reserve”)의 메서드 Reserve은 RecordContentElementData에 대해 요청된 스토리지 용량을 동기식으로 예약합니다. 이 호출은 헤더 #include "ara/diag/diagnostic_sovd_content_element_data.h"를 통해 제공되며 std::size_t 타입의 매개변수 capacity을 받습니다. 이 함수는 반환값으로 void을 제공합니다.

이 인터페이스는 noexcept(으)로 선언되어 있으며 예외 안전(“exception safe”)으로 명시되어 있습니다([SWS_DM_02283]). 특정 오류 코드나 오류 구조체는 반환되지 않습니다. 해석: 요구된 용량의 할당이 실패할 경우, ara::core::Result와 같은 반환 채널이 없으므로 오류가 내부적으로 포착되거나 프로그램 중단으로 이어질 것으로 추정됩니다. 질문 Q-ddbaac36f8ed58ad (열림)

동시성과 관련하여 이 함수는 스레드 안전(“thread-safe”)으로 정의되어 있습니다([SWS_DM_02283]). 따라서 추가적인 동기화 조치 없이 여러 스레드에서 병렬로 호출할 수 있습니다.

관련 인터페이스와의 상호작용에서 배열 변형인 DiagnosticSovdArrayContentElementDataView::Reserve([SWS_DM_02240])은 유사하게 동작합니다. 이와 달리 DiagnosticSovdContentElementData::Reserve([SWS_DM_02345])은 타입 충돌을 보고하기 위해 ara::core::Result<void>을(를) 반환합니다. 반면 함수 DiagnosticServiceDynamicAccessList::Reserve([SWS_DM_01163])는 서비스 패턴을 위한 최악의 경우 사전 할당에 사용되며, 두 개의 매개변수를 요구하고 스레드 안전하지 않습니다.