قراءة وكتابة الملفات

قراءة وكتابة الملفات — File I/O

التعامل مع الملفات مهارة أساسية في أي لغة. Go توفر حزماً قوية وبسيطة: os للعمليات الأساسية، bufio للقراءة المُخزنة، وio لعمليات الإدخال/الإخراج العامة.

قراءة ملف كاملاً

أبسط طريقة لقراءة ملف:

main.go

package main

import (
    "fmt"
    "os"
)

func main() {
    // سنُحاكي قراءة ملف — Simulating file read
    // في الواقع: data, err := os.ReadFile("config.txt")
    
    // لنكتب ملف أولاً ثم نقرأه — Write then read
    content := []byte("بسم الله الرحمن الرحيم\nهذا ملف تجريبي\nسطر ثالث")
    
    // كتابة — Write file
    err := os.WriteFile("/tmp/test.txt", content, 0644)
    if err != nil {
        fmt.Println("خطأ في الكتابة:", err)
        return
    }
    fmt.Println("✅ كُتب الملف بنجاح")
    
    // قراءة — Read file
    data, err := os.ReadFile("/tmp/test.txt")
    if err != nil {
        fmt.Println("خطأ في القراءة:", err)
        return
    }
    
    fmt.Println("\n📄 محتوى الملف:")
    fmt.Println(string(data))
    
    // حذف — Cleanup
    os.Remove("/tmp/test.txt")
}

Output:

القراءة سطراً بسطر

للملفات الكبيرة، القراءة سطراً بسطر أفضل من تحميل الملف كاملاً:

main.go

package main

import (
    "bufio"
    "fmt"
    "os"
    "strings"
)

func main() {
    // إنشاء ملف تجريبي — Create test file
    lines := []string{
        "الرياض:7500000",
        "جدة:4600000",
        "المدينة المنورة:1500000",
        "مكة المكرمة:2000000",
        "الدمام:1200000",
    }
    
    content := strings.Join(lines, "\n")
    os.WriteFile("/tmp/cities.txt", []byte(content), 0644)
    
    // قراءة سطراً بسطر — Read line by line
    file, err := os.Open("/tmp/cities.txt")
    if err != nil {
        fmt.Println("خطأ:", err)
        return
    }
    defer file.Close() // ⚡ defer يضمن إغلاق الملف
    
    fmt.Println("🏙️ المدن السعودية:")
    scanner := bufio.NewScanner(file)
    lineNum := 0
    for scanner.Scan() {
        lineNum++
        line := scanner.Text()
        parts := strings.Split(line, ":")
        if len(parts) == 2 {
            fmt.Printf("  %d. %s — %s نسمة\n", lineNum, parts[0], parts[1])
        }
    }
    
    if err := scanner.Err(); err != nil {
        fmt.Println("خطأ في القراءة:", err)
    }
    
    os.Remove("/tmp/cities.txt")
}

Output:

الكتابة المتقدمة

main.go

package main

import (
    "bufio"
    "fmt"
    "os"
)

func main() {
    // إنشاء ملف — Create file
    file, err := os.Create("/tmp/output.txt")
    if err != nil {
        fmt.Println("خطأ:", err)
        return
    }
    defer file.Close()
    
    // كتابة باستخدام bufio (أسرع للكتابة المتكررة)
    writer := bufio.NewWriter(file)
    
    // كتابة جدول الضرب — Multiplication table
    for i := 1; i <= 5; i++ {
        for j := 1; j <= 5; j++ {
            fmt.Fprintf(writer, "%d×%d=%d\t", i, j, i*j)
        }
        fmt.Fprintln(writer)
    }
    
    // ⚠️ مهم: flush لضمان كتابة كل البيانات
    writer.Flush()
    fmt.Println("✅ كُتب جدول الضرب")
    
    // التحقق — Verify
    data, _ := os.ReadFile("/tmp/output.txt")
    fmt.Println("\n📄 المحتوى:")
    fmt.Println(string(data))
    
    os.Remove("/tmp/output.txt")
}

Output:

الإلحاق بملف (Append)

// فتح ملف للإلحاق — Open for append
file, err := os.OpenFile("log.txt", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
if err != nil {
    log.Fatal(err)
}
defer file.Close()

file.WriteString("سطر جديد\n")

أعلام os.OpenFile:

العلم	المعنى
`os.O_RDONLY`	قراءة فقط
`os.O_WRONLY`	كتابة فقط
`os.O_RDWR`	قراءة وكتابة
`os.O_CREATE`	إنشاء إذا لم يوجد
`os.O_APPEND`	إلحاق بالنهاية
`os.O_TRUNC`	مسح المحتوى

مشروع: معالج ملفات CSV بسيط

main.go

package main

import (
    "fmt"
    "os"
    "strings"
)

type Student struct {
    Name  string
    Grade string
    Score string
}

func main() {
    // إنشاء CSV — Create CSV
    csv := `الاسم,الدرجة,العلامة
أحمد,A,95
سارة,A,92
عمر,B,85
فاطمة,A,98
خالد,B,78`
    
    os.WriteFile("/tmp/students.csv", []byte(csv), 0644)
    
    // قراءة وتحليل — Read and parse
    data, _ := os.ReadFile("/tmp/students.csv")
    lines := strings.Split(string(data), "\n")
    
    var students []Student
    for i, line := range lines {
        if i == 0 {
            continue // تخطي العنوان — Skip header
        }
        parts := strings.Split(line, ",")
        if len(parts) == 3 {
            students = append(students, Student{
                Name:  parts[0],
                Grade: parts[1],
                Score: parts[2],
            })
        }
    }
    
    // عرض — Display
    fmt.Println("📊 تقرير الطلاب")
    fmt.Println(strings.Repeat("=", 30))
    
    gradeCount := make(map[string]int)
    for _, s := range students {
        fmt.Printf("  %s — درجة %s (علامة: %s)\n", s.Name, s.Grade, s.Score)
        gradeCount[s.Grade]++
    }
    
    fmt.Println(strings.Repeat("=", 30))
    fmt.Println("📈 الإحصائيات:")
    for grade, count := range gradeCount {
        fmt.Printf("  درجة %s: %d طلاب\n", grade, count)
    }
    fmt.Printf("  المجموع: %d طلاب\n", len(students))
    
    os.Remove("/tmp/students.csv")
}

Output:

التعامل مع المجلدات

main.go

package main

import (
    "fmt"
    "os"
)

func main() {
    // إنشاء مجلد — Create directory
    err := os.MkdirAll("/tmp/azlearn-test/sub", 0755)
    if err != nil {
        fmt.Println("خطأ:", err)
        return
    }
    fmt.Println("✅ أُنشئ المجلد")
    
    // إنشاء ملفات — Create files
    os.WriteFile("/tmp/azlearn-test/file1.txt", []byte("ملف ١"), 0644)
    os.WriteFile("/tmp/azlearn-test/file2.txt", []byte("ملف ٢"), 0644)
    os.WriteFile("/tmp/azlearn-test/sub/file3.txt", []byte("ملف ٣"), 0644)
    
    // قراءة محتوى المجلد — Read directory
    entries, _ := os.ReadDir("/tmp/azlearn-test")
    fmt.Println("\n📁 محتوى المجلد:")
    for _, entry := range entries {
        icon := "📄"
        if entry.IsDir() {
            icon = "📁"
        }
        info, _ := entry.Info()
        fmt.Printf("  %s %s (%d بايت)\n", icon, entry.Name(), info.Size())
    }
    
    // التحقق من وجود ملف — Check if exists
    if _, err := os.Stat("/tmp/azlearn-test/file1.txt"); err == nil {
        fmt.Println("\n✅ file1.txt موجود")
    }
    
    // تنظيف — Cleanup
    os.RemoveAll("/tmp/azlearn-test")
    fmt.Println("🗑️ تم التنظيف")
}

Output:

نصائح مهمة

دائماً استخدم defer file.Close() — لضمان إغلاق الملف
تحقق من الأخطاء — كل عملية ملفات قد تفشل
استخدم bufio للملفات الكبيرة — لا تحمّل ملف 1GB في الذاكرة
أذونات الملفات: 0644 = القراءة/الكتابة للمالك، القراءة فقط للباقين
os.ReadFile/os.WriteFile للعمليات البسيطة، os.Open/os.Create للتحكم الكامل

تحدي — Challenge

package main

import (
    "fmt"
    "os"
    "strings"
)

func main() {
    // اكتب 5 أسطر في ملف ثم عُد الأسطر
    content := "سطر ١\nسطر ٢\nسطر ٣\nسطر ٤\nسطر ٥"
    os.WriteFile("/tmp/count.txt", []byte(content), 0644)
    
    // اقرأ الملف وقسّمه بـ "\n" ثم اطبع عدد الأسطر
    // اكتب الكود هنا
    
    os.Remove("/tmp/count.txt")
}