DEENESPTFRRUARHIKOZHNL

فئة ara::log::Logger

[SWS_LOG_00172] Upstream: RS_LT_00003, RS_LT_00046

class Logger final {...};

Represents a logger context. The Logging framework defines contexts which can be seen as logger instances within one Application process or process scope. The contexts have the following properties: • Context ID • Description of the Context ID • Default log level A context will be automatically registered against the Logging backend during creation phase, as well as automatically deregistered during process shutdown phase. So the end user does not care for the objects life time. To ensure such housekeeping functionality, a strong ownership of the logger instances needs to be ensured towards the Logging framework. This means that the Application process are not supposed to call the Logger constructor themselves. The user is not allowed to create a Logger object by himself. Logger context needs to be created by one of the ara::log::CreateLogger functions.

Header-Datei#include "ara/log/logger.h"
Forwarding-Header#include "ara/log/log_fwd.h"
Scopenamespace ara::log

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

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

يُغلف سياق تسجيل (Logging) للالتقاط الآمن خيطياً لرسائل السجل المنسقة أو المنمذجة.

تمثّل الفئة ara::log::Logger سياقاً لالتقاط رسائل السجل (Log) داخل عملية تطبيق عبر تدفقات مؤقتة أو تنسيقات رسائل منمذجة [SWS_LOG_00064]. ونظراً لأن المُنشئ الافتراضي محذوف، فإن إنشاء النسخة وإدارة دورة الحياة تتم بالكامل من قِبل إطار عمل التسجيل (Logging Framework) [SWS_LOG_00259]. وقبل الإعداد المستغرق للوقت لبيانات الرسائل، يمكن الاستعلام عن مستوى الإبلاغ النشط حالياً. وقد تم تحديد كافة واجهات الفئة على أنها آمنة خيطياً، وتسمح بالاستدعاء دون الحاجة إلى مزامنة من عدة خيوط معالجة.

السياق

تمثّل الفئة ara::log::Logger سياق مسجل (Logger) داخل عملية تطبيق أو نطاق عملية في الوحدة log. ويُغلف هذا السياق مُعرّف سياق ID محدداً، ووصفاً مرتبطاً به، بالإضافة إلى مستوى افتراضي للتسجيل. ويتفاعل مطورو التطبيقات مع نسخ المسجل لتسليم رسائل السجل إلى إطار عمل التسجيل إما عبر كائنات تدفق مثل LogStream [SWS_LOG_00064] أو كرسائل مهيكلة ومنمذجة [SWS_LOG_00204]. وتعمل النسخ كوسيط بين خيوط المعالجة الداخلية للتطبيق والواجهة الخلفية للتسجيل.

LoggerKontext Application التطبيق LoggingFramework Logging-Framework Application->LoggingFramework CreateLogger() Logger ara::log::Logger Application->Logger Log*() / IsEnabled() LogStream LogStream Application->LogStream operator<< LoggingFramework->Logger يمتلك ويُنشئ Logger->LogStream erzeugt LoggingBackend Logging-Backend Logger->LoggingBackend registriert / leitet weiter

مخطط السياق: دمج المسجل بين التطبيق وإطار عمل التسجيل وLogStream. المصادر: [SWS_LOG_00064]، [SWS_LOG_00259].

دورة الحياة

تخضع إدارة النسخ لملكية صارمة من قِبل إطار عمل التسجيل. ولضمان التسجيل التلقائي في الواجهة الخلفية للتسجيل عند الإنشاء، وإلغاء التسجيل عند إيقاف تشغيل عملية التطبيق، تم حذف المُنشئ الافتراضي [SWS_LOG_00259]. ولا يُسمح للتطبيقات ولا يمكنها إنشاء كائنات Logger مباشرة، بل يجب عليها بدلاً من ذلك استخدام دوال الإنشاء ara::log::CreateLogger. ويتم التدمير والتحرير عبر المُدمّر [SWS_LOG_00260]، الذي يتحكم فيه إطار عمل التسجيل، بحيث لا يتعين على المستخدمين الاهتمام بدورة الحياة.

فيما يتعلق بالتزامن، تم تحديد كافة طرق الوصول لتكون آمنة خيطياً (thread-safe)، من بينها [SWS_LOG_00070] و[SWS_LOG_00255] و[SWS_LOG_00260]. وبفضل ذلك، يمكن لعدة خيوط معالجة متزامنة استخدام سياق المسجل نفسه في الوقت ذاته، دون الحاجة إلى آليات مزامنة إضافية من جانب التطبيق.

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

يشمل الاستخدام النموذجي للمسجل فحص التكوين الحالي، وتعديل قيم العتبة، وإرسال الرسائل:

  • فحص صلاحية الإخراج: قبل التحضيرات المستهلكة للموارد لبيانات السجل، يمكن الاستعلام باستخدام IsEnabled عما إذا كان مستوى السجل المطلوب يتم الإبلاغ عنه بنشاط [SWS_LOG_00070].
  • التكوين: يمكن إعادة تكوين الحد الأدنى لعتبة الإبلاغ لنسخة المسجل أثناء وقت التشغيل عبر SetThreshold [SWS_LOG_00255].
  • التسجيل المستند إلى الدفق: عبر دوال محددة لدرجات خطورة منفردة – LogFatal [SWS_LOG_00064]، LogError [SWS_LOG_00065]، LogWarn [SWS_LOG_00066]، LogInfo [SWS_LOG_00067]، LogDebug [SWS_LOG_00068] أو LogVerbose [SWS_LOG_00069] – وكذلك عبر الدالة الديناميكية WithLevel [SWS_LOG_00131]، يُنشأ كائن LogStream. يستقبل هذا الكائن البيانات عبر المعامل <<. وعادةً ما ينتهي العمر الافتراضي لكائن الدفق مع الفاصلة المنقوطة للتعليمة [SWS_LOG_00064].
  • الرسائل المنمذجة: كبديل، يمكن تمرير الرسائل المحددة النوع والمنمذجة مباشرةً باستخدام Log [SWS_LOG_00204] أو مع تحديد السمات باستخدام LogWith [SWS_LOG_00133].
التسلسل النموذجي أثناء التسجيل عبر الدفقالتطبيقLoggerLogStreamIsEnabled(LogLevel::kInfo)trueoptAusgabe aktiviertLogInfo()ErzeugungLogStreamoperator<<(arg)

مخطط تسلسلي: التسلسل النموذجي لفحص العتبة والتسجيل المستند إلى الدفق. المصادر: [SWS_LOG_00070]، [SWS_LOG_00067]، [SWS_LOG_00064].

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

تم تحديد واجهات الفئة إلى حد كبير على أنها noexcept وآمنة من الاستثناءات (exception safe)، مما يقلل من انقطاعات وقت التشغيل غير المتوقعة [SWS_LOG_00070]، [SWS_LOG_00255]. ومع ذلك، توجد شروط خطأ رسمية وحالات حافية:

  • معاملات نموذج غير صحيحة: إذا تم استدعاء Log بوسائط لا تتطابق مع مواصفات الرسالة المنمذجة، فإن برنامج ++C يكون مبنيًا بشكل غير صحيح (ill-formed) ويفشل في وقت الترجمة [SWS_LOG_00204].
  • خصائص سمة مفقودة: إذا احتوت المجموعة لـ LogWith على أنواع لا تتوافق مع معايير السمة المطلوبة، فلن تشارك الدالة في حل فرط التحميل [SWS_LOG_00133]. يُفترض على الأرجح أن الاستبعاد يتم عبر SFINAE أو المفاهيم. سؤال Q-e6179190587f11cb (مفتوح)
  • أمان الاستثناءات أثناء التفكيك: تم الإعلان عن مُدمِّر الفئة ~Logger بأنه not exception safe [SWS_LOG_00260]. ويُرجَّح أن يرجع ذلك إلى احتمال حدوث أخطاء أثناء إلغاء التسجيل في الواجهة الخلفية للتسجيل، والتي لا يجوز نشرها عبر استثناءات. سؤال Q-4ac2bed8a8ffd85a (مفتوح)

يستند هذا الدليل حصريًا إلى مواصفات AUTOSAR للوحدة log في Adaptive Release R25-11.

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

المُنشئات والمُتلف

2
Logger~Logger

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

11
IsEnabledLogLogDebugLogErrorLogFatalLogInfoLogVerboseLogWarnLogWithSetThresholdWithLevel

مخطط الفئة

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

G nara__log__Logger529 Logger + Logger() + ~Logger() + IsEnabled() + Log() + LogDebug() + LogError() + LogFatal() + LogInfo() + LogVerbose() + LogWarn() + LogWith() + SetThreshold() + WithLevel()

عرض التفاصيل

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

المُنشئات والمُتلف

Logger دالة

Default destructor is deleted.

Logger ()=delete;
~Logger دالة

Destructor .

~Logger ();

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

IsEnabled دالة

Check current configured log reporting level. Applications may want to check the actual configured reporting log level of certain loggers before doing log data preparation that is runtime intensive.

bool IsEnabled (LogLevel logLevel) const noexcept;
Log دالة

Log a modeled message. If this function is called with an argument list that does not match the modeled message, the program is ill-formed.

template <typename MsgId, typename... Params> void Log (const MsgId &id, const Params &... args) noexcept;
LogDebug دالة

Same as Logger::LogFatal(). .

LogStream LogDebug () const noexcept;
LogError دالة

Same as Logger::LogFatal(). .

LogStream LogError () const noexcept;
LogFatal دالة

Creates a LogStream object. Returned object will accept arguments via the insert stream operator "@c <<".

LogStream LogFatal () const noexcept;
LogInfo دالة

Same as Logger::LogFatal(). .

LogStream LogInfo () const noexcept;
LogVerbose دالة

Same as Logger::LogFatal(). .

LogStream LogVerbose () const noexcept;
LogWarn دالة

Same as Logger::LogFatal(). .

LogStream LogWarn () const noexcept;
LogWith دالة

This function does not participate in overload resolution if any of Attrs... is not an "Attr" (TBD).

template <typename... Attrs, typename MsgId, typename... Params> void LogWith (const std::tuple< Attrs... > &attrs, const MsgId &msg Id, const Params &... params) noexcept;
SetThreshold دالة

Set log level threshold for this Logger instance.

void SetThreshold (LogLevel threshold) noexcept;
WithLevel دالة

Log message with a programmatically determined log level can be written.

LogStream WithLevel (LogLevel logLevel) const noexcept;

توثيق الدوال

دالة IsEnabled [SWS_LOG_00070] Upstream: RS_LT_00003, RS_LT_00045

bool IsEnabled (LogLevel logLevel) const noexcept;

Check current configured log reporting level. Applications may want to check the actual configured reporting log level of certain loggers before doing log data preparation that is runtime intensive.

Check current configured log reporting level. Applications may want to check the actual configured reporting log level of certain loggers before doing log data preparation that is runtime intensive.

Validate requirementfunction IsEnabled [SWS_LOG_00070] Upstream: RS_LT_00003 , RS_LT_00045

Was muss freigegeben werden?

Bestätige, dass der folgende Requirement-Text fachlich korrekt ist, zur genannten API gehört und ohne irreführende Importartefakte veröffentlicht werden kann.

Check current configured log reporting level. Applications may want to check the actual configured reporting log level of certain loggers before doing log data preparation that is runtime intensive.

Prüfkontext

Review-Grund
Legacy-Beschreibung prüfen
Warum ist ein Review nötig?
Der Beschreibungstext wurde aus einer älteren Dokumentationsquelle übernommen und konnte nicht mit hoher Sicherheit gegen die aktuelle Spezifikation verifiziert werden.
API-Element
function IsEnabled [SWS_LOG_00070] Upstream: RS_LT_00003 , RS_LT_00045
Requirement-ID
SWS_LOG_00070
Flag-ID
SWS_LOG_00070
Status
pending
Konfidenz
medium
Herkunft
explicit
Modul
log
Spezifikationsdokument
AUTOSAR_AP_SWS_LogAndTrace
Text-Hash
1e1bddc1fd7610a3343b90c0c12cf4975f804f8b299e6307b560b673ffbcf8a9
Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
logLevelThe to be checked log level.

Rückgabewert

TypBeschreibung
boolTrue if desired log level satisfies the configured reporting level.

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

Record
AUTOSAR/AP/record/SWS_LOG_00070
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00070@rel:R25-11#126c01a8
Content hash
126c01a8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00070
Status: valid/auto-approved Version: rel:R25-11#1af960db Versionshistorie & Revisions (3 transitions, 8 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00070@rel:R25-11#1af960db
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#da9f93dd2026-09-30
  • R19-11rel:R19-11#abfecdf22026-10-14
  • R20-11rel:R20-11#14a862062026-10-14
  • R21-11rel:R21-11#e75568f92026-10-14
  • R22-11rel:R22-11#5358cb642026-10-14
  • R23-11rel:R23-11#0e1f99732026-10-14
  • R24-11rel:R24-11#1af960db2026-10-14
  • R25-11rel:R25-11#1af960db2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement
2026-08-10T14:00:00Zassistantnone → valid/auto-approvedÜberführung vorhandener Prosa-Beschreibung in requirement_text-Formatlegacy-desc-import

دالة Log [SWS_LOG_00204] Upstream: RS_LT_00003

template <typename MsgId, typename... Params> void Log (const MsgId &id, const Params &... args) noexcept;

Log a modeled message. If this function is called with an argument list that does not match the modeled message, the program is ill-formed.

Log a modeled message. If this function is called with an argument list that does not match the modeled message, the program is ill-formed.

Validate requirementfunction Log [SWS_LOG_00204] Upstream: RS_LT_00003

Was muss freigegeben werden?

Bestätige, dass der folgende Requirement-Text fachlich korrekt ist, zur genannten API gehört und ohne irreführende Importartefakte veröffentlicht werden kann.

Log a modeled message. If this function is called with an argument list that does not match the modeled message, the program is ill-formed.

Prüfkontext

Review-Grund
Legacy-Beschreibung prüfen
Warum ist ein Review nötig?
Der Beschreibungstext wurde aus einer älteren Dokumentationsquelle übernommen und konnte nicht mit hoher Sicherheit gegen die aktuelle Spezifikation verifiziert werden.
API-Element
function Log [SWS_LOG_00204] Upstream: RS_LT_00003
Requirement-ID
SWS_LOG_00204
Flag-ID
SWS_LOG_00204
Status
pending
Konfidenz
medium
Herkunft
explicit
Modul
log
Spezifikationsdokument
AUTOSAR_AP_SWS_LogAndTrace
Text-Hash
682287c04e8bbe0e88e1facc447fd5373ac8ce8782d00c7dcf5f621b383f1ebb
Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Template-Parameter

ParameterBeschreibung
MsgIdArgsthe type of the id parameter the types of the args parameters

Parameter (in)

ParameterBeschreibung
idan implementation-defined type identifying the message object
argsthe arguments to add to the message

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_LOG_00204
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00204@rel:R25-11#ade3be26
Content hash
ade3be26
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00204
Status: valid/auto-approved Version: rel:R25-11#58f80623 Versionshistorie & Revisions (3 transitions, 7 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00204@rel:R25-11#58f80623
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#19c9984a2026-09-30
  • R20-11rel:R20-11#815a796b2026-10-14
  • R21-11rel:R21-11#815a796b2026-10-14
  • R22-11rel:R22-11#d9c6c0d72026-10-14
  • R23-11rel:R23-11#a795f3312026-10-14
  • R24-11rel:R24-11#44e63b542026-10-14
  • R25-11rel:R25-11#58f806232026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement
2026-08-10T14:00:00Zassistantnone → valid/auto-approvedÜberführung vorhandener Prosa-Beschreibung in requirement_text-Formatlegacy-desc-import

دالة LogDebug [SWS_LOG_00068] Upstream: RS_LT_00003, RS_LT_00049

LogStream LogDebug () const noexcept;

Same as Logger::LogFatal(). .

Same as Logger::LogFatal().

Validate requirementfunction LogDebug [SWS_LOG_00068] Upstream: RS_LT_00003 , RS_LT_00049

Was muss freigegeben werden?

Bestätige, dass der folgende Requirement-Text fachlich korrekt ist, zur genannten API gehört und ohne irreführende Importartefakte veröffentlicht werden kann.

Same as Logger::LogFatal().

Prüfkontext

Review-Grund
Legacy-Beschreibung prüfen
Warum ist ein Review nötig?
Der Beschreibungstext wurde aus einer älteren Dokumentationsquelle übernommen und konnte nicht mit hoher Sicherheit gegen die aktuelle Spezifikation verifiziert werden.
API-Element
function LogDebug [SWS_LOG_00068] Upstream: RS_LT_00003 , RS_LT_00049
Requirement-ID
SWS_LOG_00068
Flag-ID
SWS_LOG_00068
Status
pending
Konfidenz
medium
Herkunft
explicit
Modul
log
Spezifikationsdokument
AUTOSAR_AP_SWS_LogAndTrace
Text-Hash
6b761cd6688140661851a8d157f5a01f25a462a2ad60287da8b3bb533eaf19db
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 01530793cc11 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة العضو LogDebug للفئة ara::log::Logger لإنشاء رسائل سجل بمستوى خطورة الخطأ Debug، وتُرجع كائن LogStream مهيأً وفقًا لذلك [SWS_LOG_00068]. يتم الإعلان عبر ملف الرأس #include "ara/log/logger.h" [SWS_LOG_00068].

تم تحديد خصائص المواصفة التالية للاستخدام والدلالات البرمجية:

  • الاستدعاء وقيمة الإرجاع: لا تستقبل الطريقة أي معلمات إدخال وتُرجع مباشرةً كائن LogStream بمستوى خطورة Debug [SWS_LOG_00068]. ويتطابق أسلوب العمل في ذلك مع الطريقة Logger::LogFatal() [SWS_LOG_00068].
  • معالجة الأخطاء: تم الإعلان عن التوقيع بصفته noexcept وحُدد على أنه آمن من الاستثناءات (exception safe) [SWS_LOG_00068]. ولا يتم الإبلاغ عن أي رسائل خطأ أو رموز خطأ في حالة حدوث خطأ [SWS_LOG_00068].
  • التزامن: تم تصنيف الدالة العضو على أنها ثابتة (const) وصراحةً على أنها آمنة لمؤشرات الترابط (thread-safe) [SWS_LOG_00068]، بحيث يُسمح بالوصول المتوازي للقراءة عبر نفس مثيل Logger.

تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى AUTOSAR R25-11.

Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
LogStreamLogStream object of Debug severity.

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

Record
AUTOSAR/AP/record/SWS_LOG_00068
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00068@rel:R25-11#062cfd0a
Content hash
062cfd0a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00068
Status: valid/auto-approved Version: rel:R25-11#35a0dc61 Versionshistorie & Revisions (3 transitions, 8 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00068@rel:R25-11#35a0dc61
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#7fe80d2a2026-09-30
  • R19-11rel:R19-11#7f41a7622026-10-14
  • R20-11rel:R20-11#073265842026-10-14
  • R21-11rel:R21-11#073265842026-10-14
  • R22-11rel:R22-11#287c12bf2026-10-14
  • R23-11rel:R23-11#7f8a19ae2026-10-14
  • R24-11rel:R24-11#35a0dc612026-10-14
  • R25-11rel:R25-11#35a0dc612026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement
2026-08-10T14:00:00Zassistantnone → valid/auto-approvedÜberführung vorhandener Prosa-Beschreibung in requirement_text-Formatlegacy-desc-import

دالة LogError [SWS_LOG_00065] Upstream: RS_LT_00003, RS_LT_00049

LogStream LogError () const noexcept;

Same as Logger::LogFatal(). .

Same as Logger::LogFatal().

Validate requirementfunction LogError [SWS_LOG_00065] Upstream: RS_LT_00003 , RS_LT_00049

Was muss freigegeben werden?

Bestätige, dass der folgende Requirement-Text fachlich korrekt ist, zur genannten API gehört und ohne irreführende Importartefakte veröffentlicht werden kann.

Same as Logger::LogFatal().

Prüfkontext

Review-Grund
Legacy-Beschreibung prüfen
Warum ist ein Review nötig?
Der Beschreibungstext wurde aus einer älteren Dokumentationsquelle übernommen und konnte nicht mit hoher Sicherheit gegen die aktuelle Spezifikation verifiziert werden.
API-Element
function LogError [SWS_LOG_00065] Upstream: RS_LT_00003 , RS_LT_00049
Requirement-ID
SWS_LOG_00065
Flag-ID
SWS_LOG_00065
Status
pending
Konfidenz
medium
Herkunft
explicit
Modul
log
Spezifikationsdokument
AUTOSAR_AP_SWS_LogAndTrace
Text-Hash
6b761cd6688140661851a8d157f5a01f25a462a2ad60287da8b3bb533eaf19db
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 97a3ba118d39 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الطريقة LogError للفئة ara::log::Logger لبدء إدخال سجل بمستوى الخطورة Error [SWS_LOG_00065]. وتُعلن الدالة عبر ملف الترويسة ara/log/logger.h ولا تستقبل أي معاملات [SWS_LOG_00065].

الاستخدام وقيمة الإرجاع

يُعيد الاستدعاء المتزامن كائنًا من النوع LogStream بمستوى الخطورة Error [SWS_LOG_00065]. ويتطابق السلوك وظيفيًا في ذلك مع سلوك Logger::LogFatal() [SWS_LOG_00065]. وبما أن LogError معلنة كـ const، فإن الاستدعاء لا يعدل حالة كائن المسجل (Logger) ويمكن تنفيذه أيضًا على مثيلات ثابتة [SWS_LOG_00065].

التزامن وأمان الاستثناءات

تنطبق ضمانات محددة على سياق الاستدعاء [SWS_LOG_00065]:

  • أمان الخيوط: حُددت الدالة على أنها آمنة خيطيًا (thread-safe) [SWS_LOG_00065]. تفسير: يُرجح بالتالي أن تتم الاستدعاءات بالتزامن من عدة خيوط على المثيل نفسه دون مزامنة خارجية. سؤال Q-e55d2b523c5cbcb3 (مفتوح)
  • الأمان من الاستثناءات: أُعلنت الطريقة على أنها noexcept وكذلك آمنة من الاستثناءات (exception safe) [SWS_LOG_00065]؛ وهي لا تطلق أي استثناءات في وقت التشغيل.

معالجة الأخطاء

لم يُنص لـ LogError على رموز أخطاء محددة أو إشعارات إلى DET أو DEM [SWS_LOG_00065]. وتُستبعد حالات الخطأ عند الاستدعاء بفضل الأمان المضمون من الاستثناءات والواجهة الخالية من المعاملات [SWS_LOG_00065].

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى المواصفة SWS_LOG_00065.

Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
LogStreamLogStream object of Error severity.

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

Record
AUTOSAR/AP/record/SWS_LOG_00065
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00065@rel:R25-11#acac9af7
Content hash
acac9af7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00065
Status: valid/auto-approved Version: rel:R25-11#0bab4023 Versionshistorie & Revisions (3 transitions, 8 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00065@rel:R25-11#0bab4023
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#6659bb6a2026-09-30
  • R19-11rel:R19-11#9d8dda862026-10-14
  • R20-11rel:R20-11#977413e12026-10-14
  • R21-11rel:R21-11#310f37c82026-10-14
  • R22-11rel:R22-11#09612dae2026-10-14
  • R23-11rel:R23-11#8b7cfd0c2026-10-14
  • R24-11rel:R24-11#0bab40232026-10-14
  • R25-11rel:R25-11#0bab40232026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement
2026-08-10T14:00:00Zassistantnone → valid/auto-approvedÜberführung vorhandener Prosa-Beschreibung in requirement_text-Formatlegacy-desc-import

دالة LogFatal [SWS_LOG_00064] Upstream: RS_LT_00003, RS_LT_00049

LogStream LogFatal () const noexcept;

Creates a LogStream object. Returned object will accept arguments via the insert stream operator "@c <<".

Creates a LogStream object. Returned object will accept arguments via the insert stream operator "@c <<".

Validate requirementfunction LogFatal [SWS_LOG_00064] Upstream: RS_LT_00003 , RS_LT_00049

Was muss freigegeben werden?

Bestätige, dass der folgende Requirement-Text fachlich korrekt ist, zur genannten API gehört und ohne irreführende Importartefakte veröffentlicht werden kann.

Creates a LogStream object. Returned object will accept arguments via the insert stream operator "@c <<".

Prüfkontext

Review-Grund
Legacy-Beschreibung prüfen
Warum ist ein Review nötig?
Der Beschreibungstext wurde aus einer älteren Dokumentationsquelle übernommen und konnte nicht mit hoher Sicherheit gegen die aktuelle Spezifikation verifiziert werden.
API-Element
function LogFatal [SWS_LOG_00064] Upstream: RS_LT_00003 , RS_LT_00049
Requirement-ID
SWS_LOG_00064
Flag-ID
SWS_LOG_00064
Status
pending
Konfidenz
medium
Herkunft
explicit
Modul
log
Spezifikationsdokument
AUTOSAR_AP_SWS_LogAndTrace
Text-Hash
9f595eed46fdb62ded69dd8892fec7d03f3949961e2c0496116f2417a93c7a14
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 7531b48b97ac المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام ودورة الحياة

تُنشئ الدالة LogFatal للفئة ara::log::Logger (المتوفرة عبر ملف الرأس ara/log/logger.h) كائناً من نوع LogStream بمستوى الخطورة Fatal ([SWS_LOG_00064]). لا تأخذ الدالة أي وسيطات وتُرجع التدفق مباشرةً. يستقبل كائن LogStream المرتجع رسائل السجل والمعلمات بالتسلسل عبر عامل التدفق << ([SWS_LOG_00064]). في سيناريو الاستخدام المعتاد، تقتصر دورة حياة التدفق المُنشأ على تعليمة برمجية واحدة وتنتهي بالفاصلة المنقوطة الختامية بعد آخر معلمة تم تمريرها ([SWS_LOG_00064]). ولتمديد دورة حياة كائن التدفق إلى ما بعد ذلك، يمكن تعيينه لمتغير مسمى ([SWS_LOG_00064]).

معالجة الأخطاء والتزامن

صُرح عن الدالة كـ noexcept وحُددت بأنها آمنة من الاستثناءات (exception safe) ([SWS_LOG_00064]). ولا تطرح استثناءات أثناء وقت التشغيل ولا تستخدم رموز خطأ محددة. وفيما يتعلق بالتزامن، حُددت الدالة كـ const وكذلك بأنها آمنة تماماً بالنسبة للخيوط (thread-safe)، مما يجعل الاستدعاءات المتوازية عبر نفس نسخة المسجل مسموحاً بها ([SWS_LOG_00064]).

تفاعل

تتطابق الدالة في واجهتها وسلوكها مع دوال تسجيل السجل ذات الصلة لمستويات الخطورة الأخرى ضمن ara::log::Logger: LogError ([SWS_LOG_00065])، وLogWarn ([SWS_LOG_00066])، وLogInfo ([SWS_LOG_00067])، وLogDebug ([SWS_LOG_00068])، بالإضافة إلى LogVerbose ([SWS_LOG_00069]).

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

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

Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
LogStreamLogStream object of Fatal severity.
Hinweise: In the normal usage scenario, the object’s life time of the created LogStream is scoped within one statement (ends with ; after last passed argument). If one wants to extend the LogStream object’s life time, the object might be assigned to a named variable. Refer to the LogStream class documentation for further details.

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

Record
AUTOSAR/AP/record/SWS_LOG_00064
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00064@rel:R25-11#b893adb3
Content hash
b893adb3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00064
Status: valid/auto-approved Version: rel:R25-11#72f4032f Versionshistorie & Revisions (3 transitions, 8 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00064@rel:R25-11#72f4032f
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#2db32a362026-09-30
  • R19-11rel:R19-11#607741412026-10-14
  • R20-11rel:R20-11#ce8c37932026-10-14
  • R21-11rel:R21-11#ce8c37932026-10-14
  • R22-11rel:R22-11#17a9d1882026-10-14
  • R23-11rel:R23-11#106563eb2026-10-14
  • R24-11rel:R24-11#72f4032f2026-10-14
  • R25-11rel:R25-11#72f4032f2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement
2026-08-10T14:00:00Zassistantnone → valid/auto-approvedÜberführung vorhandener Prosa-Beschreibung in requirement_text-Formatlegacy-desc-import

دالة LogInfo [SWS_LOG_00067] Upstream: RS_LT_00003, RS_LT_00049

LogStream LogInfo () const noexcept;

Same as Logger::LogFatal(). .

Same as Logger::LogFatal().

Validate requirementfunction LogInfo [SWS_LOG_00067] Upstream: RS_LT_00003 , RS_LT_00049

Was muss freigegeben werden?

Bestätige, dass der folgende Requirement-Text fachlich korrekt ist, zur genannten API gehört und ohne irreführende Importartefakte veröffentlicht werden kann.

Same as Logger::LogFatal().

Prüfkontext

Review-Grund
Legacy-Beschreibung prüfen
Warum ist ein Review nötig?
Der Beschreibungstext wurde aus einer älteren Dokumentationsquelle übernommen und konnte nicht mit hoher Sicherheit gegen die aktuelle Spezifikation verifiziert werden.
API-Element
function LogInfo [SWS_LOG_00067] Upstream: RS_LT_00003 , RS_LT_00049
Requirement-ID
SWS_LOG_00067
Flag-ID
SWS_LOG_00067
Status
pending
Konfidenz
medium
Herkunft
explicit
Modul
log
Spezifikationsdokument
AUTOSAR_AP_SWS_LogAndTrace
Text-Hash
6b761cd6688140661851a8d157f5a01f25a462a2ad60287da8b3bb533eaf19db
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: e56baa961e88 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتم الإعلان عن الدالة العضو LogInfo الخاصة بالفئة ara::log::Logger ([SWS_LOG_00067]) عبر ملف الرأس ara/log/logger.h. وهي تُستخدم لإنشاء رسالة سجل بمستوى الخطورة Info، ولا تتطلب أي معلمات إدخال وتُرجع بشكل متزامن كائنًا من النوع LogStream ([SWS_LOG_00067]). ويتطابق السلوك وفقًا للمواصفة مع سلوك Logger::LogFatal() ([SWS_LOG_00067])، مع تفسير مفاده أن الوظيفة تعمل بشكل مماثل ويقتصر الاختلاف على تحديد تصنيف مستوى الخطورة على Info.

فيما يتعلق بالتزامن وسياق الاستدعاء، فإن الطريقة مُعلنة كـ const ومحددة صراحةً بأنها آمنة لمؤشرات الترابط (thread-safe) ([SWS_LOG_00067]). وبذلك، يُسمح باستدعاء LogInfo بالتوازي في أي وقت من عدة مؤشرات ترابط على نفس مثيل Logger، دون الحاجة إلى آليات مزامنة أو أقفال مسؤولة عنها التطبيقات.

في معالجة الأخطاء، تم تزويد الدالة بالمعرّف noexcept وتصنيفها على أنها آمنة من الاستثناءات (exception safe) ([SWS_LOG_00067]). لا يتم إرجاع رموز خطأ محددة ولا يتم إطلاق رسائل خطأ DEM أو DET ([SWS_LOG_00067])؛ وحالة الخطأ غير محددة لهذا الاستدعاء.

في هيكل المتطلبات، ترتبط الواجهة مباشرةً بالمتطلبات السابقة [RS_LT_00003] و[RS_LT_00049] ([SWS_LOG_00067])، والتي تحدد الإرشادات التوجيهية الشاملة للنظام الفرعي للتسجيل والتتبع.

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

Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
LogStreamLogStream object of Info severity.

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

Record
AUTOSAR/AP/record/SWS_LOG_00067
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00067@rel:R25-11#af8dd4a4
Content hash
af8dd4a4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00067
Status: valid/auto-approved Version: rel:R25-11#029e8e2b Versionshistorie & Revisions (3 transitions, 8 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00067@rel:R25-11#029e8e2b
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#945b21782026-09-30
  • R19-11rel:R19-11#472faa0d2026-10-14
  • R20-11rel:R20-11#f9ad32242026-10-14
  • R21-11rel:R21-11#f9ad32242026-10-14
  • R22-11rel:R22-11#bda08a362026-10-14
  • R23-11rel:R23-11#506836842026-10-14
  • R24-11rel:R24-11#029e8e2b2026-10-14
  • R25-11rel:R25-11#029e8e2b2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement
2026-08-10T14:00:00Zassistantnone → valid/auto-approvedÜberführung vorhandener Prosa-Beschreibung in requirement_text-Formatlegacy-desc-import

دالة LogVerbose [SWS_LOG_00069] Upstream: RS_LT_00003, RS_LT_00049

LogStream LogVerbose () const noexcept;

Same as Logger::LogFatal(). .

Same as Logger::LogFatal().

Validate requirementfunction LogVerbose [SWS_LOG_00069] Upstream: RS_LT_00003 , RS_LT_00049

Was muss freigegeben werden?

Bestätige, dass der folgende Requirement-Text fachlich korrekt ist, zur genannten API gehört und ohne irreführende Importartefakte veröffentlicht werden kann.

Same as Logger::LogFatal().

Prüfkontext

Review-Grund
Legacy-Beschreibung prüfen
Warum ist ein Review nötig?
Der Beschreibungstext wurde aus einer älteren Dokumentationsquelle übernommen und konnte nicht mit hoher Sicherheit gegen die aktuelle Spezifikation verifiziert werden.
API-Element
function LogVerbose [SWS_LOG_00069] Upstream: RS_LT_00003 , RS_LT_00049
Requirement-ID
SWS_LOG_00069
Flag-ID
SWS_LOG_00069
Status
pending
Konfidenz
medium
Herkunft
explicit
Modul
log
Spezifikationsdokument
AUTOSAR_AP_SWS_LogAndTrace
Text-Hash
6b761cd6688140661851a8d157f5a01f25a462a2ad60287da8b3bb533eaf19db
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 9f5912e056db المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الطريقة LogVerbose() الخاصة بالفئة ara::log::Logger من ملف الرأس #include "ara/log/logger.h" لإنشاء مخرجات السجل بأعلى مستويات التفصيل Verbose [SWS_LOG_00069]. لا يتم تمرير أي معلمات عند الاستدعاء. تُرجع الدالة بشكل متزامن كائن LogStream، والذي تم تهيئته صراحةً بمستوى الخطورة Verbose ويُستخدم لتمرير محتويات الرسالة [SWS_LOG_00069].

تُبيّن المواصفة أن السلوك مطابق لـ Logger::LogFatal() [SWS_LOG_00069]؛ وتفسير ذلك من المرجح أن يعني أن التخزين المؤقت وتوفير الدفق يتبعان آلية التسجيل العامة ويختلفان فقط في مستوى الخطورة المعين. سؤال Q-522523e7a845dc3a (مفتوح) بالنسبة لمعالجة الأخطاء، تم تحديد الطريقة بـ noexcept وكذلك exception safe [SWS_LOG_00069]. وبالتالي لا تحدث أي استثناءات، ولا توجد رموز خطأ محددة في سياق الاستدعاء [SWS_LOG_00069].

تنطبق الخصائص التالية فيما يتعلق بالتزامن وعقود الواجهة:

  • أمان مؤشرات الترابط: تم تصنيف الطريقة بـ thread-safe، بحيث يمكن تنفيذ الاستدعاءات المتزامنة عبر نفس مثيل Logger أو مثيلات مختلفة بأمان [SWS_LOG_00069].
  • الثبات: يضمن الإعلان بـ const ألا يغير الاستدعاء الحالة الداخلية لكائن Logger [SWS_LOG_00069].

تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى مواصفة AUTOSAR R25-11.

Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
LogStreamLogStream object of Verbose severity.

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

Record
AUTOSAR/AP/record/SWS_LOG_00069
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00069@rel:R25-11#8445b84e
Content hash
8445b84e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00069
Status: valid/auto-approved Version: rel:R25-11#224cde58 Versionshistorie & Revisions (3 transitions, 8 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00069@rel:R25-11#224cde58
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#fff230f02026-09-30
  • R19-11rel:R19-11#9dae6f922026-10-14
  • R20-11rel:R20-11#dbef81e22026-10-14
  • R21-11rel:R21-11#dbef81e22026-10-14
  • R22-11rel:R22-11#3f05c0c12026-10-14
  • R23-11rel:R23-11#a1a41d642026-10-14
  • R24-11rel:R24-11#224cde582026-10-14
  • R25-11rel:R25-11#224cde582026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement
2026-08-10T14:00:00Zassistantnone → valid/auto-approvedÜberführung vorhandener Prosa-Beschreibung in requirement_text-Formatlegacy-desc-import

دالة LogWarn [SWS_LOG_00066] Upstream: RS_LT_00003, RS_LT_00049

LogStream LogWarn () const noexcept;

Same as Logger::LogFatal(). .

Same as Logger::LogFatal().

Validate requirementfunction LogWarn [SWS_LOG_00066] Upstream: RS_LT_00003 , RS_LT_00049

Was muss freigegeben werden?

Bestätige, dass der folgende Requirement-Text fachlich korrekt ist, zur genannten API gehört und ohne irreführende Importartefakte veröffentlicht werden kann.

Same as Logger::LogFatal().

Prüfkontext

Review-Grund
Legacy-Beschreibung prüfen
Warum ist ein Review nötig?
Der Beschreibungstext wurde aus einer älteren Dokumentationsquelle übernommen und konnte nicht mit hoher Sicherheit gegen die aktuelle Spezifikation verifiziert werden.
API-Element
function LogWarn [SWS_LOG_00066] Upstream: RS_LT_00003 , RS_LT_00049
Requirement-ID
SWS_LOG_00066
Flag-ID
SWS_LOG_00066
Status
pending
Konfidenz
medium
Herkunft
explicit
Modul
log
Spezifikationsdokument
AUTOSAR_AP_SWS_LogAndTrace
Text-Hash
6b761cd6688140661851a8d157f5a01f25a462a2ad60287da8b3bb533eaf19db
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: a2b7f630e254 المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

يتم توفير الدالة العضو LogWarn الخاصة بالفئة ara::log::Logger عبر ملف الرأس ara/log/logger.h [SWS_LOG_00066]. يتم الاستدعاء بدون معلمات على مثيل Logger عبر التوقيع LogStream LogWarn () const noexcept; [SWS_LOG_00066]. كقيمة إرجاع، تُرجع الدالة بشكل متزامن كائنًا من النوع LogStream بمستوى الخطورة Warn (Warn severity) [SWS_LOG_00066]. ويتطابق السلوك الوظيفي مع وصف Logger::LogFatal() [SWS_LOG_00066]. تفسير: من المرجح أن يُستخدم كائن LogStream المُرجع لتجميع رسائل السجل ذات مستوى التحذير للإخراج اللاحق. سؤال Q-02b18df759926020 (مفتوح)

التزامن وأمان الاستثناءات

فيما يتعلق بسياق الاستدعاء والتزامن، فإن الطريقة محددة على أنها آمنة لمؤشرات الترابط (thread-safe) [SWS_LOG_00066]. وبالتالي يمكن استدعاؤها بأمان من عدة مؤشرات ترابط متزامنة على نفس المثيل. تضمن الدالة أمانًا كاملاً من الاستثناءات (exception safe) ومُعلنة بـ noexcept [SWS_LOG_00066]. لم يتم تعريف رموز خطأ محددة أو قيم خطأ أو إشارات إرجاع لأخطاء وقت التشغيل لهذه العملية [SWS_LOG_00066]؛ تفسير: من المرجح أن يكون فشل الإرجاع مستبعدًا في التشغيل العادي. سؤال Q-44b264cd97ff8159 (مفتوح)

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

Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
LogStreamLogStream object of Warn severity.

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

Record
AUTOSAR/AP/record/SWS_LOG_00066
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00066@rel:R25-11#4ba8d4e5
Content hash
4ba8d4e5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00066
Status: valid/auto-approved Version: rel:R25-11#9358c691 Versionshistorie & Revisions (3 transitions, 8 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00066@rel:R25-11#9358c691
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#662766fc2026-09-30
  • R19-11rel:R19-11#03c7fbf92026-10-14
  • R20-11rel:R20-11#76a8aeed2026-10-14
  • R21-11rel:R21-11#76a8aeed2026-10-14
  • R22-11rel:R22-11#18b12fe82026-10-14
  • R23-11rel:R23-11#7bd100f72026-10-14
  • R24-11rel:R24-11#a46364ad2026-10-14
  • R25-11rel:R25-11#9358c6912026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement
2026-08-10T14:00:00Zassistantnone → valid/auto-approvedÜberführung vorhandener Prosa-Beschreibung in requirement_text-Formatlegacy-desc-import

دالة LogWith [SWS_LOG_00133] Upstream: RS_LT_00003

template <typename... Attrs, typename MsgId, typename... Params> void LogWith (const std::tuple< Attrs... > &attrs, const MsgId &msg Id, const Params &... params) noexcept;

This function does not participate in overload resolution if any of Attrs... is not an "Attr" (TBD).

This function does not participate in overload resolution if any of Attrs.. is not an "Attr" (TBD).

Validate requirementfunction LogWith [SWS_LOG_00133] Upstream: RS_LT_00003

Was muss freigegeben werden?

Bestätige, dass der folgende Requirement-Text fachlich korrekt ist, zur genannten API gehört und ohne irreführende Importartefakte veröffentlicht werden kann.

This function does not participate in overload resolution if any of Attrs.. is not an "Attr" (TBD).

Prüfkontext

Review-Grund
Legacy-Beschreibung prüfen
Warum ist ein Review nötig?
Der Beschreibungstext wurde aus einer älteren Dokumentationsquelle übernommen und konnte nicht mit hoher Sicherheit gegen die aktuelle Spezifikation verifiziert werden.
API-Element
function LogWith [SWS_LOG_00133] Upstream: RS_LT_00003
Requirement-ID
SWS_LOG_00133
Flag-ID
SWS_LOG_00133
Status
pending
Konfidenz
medium
Herkunft
explicit
Modul
log
Spezifikationsdokument
AUTOSAR_AP_SWS_LogAndTrace
Text-Hash
a243b2c6e57f2f73f927a153f44f91bf1ae67a602c30125cc86c3eea679a6e42
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 1483d6ced588 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم دالة القالب LogWith للفئة ara::log::Logger للتسجيل المنظم للرسائل استناداً إلى مُعرّف بالإضافة إلى السمات والوسائط المرتبطة بها [SWS_LOG_00133]. ويتم تضمينها عبر ملف الترويسة #include "ara/log/logger.h" وتنفيذها بشكل متزامن بدون قيمة إرجاع [SWS_LOG_00133].

تقبل الدالة المعلمات التالية [SWS_LOG_00133]:

  • attrs: std::tuple يحتوي على سمات الرسالة (الأنواع Attrs...)،
  • msgId: مثيل معتمد على التنفيذ من النوع MsgId لتحديد كائن الرسالة،
  • params: وسائط متغيرة (الأنواع Params...)، والتي تتم إضافتها إلى مدخلة السجل.

التزامن والقيود

تم تحديد الدالة كـ thread-safe ويمكن تنفيذها بالتزامن [SWS_LOG_00133]. وهي مُعلنة بـ noexcept ومصنفة على أنها آمنة من الاستثناءات (exception safe)، ولذلك لا يتم إطلاق استثناءات C++ [SWS_LOG_00133]. لم يتم تعريف رموز أخطاء محددة أو رسائل خطأ.

ينطبق ما يلي على إنشاء مثيل القالب: لا تشارك الدالة في حل التحميل الزائد إذا كان نوع واحد على الأقل في Attrs... لا يمثل سمة رسالة مسموحاً بها [SWS_LOG_00133]. تفسير: نظراً لأن متطلب النوع Attr محدد في المواصفة بـ TBD، يُرجح أن يعتمد التحقق الفعلي من النوع على تنفيذ النظام الأساسي المعني. سؤال Q-30f5de483410d716 (مفتوح)

تم إنشاء ملاحظة الاستخدام هذه تلقائياً بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR Adaptive R25-11.

Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Template-Parameter

ParameterBeschreibung
AttrsMsgIdParamsthe types of attrs the type of msgId the types of the params

Parameter (in)

ParameterBeschreibung
attrsa std::tuple containing attributes of the message
msgIdan implementation-defined instance of type MsgId identifying the message object
paramsthe arguments to add to the message

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_LOG_00133
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00133@rel:R25-11#7869b783
Content hash
7869b783
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00133
Status: valid/auto-approved Version: rel:R25-11#e296e318 Versionshistorie & Revisions (3 transitions, 5 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00133@rel:R25-11#e296e318
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#3b2d94212026-09-30
  • R22-11rel:R22-11#20cc37b62026-10-14
  • R23-11rel:R23-11#b1a9eb922026-10-14
  • R24-11rel:R24-11#e296e3182026-10-14
  • R25-11rel:R25-11#e296e3182026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement
2026-08-10T14:00:00Zassistantnone → valid/auto-approvedÜberführung vorhandener Prosa-Beschreibung in requirement_text-Formatlegacy-desc-import

دالة Logger [SWS_LOG_00259] Upstream: RS_LT_00003, RS_LT_00046

Logger ()=delete;

Default destructor is deleted.

Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger

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

Record
AUTOSAR/AP/record/SWS_LOG_00259
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00259@rel:R25-11#fa8b38ff
Content hash
fa8b38ff
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00259
Status: valid/auto-approved Version: rel:R25-11#ba24b971 Versionshistorie & Revisions (2 transitions, 3 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00259@rel:R25-11#ba24b971
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#6ef2064e2026-09-30
  • R24-11rel:R24-11#ba24b9712026-10-14
  • R25-11rel:R25-11#ba24b9712026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement

دالة SetThreshold [SWS_LOG_00255] Upstream: RS_LT_00049

void SetThreshold (LogLevel threshold) noexcept;

Set log level threshold for this Logger instance.

Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
thresholdthe new threshold

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_LOG_00255
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00255@rel:R25-11#e750a862
Content hash
e750a862
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00255
Status: valid/auto-approved Version: rel:R25-11#938c1d1e Versionshistorie & Revisions (2 transitions, 5 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00255@rel:R25-11#938c1d1e
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#ca7a1d202026-09-30
  • R22-11rel:R22-11#4794419f2026-10-14
  • R23-11rel:R23-11#f81d87aa2026-10-14
  • R24-11rel:R24-11#3c712fb42026-10-14
  • R25-11rel:R25-11#938c1d1e2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement

دالة WithLevel [SWS_LOG_00131] Upstream: RS_LT_00003, RS_LT_00049

LogStream WithLevel (LogLevel logLevel) const noexcept;

Log message with a programmatically determined log level can be written.

Log message with a programmatically determined log level can be written.

Validate requirementfunction WithLevel [SWS_LOG_00131] Upstream: RS_LT_00003 , RS_LT_00049

Was muss freigegeben werden?

Bestätige, dass der folgende Requirement-Text fachlich korrekt ist, zur genannten API gehört und ohne irreführende Importartefakte veröffentlicht werden kann.

Log message with a programmatically determined log level can be written.

Prüfkontext

Review-Grund
Legacy-Beschreibung prüfen
Warum ist ein Review nötig?
Der Beschreibungstext wurde aus einer älteren Dokumentationsquelle übernommen und konnte nicht mit hoher Sicherheit gegen die aktuelle Spezifikation verifiziert werden.
API-Element
function WithLevel [SWS_LOG_00131] Upstream: RS_LT_00003 , RS_LT_00049
Requirement-ID
SWS_LOG_00131
Flag-ID
SWS_LOG_00131
Status
pending
Konfidenz
medium
Herkunft
explicit
Modul
log
Spezifikationsdokument
AUTOSAR_AP_SWS_LogAndTrace
Text-Hash
533885ce9a5d6d6f3bf7e754fa1f61a06e02ea3c245c387b83fdbdd73a2c6610
Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
logLevelthe log level to use for this LogStream instance

Rückgabewert

TypBeschreibung
LogStreama new LogStream instance with the given log level

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

Record
AUTOSAR/AP/record/SWS_LOG_00131
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00131@rel:R25-11#560ee2b2
Content hash
560ee2b2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00131
Status: valid/auto-approved Version: rel:R25-11#1d0dd1d6 Versionshistorie & Revisions (3 transitions, 7 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00131@rel:R25-11#1d0dd1d6
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#54fc7b202026-09-30
  • R20-11rel:R20-11#3cc4e6592026-10-14
  • R21-11rel:R21-11#3cc4e6592026-10-14
  • R22-11rel:R22-11#402b19352026-10-14
  • R23-11rel:R23-11#4af9bcd92026-10-14
  • R24-11rel:R24-11#1d0dd1d62026-10-14
  • R25-11rel:R25-11#1d0dd1d62026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement
2026-08-10T14:00:00Zassistantnone → valid/auto-approvedÜberführung vorhandener Prosa-Beschreibung in requirement_text-Formatlegacy-desc-import

دالة ~Logger [SWS_LOG_00260] Upstream: RS_LT_00003, RS_LT_00046

~Logger ();

Destructor .

Header-Datei#include "ara/log/logger.h"
Scopeclass ara::log::Logger
Exception-Sicherheitnot exception safe
Thread-Sicherheitthread-safe

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

Record
AUTOSAR/AP/record/SWS_LOG_00260
Status
valid/auto-approved
Version
AUTOSAR/AP/record/SWS_LOG_00260@rel:R25-11#864e312c
Content hash
864e312c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_LogAndTrace.pdf#nameddest=SWS_LOG_00260
Status: valid/auto-approved Version: rel:R25-11#1cf92e85 Versionshistorie & Revisions (2 transitions, 3 revision)
Current State
valid/auto-approved
Reason
unchanged
Campaign
2026-08-sws-log-pilot-after-tool-improvement
Active Version
AUTOSAR/AP/record/SWS_LOG_00260@rel:R25-11#1cf92e85
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#7b839fb82026-09-30
  • R24-11rel:R24-11#1cf92e852026-10-14
  • R25-11rel:R25-11#1cf92e852026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-10toolvalid/unversioned → invalid/obsoletespec update after tool improvement2026-08-sws-log-pilot-after-tool-improvement
2026-08-10toolinvalid/obsolete → valid/auto-approvedunchanged2026-08-sws-log-pilot-after-tool-improvement