واجهة الـ `error`
جزء من قسم Fundamentals في رحلة GO على Coddy — الدرس 103 من 109.
في لغة Go، تعتبر واجهة error نوعاً مدمجاً يمثل حالات الخطأ. أي نوع يقوم بتنفيذ التابع Error() يحقق هذه الواجهة.
إليك تعريف واجهة الخطأ (error interface):
type error interface {
Error() string
}إنشاء نوع خطأ مخصص:
type MyError struct {
Message string
}
func (e MyError) Error() string {
return e.Message
}
func main() {
err := MyError{Message: "something went wrong"}
fmt.Println(err)
}سيكون الناتج:
something went wrong
التحدي
سهلفي هذا التحدي، ستعمل مع واجهة error في لغة Go. تحتاج إلى إنشاء خطأ مخصص باستخدام دالة errors.New() ثم التحقق مما إذا كان هناك خطأ موجود.
يحتوي الكود بالفعل على دالة تُرجع خطأً. مهمتك هي التحقق مما إذا كان الخطأ ليس nil وطباعة رسالة مناسبة.
ورقة مرجعية
واجهة error هي نوع مدمج يمثل حالات الخطأ. أي نوع يقوم بتنفيذ التابع Error() يحقق هذه الواجهة:
type error interface {
Error() string
}إنشاء نوع خطأ مخصص:
type MyError struct {
Message string
}
func (e MyError) Error() string {
return e.Message
}
func main() {
err := MyError{Message: "something went wrong"}
fmt.Println(err) // المخرجات: something went wrong
}استخدم errors.New() لإنشاء أخطاء بسيطة والتحقق مما إذا كان الخطأ ليس nil.
جرّب بنفسك
package main
import (
"errors"
"fmt"
)
func main() {
// هذه الدالة تعيد خطأ
err := generateError()
// TODO: تحقق مما إذا كان err ليس nil
// إذا كان err ليس nil، اطبع: "Error occurred: " متبوعاً برسالة الخطأ
// تلميح: استخدم جملة if للتحقق مما إذا كان err != nil
// سيتم تنفيذ هذا السطر فقط في حال عدم حدوث خطأ
fmt.Println("Program completed successfully")
}
// هذه الدالة تولد خطأ
func generateError() error {
return errors.New("something went wrong")
}
اختبر نفسكيتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس Fundamentals
4معاملات المقارنة والمعاملات المنطقية
معاملات المقارنة - الجزء 1معاملات المقارنة - الجزء 2معامل AND المنطقيمعامل OR المنطقيمعامل NOT المنطقيأساسيات أولوية المعاملاتملخص - إجراء المقارنات7تدفق التحكم: الحلقات التكرارية
شرح حلقة `for`حلقة `for` - أساسياتحلقة `for` - بشرط فقطالكلمة المفتاحية `break`الكلمة المفتاحية `continue`الحلقات المتداخلةملخص - تكرار العمليات2المتغيرات وأنواع البيانات الأساسية
ما هو المتغير؟استنتاج النوع باستخدام `:=`الأعداد الصحيحة (int)أرقام الفاصلة العائمةالقيم المنطقية (Booleans)النصوص (Strings)القيم الصفريةالثوابتقواعد التسميةملخص - المتغيرات والأنواع5الإدخال والإخراج الأساسي
المخرجات المنسقةرموز التنسيقطباعة الأنواعالحصول على مدخلات المستخدم الأساسيةملخص - الإدخال والإخراج8الدوال
فهم الدوالالتصريح عن دالةاستدعاء الدوالمعاملات الدالةإرجاع قيمة واحدةإرجاع قيم متعددةقيم الإرجاع المسماةأساسيات نطاق الدالةملخص - إنشاء كود قابل لإعادة الاستخدام11الأنواع المركبة: الشرائح
مقدمة إلى الشرائحالتصريح عن القيم المباشرة للشرائحإنشاء الشرائح باستخدام `make`طول الشريحة مقابل سعتهاالوصول إلى عناصر الشريحةإضافة العناصراقتطاع الشرائح/المصفوفات الموجودةالتكرار عبر الشرائحنسخ الشرائحملخص - القوائم الديناميكية14التعامل الأساسي مع الأخطاء
مفهوم الأخطاءواجهة الـ `error`الدوال التي تعيد أخطاءالتحقق من الأخطاءإنشاء أخطاء بسيطةإنشاء أخطاء منسقةالتعامل الأساسي مع الأخطاءملخص - معالجة المشكلات3المعاملات الأساسية
المعاملات الحسابيةمعامل القسمةمعامل باقي القسمةمعامل التعيينمعاملات التعيين المركبةالزيادة والنقصانملخص - الحسابات6تدفق التحكم: الجمل الشرطية
جملة `if`الكلمة المفتاحية `else`الكلمة المفتاحية `else if`تظليل المتغيرات في `if`تهيئة المتغيراتجملة `switch``switch` مع التعبيرات`switch` بدون تعبيرالكلمة المفتاحية `fallthrough`ملخص - اتخاذ القرارات