DEENESPTFRRUARHIKOZHNL

فئة ara::com::ServiceVersionType

[SWS_CM_11515] Upstream: RS_CM_00200, RS_CM_00500

class ServiceVersionType {...};

Specifies a Service Version. The exact type may be overridden by the Communication Management software provider. but shall at least satisfy the [equalitycomparable] ([SWS_CM_11516]), [lessthancomparable] ([SWS_CM_11517]) and [copyassignable] ([SWS_CM_11518]) requirements as per [30] to allow for logging, storing and managing ara:: com::ServiceVersionTypes by the application.

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/service/service_version.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com

دليل المستخدممولَّد بالذكاء الاصطناعي

يُستخدم لتمثيل إصدارات الخدمة وتسجيلها وإدارتها المقارنة في التطبيقات.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: abf1d9197db7 المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يُستخدم لتمثيل إصدارات الخدمة وتسجيلها وإدارتها المقارنة في التطبيقات.

تُستخدم الفئة ara::com::ServiceVersionType للتمثيل القياسي لإصدارات الخدمة وإدارتها في AUTOSAR Adaptive Platform ([SWS_CM_11515]). وتستخدم التطبيقات المثيلات للتحقق من التوافق عن طريق مقارنات التساوي والترتيب، وللتخزين في الحاويات، وكذلك للتسجيل باستخدام ToString() ([SWS_CM_11519]). ويجوز لموفر Communication Management تجاوز النوع الدقيق، ولكنه يجب أن يستوفي متطلبات المقارنة والتعيين الأساسية في C++‎. وعند الاستخدام، يجب مراعاة أن جميع الدوال الأعضاء في الفئة مصنفة وفقاً للمواصفة على أنها غير آمنة ضد الاستثناءات.

السياق

تُعرّف الفئة ara::com::ServiceVersionType في الترويسة ara/com/service/service_version.h (AUTOSAR_AP_SWS_CommunicationManagement §8.11 «Header: ara/com/service/service_version.h») إصدار خدمة اتصال ([SWS_CM_11515]). وتتمثل مسؤوليتها الأساسية في جعل إصدارات الخدمة قابلة للتعامل معها بواسطة برمجيات التطبيق، بحيث يمكنها تخزين معلومات الإصدار وإدارتها ومقارنتها وتسجيلها ([SWS_CM_11515]).

تكمن إحدى الخصائص المعمارية في مرونة المنصة: وفقاً لـ [SWS_CM_11515]، يجوز لموفر برمجيات Communication Management تجاوز نوع البيانات الملموس أو توسيعه. ولضمان التعامل المتسق في التطبيقات القابلة للنقل مع ذلك، تتطلب المواصفة أن يستوفي النوع على الأقل مفاهيم معيار C++‎ وهي [equalitycomparable] ([SWS_CM_11516]) و[lessthancomparable] ([SWS_CM_11517]) و[copyassignable] ([SWS_CM_11518]) وفقاً للمعيار ISO/IEC 14882:2014.

تتضمن أطراف التفاعل، إلى جانب موفر برمجيات Communication Management، واجهات الخدمة أيضاً، والتي توفر الإصدارات كثابت استاتيكي serviceVersion (AUTOSAR_AP_SWS_CommunicationManagement ص. 320)، وكذلك البرمجيات المطبقة التي تُجري مطابقات الإصدارات.

diag_serviceversion_kontext provider Communication Management Software Provider service_version ara::com::ServiceVersionType provider->service_version يحدد / يتجاوز service_interface Service-Schnittstelle (serviceVersion) service_interface->service_version exponiert application Anwendungssoftware (Application) application->service_interface liest Version application->service_version speichert, vergleicht, protokolliert

مخطط السياق: تضمين ara::com::ServiceVersionType بين موفر البرمجيات وواجهة الخدمة والتطبيق. المصادر: [SWS_CM_11515]، AUTOSAR_AP_SWS_CommunicationManagement ص. 320، AUTOSAR_AP_SWS_CommunicationManagement §8.11.1 «Class: ServiceVersionType».

دورة الحياة

تم تصميم مثيلات ara::com::ServiceVersionType كأنواع قيم (Value Types) عادية. ويتم الإنشاء وتولي القيمة عبر النسخ والتعيين: يتم استيفاء المتطلب [copyassignable] عبر معامل التعيين operator= ([SWS_CM_11518])، بحيث يمكن للمثيلات أخذ قيم جديدة.

فيما يتعلق بملكية الكائن، يخضع ara::com::ServiceVersionType لنطاق صلاحية الجهة المستدعية المعنية أو يتم الاحتفاظ به كثابت لتعريف الخدمة (AUTOSAR_AP_SWS_CommunicationManagement ص. 320). ولا يمتلك النوع آلة حالة داخلية معقدة، بل يُغلف قيمة إصدار منفصلة. ويتم تدميره تلقائياً عند مغادرة نطاق الصلاحية.

فيما يتعلق بالتزامن، تم الإعلان عن عمليات القراءة operator== ([SWS_CM_11516]) وoperator< ([SWS_CM_11517]) وToString ([SWS_CM_11519]) كـ const. تفسير: يُرجَّح أن تكون عمليات الوصول المتزامنة للقراءة إلى نفس المثيل من عدة خيوط آمنة دون مزامنة، بينما يجب حماية عمليات الكتابة والتعيين المتوازية خارجياً. سؤال Q-9582ce9a82b9b833 (مفتوح)

مسار الاستخدام

ينقسم التسلسل النموذجي لاستخدام ara::com::ServiceVersionType في تطبيق ما إلى الخطوات التالية:

  1. الاستعلام عن الإصدار: يصل التطبيق إلى معلومات الإصدار الخاصة بخدمة ما، على سبيل المثال عبر الثابت الاستاتيكي serviceVersion لواجهة ما (AUTOSAR_AP_SWS_CommunicationManagement ص. 320).
  2. التحقق من التوافق: يقارن التطبيق الإصدار بإصدار متوقع عبر operator== ([SWS_CM_11516]). وللتحقق من الترتيب أو للتخزين في حاويات قياسية مرتبة، يُستخدم operator< ([SWS_CM_11517]).
  3. الإدارة والتخزين: لتمرير حالات الإصدار أو تخزينها محلياً، يستخدم التطبيق معامل التعيين operator= ([SWS_CM_11518]).
  4. التسجيل: لرسائل التشخيص أو مخرجات السجل، يُنشئ التطبيق تمثيلاً نصياً كـ ara::core::StringView عبر الدالة ToString() ([SWS_CM_11519]، AUTOSAR_AP_SWS_CommunicationManagement §8.11.1.1.2.1 «ToString»).

سيناريوهات الأخطاء

عند استخدام الواجهة، يجب مراعاة الشروط الحدية المحددة:

  • الأمان ضد الاستثناءات: تم الإعلان صراحةً في المواصفة عن جميع الدوال المحددة – operator= ([SWS_CM_11518])، operator== ([SWS_CM_11516])، operator< ([SWS_CM_11517])، وToString ([SWS_CM_11519]) – بأنها not exception safe. ويجب ألا تعتمد التطبيقات في حالة الخطأ (مثل عمليات تخصيص الذاكرة في عمليات التنفيذ الخاصة بالمزود) على ضمانات استرداد تلقائية.
  • صلاحية StringView: تُرجع الدالة ToString() كائناً من نوع ara::core::StringView ([SWS_CM_11519]). تفسير: نظراً لأن StringView لا يدير ذاكرة خاصة به، يُرجَّح أن تكون دورة حياة سلسلة المحارف المشار إليها مرتبطة بالمثيل الأساسي أو بذاكرة استاتيكية؛ ويؤدي الاستخدام بما يتجاوز صلاحية مصدر البيانات إلى سلوك غير معرف. سؤال Q-fdb6e821db46af00 (مفتوح)

يستند هذا الدليل إلى معيار AUTOSAR الإصدار R25-11 ويراعي حصرياً المتطلبات الواردة في AUTOSAR_AP_SWS_CommunicationManagement.

خريطة الأعضاء

الدوال الأعضاء

1
ToString

المعاملات

3
operator<operator=operator==

مخطط الفئة

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__com__ServiceVersionType743 ServiceVersionType + operator=() + ToString() + operator<() + operator==()

عرض التفاصيل

اختر عنصرًا من المخطط.

الدوال الأعضاء

ToString دالة

Stringification method for ara::com::ServiceVersionType

ara::core::StringView ToString () const;

المعاملات

operator< دالة

LessThan operator as per [lessthancomparable] in [30]

bool operator< (const ServiceVersionType &other) const;
operator= دالة

Copy assignment constructor

ServiceVersionType & operator= (const ServiceVersionType &other);
operator== دالة

Equality operator as per [equalitycomparable] in [30]

bool operator== (const ServiceVersionType &other) const;

توثيق الدوال

دالة ToString [SWS_CM_11519] Upstream: RS_CM_00200, RS_CM_00500

ara::core::StringView ToString () const;

Stringification method for ara::com::ServiceVersionType

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 6f062cc4edae المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة العضو المتزامنة ToString للفئة ara::com::ServiceVersionType في تسلسل وتوفير معلومات الإصدار كتمثيل نصي مقروء ([SWS_CM_11519]، SWS CommunicationManagement §8.11.1.1.2.1 «ToString»). تم الإعلان عنها في ملف الترويسة #include "ara/com/service/service_version.h"، وبصفتها دالة const فإنها لا تأخذ أي معلمات وتُرجع ara::core::StringView يشير إلى تمثيل السلسلة النصية لإصدار الخدمة ([SWS_CM_11519]).

تُشتق معلومات الإصدار الممثلة وفقًا لـ [SWS_CM_99029] من السمتين majorVersion وminorVersion لـ ServiceInterface المعني (SWS CommunicationManagement §7.5.22.1 «Service Identifier Data Types»). التنسيق المحدد للسلسلة النصية وفقًا لـ [SWS_CM_00088] مخصص من قبل الشركة المصنعة لـ Communication Management وغير موحد عبر AUTOSAR ككل (SWS CommunicationManagement §7.5.22.1 «Service Identifier Data Types»).

تسري الشروط الحدية التالية على الاستخدام والتزامن:

  • أمان الاستثناءات: تم تصنيف الدالة في المواصفة صراحةً على أنها غير آمنة من الاستثناءات (not exception safe) ([SWS_CM_11519]). لم يتم تعريف رموز أخطاء محددة أو رسائل إلى DET أو DEM.
  • عمر قيمة الإرجاع: بما أنه يتم إرجاع ara::core::StringView، يُرجّح أن المخزن المؤقت المشار إليه مرتبط بعمر كائن ServiceVersionType أو بذاكرة ثابتة (تفسير). سؤال Q-dc38956a7fe0476a (مفتوح) لذلك، لا ينبغي استخدام العرض بعد انتهاء عمر مثيل المصدر.
  • سياق الاستدعاء: بصفتها عملية const خالية من الآثار الجانبية، فإن الاستدعاء لا يُعدل الكائن؛ ولا يتم تحديد متطلبات خاصة بقابلية إعادة الدخول.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/com/service/service_version.h"
Scopeclass ara::com::ServiceVersionType
Exception-Sicherheitnot exception safe

Rückgabewert

TypBeschreibung
ara::core::StringViewString representation of a ara::com::ServiceVersionType

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11519
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11519@rel:R25-11#7f0856fc
Content hash
7f0856fc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11519
Status: valid/unmigrated Version: rel:R25-11#abf5021f Versionshistorie & Revisions (1 transition, 3 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_CM_11519@rel:R25-11#abf5021f
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#0f392a642026-09-30
  • R24-11rel:R24-11#2df22b872026-10-14
  • R25-11rel:R25-11#abf5021f2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة operator< [SWS_CM_11517] Upstream: RS_CM_00200, RS_CM_00500

bool operator< (const ServiceVersionType &other) const;

LessThan operator as per [lessthancomparable] in [30]

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/service/service_version.h"
Scopeclass ara::com::ServiceVersionType
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
otherara::com::ServiceVersionType to compare

Rückgabewert

TypBeschreibung
boolTRUE if other is less than *this, FALSE otherwise.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11517
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11517@rel:R25-11#a96eb42c
Content hash
a96eb42c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11517
Status: valid/unmigrated Version: rel:R25-11#2d7b1db2 Versionshistorie & Revisions (1 transition, 3 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_CM_11517@rel:R25-11#2d7b1db2
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#f371b0f02026-09-30
  • R24-11rel:R24-11#abc475902026-10-14
  • R25-11rel:R25-11#2d7b1db22026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة operator= [SWS_CM_11518] Upstream: RS_CM_00200, RS_CM_00500

ServiceVersionType & operator= (const ServiceVersionType &other);

Copy assignment constructor

Header-Datei#include "ara/com/service/service_version.h"
Scopeclass ara::com::ServiceVersionType
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
otherara::com::ServiceVersionType to copy

Rückgabewert

TypBeschreibung
ServiceVersionType &New ara::com::ServiceVersionType

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11518
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11518@rel:R25-11#96f91957
Content hash
96f91957
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11518
Status: valid/unmigrated Version: rel:R25-11#b8a11cec Versionshistorie & Revisions (1 transition, 3 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_CM_11518@rel:R25-11#b8a11cec
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#a7abbb5e2026-09-30
  • R24-11rel:R24-11#31f02ac92026-10-14
  • R25-11rel:R25-11#b8a11cec2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة operator== [SWS_CM_11516] Upstream: RS_CM_00200, RS_CM_00500

bool operator== (const ServiceVersionType &other) const;

Equality operator as per [equalitycomparable] in [30]

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/service/service_version.h"
Scopeclass ara::com::ServiceVersionType
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
otherara::com::ServiceVersionType to compare

Rückgabewert

TypBeschreibung
boolTRUE if other is equal to *this, FALSE otherwise.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11516
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11516@rel:R25-11#cb5713ad
Content hash
cb5713ad
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11516
Status: valid/unmigrated Version: rel:R25-11#8e598b1d Versionshistorie & Revisions (1 transition, 3 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_CM_11516@rel:R25-11#8e598b1d
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#b31c22602026-09-30
  • R24-11rel:R24-11#38d0957c2026-10-14
  • R25-11rel:R25-11#8e598b1d2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill