لغة Go بالأمثلة: توجيه التضمين (//go:embed)

//go:embed هو توجيه للمترجم يتيح للبرامج تضمين أي ملفات ومجلدات في ملف Go التنفيذي عند وقت البناء. اقرأ المزيد عن توجيه embed هنا.

 
package main

استورد الحزمة embed. إذا لم تستخدم أي معرّفات مصدّرة من هذه الحزمة، فيمكنك إجراء استيراد فارغ باستخدام _ "embed".

 
import (
    "embed"
)

تقبل توجيهات embed مسارات نسبية إلى المجلد الذي يحتوي على ملف Go المصدري. يضمّن هذا التوجيه محتويات الملف في متغير string الذي يليه مباشرة.

 
//go:embed folder/single_file.txt
var fileString string

أو ضمّن محتويات الملف في قيمة []byte.

 
//go:embed folder/single_file.txt
var fileByte []byte

يمكننا أيضًا تضمين عدة ملفات، أو حتى مجلدات، باستخدام محارف البدل. يستخدم ذلك متغيرًا من النوع embed.FS، الذي ينفذ نظام ملفات افتراضيًا بسيطًا.

 
//go:embed folder/single_file.txt
//go:embed folder/*.hash
var folder embed.FS
 
func main() {

اطبع محتويات single_file.txt.

 
    print(fileString)
    print(string(fileByte))

استرجع بعض الملفات من المجلد المضمّن.

 
    content1, _ := folder.ReadFile("folder/file1.hash")
    print(string(content1))
 
    content2, _ := folder.ReadFile("folder/file2.hash")
    print(string(content2))
}

استخدم هذه الأوامر لتشغيل المثال. (ملاحظة: بسبب قيود Go Playground، لا يمكن تشغيل هذا المثال إلا على جهازك المحلي.)

 
$ mkdir -p folder
$ echo "hello go" > folder/single_file.txt
$ echo "123" > folder/file1.hash
$ echo "456" > folder/file2.hash
 
$ go run embed-directive.go
hello go
hello go
123
456

المثال التالي: .

إعداد Mark McGranaghan وEli Bendersky المصدر الأصلي الرخصة
الترجمة العربية بواسطة 0xKa الموقع الشخصي مصدر الترجمة