مكتبة cast في Go: دليل شامل لتحويل الأنواع

في لغة Go، الكتابة الثابتة الصارمة (Static Typing) هي قوة وتحدٍ في آن واحد. فمن ناحية، يكتشف المترجم العديد من الأخطاء أثناء مرحلة البناء، ومن ناحية أخرى، يضطر المطور لكتابة كود مطول لتحويل الأنواع، خاصة عند التعامل مع البيانات من مصادر خارجية مثل JSON و YAML وقواعد البيانات وطلبات HTTP. مكتبة cast من Spf13 (مؤلف مكتبتي Cobra و Viper) تحل هذه المشكلة بأناقة وإيجاز.

توفر cast مجموعة من الدوال لتحويل الواجهات (interface{}) إلى أنواع Go محددة بشكل آمن وسهل. بدلاً من كتابة أكواد معقدة باستخدام تأكيد النوع (type assertion) والتحقق من الأخطاء، يمكنك استدعاء دالة واحدة تقوم بإرجاع قيمة افتراضية أو خطأ إذا كان التحويل غير ممكن. هذا مفيد بشكل خاص عند العمل مع الإعدادات، وتحليل استجابات API، وأي سيناريو يكون فيه نوع البيانات معروفًا فقط أثناء وقت التشغيل.

المكتبة لا تستخدم الانعكاس (Reflection) في كل استدعاء (على الرغم من أن بعض الدوال تعتمد عليه للتحويلات المعقدة)، وهي مصممة لتكون عالية الأداء في الحالات النمطية. وهي جزء من نظام Viper البيئي، ولكن يمكن استخدامها كأداة مستقلة. إذا كنت تكتب بلغة Go وتواجه الحاجة لتحويل النصوص إلى أرقام، أو الواجهات إلى شرائح (slices)، أو الخرائط (maps) إلى هياكل (structs)، فإن cast ستصبح مساعدك الذي لا غنى عنه.

التثبيت

يتم تثبيت المكتبة باستخدام الأداة القياسية go get. قم بتنفيذ الأمر التالي في الطرفية داخل مشروع Go الخاص بك:

go get github.com/spf13/cast

بعد تنفيذ الأمر، ستتم إضافة المكتبة إلى ملف go.mod وتكون جاهزة للاستخدام. تأكد من أن لديك Go الإصدار 1.16 أو أعلى (يُوصى بالإصدار 1.18+ لدعم الـ Generics، على الرغم من أن cast لا تستخدمها).

بداية سريعة

لنلقِ نظرة على مثال عملي بسيط يوضح الإمكانيات الأساسية للمكتبة: تحويل نص إلى عدد صحيح وتحويل واجهة إلى نص.

package main

import (
    "fmt"
    "github.com/spf13/cast"
)

func main() {
    // تحويل نص إلى int
    num, err := cast.ToIntE("42")
    if err != nil {
        fmt.Println("خطأ:", err)
        return
    }
    fmt.Printf("العدد: %d (النوع: %T)\n", num, num)

    // تحويل interface{} إلى نص
    var val interface{} = "مرحبا بالعالم"
    str := cast.ToString(val)
    fmt.Printf("النص: %s (النوع: %T)\n", str, str)

    // تحويل مع قيمة افتراضية (بدون خطأ)
    safeNum := cast.ToInt("ليس رقماً") // سيعيد 0
    fmt.Printf("العدد الآمن: %d\n", safeNum)
}

كما ترى، الكود نظيف وواضح. الدوال التي تنتهي باللاحقة E تعيد خطأ، بينما الدوال بدون اللاحقة تعيد القيمة الصفرية (Zero Value) عند الفشل.

الدوال والطرق الأساسية

تقدم مكتبة cast مجموعة واسعة من الدوال للتعامل مع أنواع البيانات المختلفة. فيما يلي أكثر من 8 دوال رئيسية مع الشرح والأمثلة.

1. ToString

التوقيع: func ToString(i interface{}) string

الوظيفة: تحويل القيمة المُمررة إلى نص. تدعم الأنواع الرقمية، القيم المنطقية، شرائح البايت، النصوص والواجهات.

package main

import (
    "fmt"
    "github.com/spf13/cast"
)

func main() {
    fmt.Println(cast.ToString(123))          // "123"
    fmt.Println(cast.ToString(45.67))        // "45.67"
    fmt.Println(cast.ToString(true))         // "true"
    fmt.Println(cast.ToString([]byte("go"))) // "go"
    fmt.Println(cast.ToString(nil))          // ""
}