التحقق من وجود مفتاح في map في Go: دليل شامل

صيد المفاتيح: كيف لا تضيع في غابة Go map

تخيل: أنت تكتب خدمة مصغرة بلغة Go. تحتاج إلى التحقق بسرعة مما إذا كان المستخدم مسجلاً في النظام. تصل إلى map، حيث المفتاح هو معرف المستخدم، والقيمة هي ملفه الشخصي. وهنا يطرح السؤال: هل يوجد هذا المفتاح أصلاً في map؟

إذا كنت قادماً من Python أو JavaScript، فأنت معتاد على أن الوصول إلى مفتاح غير موجود قد يلقي استثناءً أو يعيد undefined. في Go الأمر مختلف. لا توجد استثناءات هنا، ولكن هناك آلية أنيقة خاصة بها. وإذا حاولت قراءة قيمة بمفتاح غير موجود، فلن يتعطل Go، بل سيعيد ببساطة القيمة الصفرية لنوع القيمة.

يبدو هذا مريحاً؟ نعم، لكنه أيضاً فخ. كيف تميز بين حالة "المفتاح غير موجود" وحالة "المفتاح موجود لكن قيمته صفرية"؟ لهذا بالضبط يوجد أسلوب اصطلاحي خاص — comma ok idiom. دعنا نفهمه مرة واحدة وإلى الأبد.

كيف تعمل map في Go: نبذة مختصرة

قبل الغوص في عمليات التحقق، دعنا نتذكر ما هي map في Go. هي جدول تجزئة يخزن أزواج مفتاح-قيمة. صيغة التصريح:

// التصريح عن map: المفاتيح نصوص، والقيم أعداد صحيحة\nvar scores map[string]int\n\n// تهيئة map فارغة (إلزامي!)\nscores = make(map[string]int)\n\n// أو مباشرة مع بيانات\nscores := map[string]int{\n    "Alice": 95,\n    "Bob":   87,\n}

نقطة مهمة: إذا حاولت كتابة قيمة في map غير مهيأة (nil map)، سيتعطل البرنامج مع panic. لا تفعل هذا أبداً!

الطريقة الرئيسية: الإسناد ذو القيمتين (comma ok idiom)

هذه هي الطريقة الأصح والأكثر اصطلاحية للتحقق مما إذا كان المفتاح موجوداً في map في Go.

الصيغة كالتالي:

value, ok := myMap[key]

هنا:

\n
• value — القيمة المقابلة للمفتاح (أو القيمة الصفرية إذا كان المفتاح غير موجود)
\n
• ok — متغير منطقي يساوي true إذا كان المفتاح موجوداً، و false إذا لم يكن موجوداً
\n

دعنا نلقي نظرة على مثال كامل:

package main\n\nimport "fmt"\n\nfunc main() {\n    // إنشاء map بدرجات الطلاب\n    grades := map[string]int{\n        "ماريا": 88,\n        "بيتر":  92,\n        "آنا":  0, // نعم، آنا لديها 0 درجة\n    }\n\n    // التحقق من المفتاح "بيتر"\n    if grade, ok := grades["بيتر"]; ok {\n        fmt.Printf("درجة بيتر: %d\\n", grade)\n    } else {\n        fmt.Println("بيتر غير موجود في القائمة")\n    }\n\n    // التحقق من المفتاح "إيفان"\n    if grade, ok := grades["إيفان"]; ok {\n        fmt.Printf("درجة إيفان: %d\\n", grade)\n    } else {\n        fmt.Println("إيفان غير موجود في القائمة")\n    }\n\n    // حالة معقدة: المفتاح "آنا" موجود لكن القيمة 0\n    if grade, ok := grades["آنا"]; ok {\n        fmt.Printf("درجة آنا: %d\\n", grade) // سيطبع: درجة آنا: 0\n    }\n}

لاحظ: بالنسبة لمفتاح "آنا"، سيكون ok مساوياً true، على الرغم من أن القيمة صفرية. لهذا السبب لا يمكن الاعتماد فقط على التحقق من القيمة!

لماذا لا يمكن ببساطة المقارنة مع القيمة الصفرية؟

يرتكب العديد من المبتدئين هذا الخطأ. يكتبون شيئاً مثل:

if grades["إيفان"] != 0 {\n    fmt.Println("إيفان موجود في القائمة!")\n}

هذا غير صحيح لسببين:

\n
• للأنواع الرقمية: إذا كان إيفان لديه بالفعل درجة 0، فستتجاهله.
\n
• للأنواع الأخرى: القيمة الصفرية قد تكون نصاً فارغاً ("")، أو false، أو nil. لن تتمكن من التمييز بين "لا يوجد مفتاح" و"المفتاح موجود لكن القيمة فارغة".
\n

الطريقة الوحيدة الموثوقة هي استخدام comma ok idiom.

التحقق من وجود المفتاح دون الحصول على القيمة

أحياناً تحتاج فقط إلى معرفة ما إذا كان المفتاح موجوداً، دون الحاجة إلى القيمة نفسها