دالة Message [SWS_PHM_01249] Upstream: RS_AP_00119, RS_AP_00159
const char * Message (CodeType errorCode) const noexcept override;
Returns the message associated with the error code.
تُرجع دالة العضو Message للفئة ara::phm::PhmErrorDomain وصفًا نصيًا لرسالة الخطأ المقترنة برقم الخطأ المُمرر errorCode من النوع CodeType كـ const char * [SWS_PHM_01249]. تتوفر الدالة عبر ملف الترويسة ara/phm/phm_error_domain.h، وتتجاوز كطريقة افتراضية (override) سلوك الواجهة القياسي لحل الأخطاء [SWS_PHM_01249].
تنطبق المحددات التالية على سياق الاستدعاء ودلالات التنفيذ:
- التنفيذ المتزامن ومعالجة الاستثناءات: يتم الاستدعاء بشكل متزامن ويتم التصريح عنه كـ
noexcept؛ بالإضافة إلى ذلك، فإن الطريقة محددة كـ exception safe، بحيث لا يتم إطلاق أي استثناءات أثناء التنفيذ [SWS_PHM_01249]. - التزامن: تم التصريح عن الدالة صراحةً بأنها thread-safe ويمكن استدعاؤها بأمان من خيوط متزامنة دون مزامنة خارجية إضافية [SWS_PHM_01249].
- إدارة الذاكرة: تفسير: يُرجح أن يشير مؤشر المحارف المُرجع إلى ثابت محرفي ثابت (static character literal)، بحيث لا يلزم المستدعي إجراء تحرير للذاكرة. سؤال Q-dcdc593e3f9ded45 (مفتوح)
تُستخدم الطريقة في Platform Health Management (PHM) لترجمة أكواد الأخطاء الرقمية لـ PhmErrorDomain إلى سلاسل نصية مقروءة بشريًا لأغراض التسجيل أو التشخيص [SWS_PHM_01249].
تم توليد هذا النص بواسطة ذكاء اصطناعي وهو بمثابة دليل توجيهي. المواصفات الرسمية لـ AUTOSAR هي وحدها الملزمة.
سياق الاستخدام والواجهة البرمجية
تُعرَّف الدالة Message كعضو في الفئة ara::phm::PhmErrorDomain ضمن ملف الترويسة ara/phm/phm_error_domain.h وفقاً للمواصفة [SWS_PHM_01249]. تؤدي الدالة مهمة استرجاع الرسالة النصية الوصفية المقترنة برمز خطأ محدد، حيث يتم تمرير الرمز كمعامل دخل errorCode من النوع CodeType، وتُعيد مؤشراً ثابتاً من النوع const char * يشير إلى نص الرسالة المرتبطة بهذا الرمز بصورة متزامنة.
معالجة الأخطاء والسلامة الاستثنائية
تمنح الدالة ضماناً تاماً للأمان ضد الاستثناءات (exception safe) وهي محددة بالوسم noexcept كما تنص المواصفة [SWS_PHM_01249]. يضمن هذا التحديد عدم إطلاق الدالة لأي استثناء أثناء التنفيذ، مما يتيح الاعتماد عليها في مسارات معالجة الأخطاء الحرجة وتسجيل الأحداث دون التسبب في سلوكيات غير متوقعة للنظام.
التزامن وقيود الاستدعاء
صُنفت الدالة على أنها آمنة للاستخدام عبر خيوط التنفيذ المتعددة (thread-safe) وتعمل كدالة ثابتة const تطبق نمط التجاوز override بحسب المتطلب [SWS_PHM_01249]. يتيح ذلك استدعاءها بالتوازي وبأمان كامل من خيوط تنفيذ متعددة لقراءة نصوص الأخطاء دون الحاجة إلى تطبيق آليات قفل أو مزامنة إضافية من قبل المستدعي.
تم توليد هذا التوجيه آلياً بالاعتماد على مواصفات AUTOSAR Adaptive لتقديم إرشادات دقيقة حول استخدام الواجهة البرمجية.
| Header-Datei | #include "ara/phm/phm_error_domain.h" |
|---|---|
| Scope | class ara::phm::PhmErrorDomain |
| Exception-Sicherheit | exception safe |
| Thread-Sicherheit | thread-safe |
Parameter (in)
| Parameter | Beschreibung |
|---|---|
| errorCode | The error code number. |
Rückgabewert
| Typ | Beschreibung |
|---|---|
| const char * | The message associated with the error code. |
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/SWS_PHM_01249- Status
- valid/unmigrated
- Version
AUTOSAR/AP/record/SWS_PHM_01249@rel:R25-11#dd7e2db7- Content hash
dd7e2db7- Source
- https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01249
Status: valid/unmigrated
Version: rel:R25-11#87e7affe
Versionshistorie & Revisions (1 transition, 5 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_PHM_01249@rel:R25-11#87e7affe
Recorded Revisions (5):
- R25-11
rel:R25-11#29a23c2e2026-09-30 - R22-11
rel:R22-11#d28a09b52026-10-14 - R23-11
rel:R23-11#fb2533e82026-10-14 - R24-11
rel:R24-11#87e7affe2026-10-14 - R25-11
rel:R25-11#87e7affe2026-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 · الأصل الألماني