फ़ंक्शन 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 के रूप में घोषित किया गया है और यह रोलबैक सेमांटिक्स ([SWS_DM_00671]) के साथ Future के माध्यम से असमकालिक रूप से त्रुटियों की रिपोर्ट करता है। 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#c815eeb5- Content hash
c815eeb5- 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 · जर्मन मूल