ERR_ERROR_STRING(3ssl)

الاسم
ERR_error_string, ERR_error_string_n, ERR_lib_error_string, ERR_func_error_string, ERR_reason_error_string - الحصول على رسالة خطأ مقروءة بشريًا

موجز
 #include <openssl/err.h>

 char *ERR_error_string(unsigned long e, char *buf);
 void ERR_error_string_n(unsigned long e, char *buf, size_t len);

 const char *ERR_lib_error_string(unsigned long e);
 const char *ERR_reason_error_string(unsigned long e);

مُهمَل في OpenSSL 3.0:

 const char *ERR_func_error_string(unsigned long e);

الوصف
تولد الدالة ERR_error_string() سلسلة محارف مقروءة بشريًا تمثل رمز الخطأ e، وتضعها في buf. يجب أن يكون طول buf 256 بايت على الأقل. إذا كان buf هو NULL، توضع سلسلة الخطأ في مخزن مؤقت ثابت. لاحظ أن هذه الدالة ليست آمنة للخيوط ولا تتحقق من حجم المخزن المؤقت؛ استخدم ERR_error_string_n() بدلاً منها.

ERR_error_string_n() هي متغير من ERR_error_string() يكتب على الأكثر len حرفًا (بما في ذلك الصفر الختامي) ويقوم باقتطاع السلسلة إذا لزم الأمر. بالنسبة لـ ERR_error_string_n()، يجب ألا يكون buf NULL.

ستكون السلسلة بالتنسيق التالي:

 error:[error code]:[library name]::[reason string]

رمز الخطأ هو رقم سداسي عشري مكون من 8 أرقام، واسم المكتبة وسلسلة السبب هما نص ASCII.

ترجع ERR_lib_error_string() و ERR_reason_error_string() اسم المكتبة وسلسلة السبب على التوالي.

إذا لم تكن هناك سلسلة نصية مسجلة لرمز الخطأ المعطى، فستحتوي سلسلة الخطأ على الرمز الرقمي.

يمكن استخدام ERR_print_errors(3) لطباعة جميع رموز الخطأ الموجودة حاليًا في الطابور.

القيم المُرجعة
ترجع ERR_error_string() مؤشرًا إلى مخزن مؤقت ثابت يحتوي على السلسلة إذا كان buf == NULL، وإلا ترجع buf.

ترجع ERR_lib_error_string() و ERR_reason_error_string() السلاسل، و NULL إذا لم يُسجل أي شيء لرمز الخطأ.

ترجع ERR_func_error_string() NULL.

انظر أيضًا
ERR_get_error(3), ERR_print_errors(3)

التاريخ
أصبحت ERR_func_error_string() مُهمَلة في OpenSSL 3.0.

حقوق النسخ
حقوق النشر 2000-2017 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة.

مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“). لا يجوز لك استخدام هذا الملف إلا وفقًا لشروط الرخصة. يمكنك الحصول على نسخة منها في الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط <https://www.openssl.org/source/license.html>.

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.