함수 Clear [SWS_DM_00671] Upstream: RS_AP_00119, RS_AP_00139, RS_Diag_04194
ara::core::Future< void > Clear (std::uint32_t dtcGroup) noexcept;
Method for Clearing a DTC or a group of DTCs.
ara::diag::DTCInformation 클래스([SWS_DM_00671])의 Clear 메서드는 오류 메모리(AUTOSAR_AP_SWS_Diagnostics §7.3.2.8.6 “Service 0x14 – ClearDiagnosticInformation”)에서 개별 DTC 또는 DTC 그룹을 삭제하는 데 사용됩니다. 매개변수로서 dtcGroup를 통해 삭제할 그룹 또는 DTC의 식별자를 전달받고 결과를 ara::core::Future<void>(으)로 비동기 반환합니다([SWS_DM_00671]). 이때 개별 DTC 또는 그룹을 삭제할 수 있는 권한은 clearDtcLimitation([SWS_DM_00160])과 같은 구성 매개변수의 적용을 받습니다.
오류 처리 및 시맨틱
이 함수는 noexcept(으)로 선언되었으며 롤백 시맨틱과 함께 Future을 통해 비동기식으로 오류를 보고합니다([SWS_DM_00671]). DiagErrc에서 발생 가능한 오류 코드는 다음과 같습니다:
DiagErrc::kBusy: 인터페이스가 이미 처리 작업 중입니다.DiagErrc::kFailed: 실행 중 일반적인 처리 오류가 발생했습니다.DiagErrc::kMemoryError: 처리 중 메모리 오류가 발생했습니다.DiagErrc::kWrongDtc: 잘못된 DTC 번호가 전달되었습니다.DiagErrc::kServiceNotAvailable: Diagnostic Manager의 필수 기능을 현재 사용할 수 없습니다.
동시성 및 구별
이 메서드는 예외 안전하지만(exception safe), 명시적으로 not thread-safe로 분류되어 있습니다([SWS_DM_00671]). 따라서 동일한 인스턴스에 대한 병렬 호출은 호출자에 의해 동기화되어야 하며, 그렇지 않으면 DiagErrc::kBusy 위험이 있습니다. 해석: 반환된 ara::core::Future은 UDS 서비스 0x14의 확인([SWS_DM_00162])과 유사하게 물리적 오류 메모리가 완전히 정리된 후에야 이행될 것으로 추정됩니다. 질문 Q-b97545b6864b24aa (열림)
기능적으로 이 작업은 동일한 이름의 SOVD 메서드와 구분되어야 합니다. ara::diag::DiagnosticSovdContentElementDataView::Clear([SWS_DM_02233])이 데이터 컨테이너를 동기적이고 스레드 안전하게 비우는 반면, 이 메서드는 Diagnostic Management에서 진단 프로세스를 제어합니다.
이 사용 지침은 AI에 의해 큐레이팅되었으며 오직 AUTOSAR AP 릴리스 R25-11의 사양 발췌본에만 기반합니다.
구현자 가이드 준비 중 (복잡도 I1)
| Header-Datei | #include "ara/diag/dtc_information.h" |
|---|---|
| Scope | class ara::diag::DTCInformation |
| Exception-Sicherheit | exception safe |
| Thread-Sicherheit | not thread-safe DiagErrc::kBusy rollback_semantics |
Parameter (in)
| Parameter | Beschreibung |
|---|---|
| dtcGroup | DTC group to be cleared. |
Rückgabewert
| Typ | Beschreibung |
|---|---|
| ara::core::Future< void > | void or errors |
Fehler
| Fehlercode | Beschreibung |
|---|---|
| Interface is busy with processing. | |
| DiagErrc::kFailed | rollback_semantics Failed to process. |
| DiagErrc::kMemoryError | rollback_semantics A memory error occurred during processing. |
| DiagErrc::kWrongDtc | rollback_semantics A wrong DTC number was requested. |
| DiagErrc::kServiceNotAvailable | rollback_semantics The call cannot be executed, because essential DM functionality is currently not available. |
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/SWS_DM_00671- Status
- valid/unmigrated
- Version
AUTOSAR/AP/record/SWS_DM_00671@rel:R25-11#01783a5b- Content hash
01783a5b- Source
- https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00671
Status: valid/unmigrated
Version: rel:R25-11#5f2d812c
Versionshistorie & Revisions (1 transition, 8 revision)
- Current State
valid/unmigrated- Reason
- mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
- Campaign
2026-08-13-status-backfill- Active Version
AUTOSAR/AP/record/SWS_DM_00671@rel:R25-11#5f2d812c
Recorded Revisions (8):
- R25-11
rel:R25-11#eeae02f92026-09-30 - R19-11
rel:R19-11#51e8d4512026-10-14 - R20-11
rel:R20-11#a949cf792026-10-14 - R21-11
rel:R21-11#a949cf792026-10-14 - R22-11
rel:R22-11#a1f423932026-10-14 - R23-11
rel:R23-11#cc3a92472026-10-14 - R24-11
rel:R24-11#ee42b6492026-10-14 - R25-11
rel:R25-11#5f2d812c2026-10-14 active
Requirement Text as-of this release:
Curation Decisions:
Reachable Artifacts & Dependents:
| Date | Actor | Transition | Reason / Rationale | Campaign |
|---|---|---|---|---|
| 2026-08-13 | tool | none → valid/unmigrated | mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record | 2026-08-13-status-backfill |
gemini-3.8-flash-low· 2026-10-13 · 독일어 원문