وحدة ماكرو CUDA_CHECK قابلة لإعادة الاستخدام

تؤدي كتابة عبارة if بعد كل استدعاء CUDA إلى فوضى سريعة في الشيفرة. ويعالج macro‏ CUDA_CHECK ذلك في سطر واحد نظيف. 🧹

تريد تغليف أي استدعاء، والحصول على رمز إرجاعه، والتوقف بوضوح إذا فشل. ويمكن لـ macro واحد تنفيذ ذلك في كل مكان.

يخزّن الـ macro داخله نتيجة الاستدعاء في متغير محلي من النوع cudaError_t حتى يمكن فحصها مرة واحدة دون استدعائها مرتين.

ثم يختبر الرمز مقابل cudaSuccess. إذا تطابقا، لا يحدث شيء ويتابع البرنامج عمله بصورة طبيعية.

عند الفشل، يطبع رسالة مقروءة باستخدام __FILE__ و __LINE__، فتنتقل مباشرةً إلى السطر المسبب للمشكلة.

يُغلّف الجسم داخل do-while(0). ويجعل ذلك الـ macro عبارة واحدة تعمل بأمان حتى داخل if بلا أقواس.

عند جمع الأجزاء، تحصل على شبكة أمان صغيرة قابلة لإعادة الاستخدام، ويمكنك لصقها في ترويسة أي مشروع CUDA.

استخدمه مع أي استدعاء يعيد رمزًا: cudaMalloc و cudaMemcpy و cudaFree. فغلاف واحد يحميها جميعًا بطريقة موحّدة.

لا تعيد kernels شيئًا، لذا غلّف cudaGetLastError ومزامنةً بعد الإطلاق بدلًا من تغليف سطر الإطلاق نفسه.

ضع الـ macro في ترويسة مشتركة حتى يستخدم كل ملف الفحص نفسه. ويوفر الاتساق هنا ساعات من تصحيح الأخطاء المربك.

المكسب الأكبر هو الفشل السريع: فعند تعطل استدعاء، تحصل فورًا على الملف والسطر والرسالة بدقة بدلًا من بيانات تالفة صامتة.

يلتقط macro‏ CUDA_CHECK الرمز، ويقارنه بالنجاح، ويطبع الملف والسطر عند الفشل. عرّفه مرة واحدة واستخدمه في كل مكان. 🎉