BN_CTX_START(3SSL)

الاسم
BN_CTX_start، BN_CTX_get، BN_CTX_end - استخدام متغيرات BIGNUM مؤقتة

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

 void BN_CTX_start(BN_CTX *ctx);

 BIGNUM *BN_CTX_get(BN_CTX *ctx);

 void BN_CTX_end(BN_CTX *ctx);

الوصف
تُستخدم هذه الدوال للحصول على متغيرات BIGNUM مؤقتة من BN_CTX (التي يمكن إنشاؤها باستخدام BN_CTX_new(3)) لتوفير عبء الإنشاء والتحرير المتكرر لـ BIGNUM في دوال تُستدعى من داخل حلقة.

يجب أن تستدعي الدالة BN_CTX_start() أولاً. ثم يمكن استدعاء BN_CTX_get() بشكل متكرر للحصول على BIGNUM مؤقتة. يجب إجراء جميع استدعاءات BN_CTX_get() قبل استدعاء أي دوال أخرى تستخدم ctx كوسيط.

أخيراً، يجب استدعاء BN_CTX_end() قبل العودة من الدالة. إذا كان ctx فارغاً (NULL)، لا يُفعل شيء. عند استدعاء BN_CTX_end()، تصبح مؤشرات BIGNUM التي حُصل عليها من BN_CTX_get() غير صالحة.

القيم المُرجعة
لا تُرجع BN_CTX_start() و BN_CTX_end() أي قيم.

تُرجع BN_CTX_get() مؤشراً إلى BIGNUM، أو NULL عند الخطأ. بمجرد فشل BN_CTX_get()، ستُعيد الاستدعاءات اللاحقة NULL أيضاً، لذا يكفي التحقق من قيمة الإرجاع لآخر استدعاء BN_CTX_get(). في حالة حدوث خطأ، يُضبط رمز خطأ يمكن الحصول عليه بواسطة ERR_get_error(3).

انظر أيضًا
BN_CTX_new(3)

حقوق النسخ
حقوق الطبع والنشر 2000-2016 لمؤلفي مشروع 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.