دليلتعليمبداية

ابدأ مع كنوز — دليل البداية السريعة

٢١ مارس ٢٠٢٦فريق كنوز

ابدأ مع كنوز — دليل البداية السريعة

1. التثبيت

Linux / macOS

افتح الطرفية (Terminal) وانسخ هذا الأمر:

curl -fsSL https://sh.knoz.dev | sh

سيُثبّت كنوز تلقائياً ويُضيفها إلى مسار النظام.

تحقق من التثبيت

knoz --version

يجب أن ترى: knoz 1.0.0-beta

التحميل اليدوي

يمكنك تحميل الملفات مباشرة من صفحة الإصدارات.

2. أول برنامج

أنشئ ملفاً جديداً باسم مرحبا.كنز:

دالة رئيسية() {
    اطبع("مرحباً بالعالم!");
}

ثم شغّله:

knoz شغل مرحبا.كنز

النتيجة:

مرحباً بالعالم!

3. المتغيرات والأنواع

كنوز تدعم أنواعاً أساسية واضحة:

دالة رئيسية() {
    // الأعداد الصحيحة
    دع عمر: صحيح = 25;
    
    // الأعداد العشرية
    دع درجة: عشري = 98.5;
    
    // النصوص
    دع اسم: نص = "أحمد";
    
    // القيم المنطقية
    دع ناجح: منطقي = صحيح;
    
    اطبع("الاسم: " + اسم);
    اطبع("العمر: " + صحيح_لنص(عمر));
}

4. الشروط والحلقات

الشروط

دالة رئيسية() {
    دع درجة = 85;
    
    إذا (درجة >= 90) {
        اطبع("ممتاز!");
    } وإلا_إذا (درجة >= 80) {
        اطبع("جيد جداً!");
    } وإلا {
        اطبع("استمر في المحاولة!");
    }
}

الحلقات

دالة رئيسية() {
    // حلقة تكرارية
    لكل ي في 1..6 {
        اطبع("العدد: " + صحيح_لنص(ي));
    }
    
    // حلقة شرطية
    دع_متغير عداد = 0;
    طالما (عداد < 5) {
        اطبع("العداد: " + صحيح_لنص(عداد));
        عداد = عداد + 1;
    }
}

5. الدوال

دالة جمع(أ: صحيح, ب: صحيح) -> صحيح {
    أرجع أ + ب;
}

دالة تحية(اسم: نص) {
    اطبع("مرحباً يا " + اسم + "!");
}

دالة رئيسية() {
    دع ناتج = جمع(10, 20);
    اطبع("المجموع: " + صحيح_لنص(ناتج));
    
    تحية("أحمد");
}

6. الهياكل (Structs)

هيكل شخص {
    الاسم: نص,
    العمر: صحيح,
}

تنفيذ شخص {
    دالة تقديم(&ذات) {
        اطبع("أنا " + ذات.الاسم + " عمري " + صحيح_لنص(ذات.العمر));
    }
}

دالة رئيسية() {
    دع أحمد = شخص {
        الاسم: "أحمد",
        العمر: 25,
    };
    
    أحمد.تقديم();
}

7. جرّب في المتصفح

لا تريد تثبيت شيء؟ جرّب كنوز مباشرة في ساحة التجربة!

الخطوات التالية


ابدأ البرمجة بلغتك اليوم! 🎯