تويت
برامج MQL5
MQL5 Programs
هناك ثلاثة أنواع من البرامج التي يمكنك إنشاؤها في MQL5:
1. الخبير المستشار هو برنامج تداول آلي يمكنه فتح وتعديل وإغلاق الطلبات. يمكنك تثبيت خبير مستشار واحد فقط في الوقت نفسه على الرسم البياني.
2. المؤشر يعرض بيانات التحليل الفني على الرسم البياني أو في نافذة منفصلة باستخدام خطوط وأعمدة وسهام وبارات/شموع أو أشياء بيانية. يمكنك تثبيت عدة مؤشرات على الرسم البياني.
3. النصي هو برنامج متخصص يقوم بأداء مهمة محددة. عندما يتم تثبيت نصي على الرسم البياني، سيتم تنفيذه مرة واحدة فقط. يمكنك تثبيت نص واحد فقط في الوقت نفسه على الرسم البياني.
أمتدادات الملفات
File Extensions
يحتوي ملف MQ5 (.mq5) على الشيفرة المصدرية لبرنامج MQL5، مثل خبير مستشار، مؤشر، نصي، أو مكتبة. هذا هو الملف الذي يتم إنشاؤه عند كتابة برنامج MQL5 في ميتا إيديتور. يمكن فتح وتحرير هذا الملف في ميتا إيديتور أو أي محرر نصي آخر.
ملف EX5 (.ex5) هو برنامج تنفيذي مجمع. عندما يتم تجميع ملف MQ5 في ميتا إيديتور، يتم إنتاج ملف EX5 بنفس اسم الملف. هذا هو الملف الذي يتم تنفيذه عندما تقوم بإلصاق برنامج MQL5 برسم بياني. ملفات EX5 هي ملفات ثنائية، ولا يمكن فتحها أو تحريرها.
ملف MQH (.mqh) هو ملف إدراج يحتوي على الشيفرة المصدرية للاستخدام في برنامج MQL5. مثل ملفات MQ5، يمكن فتح وتحرير ملف MQH في ميتا إيديتور.
أنواع ملفات أخرى
Other File Types
ملف الإدراج (.mqh) هو ملف شيفرة مصدرية يحتوي على فئات ووظائف ومتغيرات للاستخدام في برنامج MQL. ملفات الإدراج تحتوي على شيفرة مصدرية مفيدة يمكن إعادة استخدامها مرارًا وتكرارًا. عند تجميع برنامج، سيتم "تضمين" محتوى أي ملفات إدراج تم استخدامها في البرنامج في البرنامج المجمع.
سنقوم بإنشاء العديد من ملفات الإدراج خلال الدروس القادمة إن شاء الله.
المكتبة هي ملف تنفيذي يحتوي على وظائف قابلة لإعادة الاستخدام، مشابهة لملف الإدراج. تأتي المكتبات في شكل EX5 أو ملفات DLL لنظام التشغيل Windows. تُنفذ المكتبة في الذاكرة كبرنامج منفصل مع برنامج MQL الخاص بك.
المكتبات مفيدة إذا كنت ترغب في جعل وظائفك متاحة للآخرين دون الحاجة إلى جعل الشيفرة المصدرية متاحة. سنناقش المكتبات بمزيد من التفصيل إن شاء الله.
ملف إعدادات الخبير المستشار أو ملف الإعداد المسبق (.set) يحتوي على معلمات التداول لخبير مستشار. يتم تحميل ملفات الإعداد أو حفظها في مربع حوار الخصائص للخبير المستشار تحت علامة التبويب المدخلات. زر التحميل يقوم بتحميل المعلمات من ملف .set، وزر الحفظ يحفظ المعلمات الحالية في ملف .set. يمكنك أيضًا تحميل أو حفظ المعلمات في مختبر استراتيجية باستخدام القائمة المنبثقة بالنقر بزر الماوس الأيمن تحت علامة التبويب المدخلات.
مواقع الملفات:
File Locations
- مجلد برنامج ميتاتريدر 5 يقع عادة في C:\Program Files\. إذا كنت قد قمت بتثبيت ميتاتريدر 5 في مجلد آخر أو مسار آخر، قد يكون مسار التثبيت مختلفًا.
- جميع برامج MQL5 تقع تحت مجلد \MQL5 في مجلد برنامج ميتاتريدر 5 الخاص بك. بالنسبة لمسار التثبيت الافتراضي لميتاتريدر 5، فإن مسار مجلد MQL5 هو C:\Program Files\MetaTrader 5\MQL5. (قد يستخدم وسيطك اسمًا مختلفًا لمجلد \MetaTrader 5.)
- نظرًا لأن جميع برامج MQL5 تستخدم نفس امتدادات الملفات، فإن أنواع البرامج منظمة في مجلدات فرعية في مجلد \MQL5 في ميتاتريدر 5. وفيما يلي محتويات المجلدات الفرعية في مجلد MQL5:
- \Experts – يحتوي هذا المجلد على ملفات MQ5 وEX5 لخبراء المستشارين.
- \Indicators – يحتوي هذا المجلد على ملفات MQ5 وEX5 للمؤشرات.
- \Scripts – يحتوي هذا المجلد على ملفات MQ5 وEX5 للنصوص.
- \Include – يحتوي هذا المجلد على ملفات الإدراج MQH.
- \Libraries – يحتوي هذا المجلد على ملفات MQ5 وEX5 وDLL للمكتبات.
- \Images – إذا كان برنامجك يستخدم صور بتماب، فيجب أن تكون مخزنة في هذا المجلد بتنسيق .bmp.
- \Files – أي ملفات خارجية تستخدمها في برامجك، بخلاف ملفات الإدراج والمكتبات والصور أو برامج MQL الأخرى، يجب أن تكون مخزنة في هذا المجلد.
- \Presets – هذا هو المجلد الافتراضي لملفات .set التي يتم تحميلها أو حفظها من مربع حوار الخصائص لخبير المستشار أو من علامة التبويب المدخلات في مختبر الاستراتيجية.
- \Logs – تُحفظ سجلات خبراء المستشارين في هذا المجلد. يمكنك عرض هذه السجلات في علامة التبويب "الخبراء" داخل نافذة "مربع الأدوات" في واجهة ميتاتريدر الرئيسية.
أي إشارات إلى المجلدات أعلاه في هذا خلال الدروس القادمة تفترض أنها تقع تحت مجلد \MQL5 في مجلد التثبيت الخاص ببرنامج ميتاتريدر 5. لذا، إشارة إلى المجلد \Experts ستشير إلى المجلد الفرعي \MQL5\Experts في مجلد تثبيت ميتاتريدر 5.
ميتا إديتور
MetaEditor
ميتا إديتور هو بيئة تطوير متكاملة (IDE) للغة MQL5 والذي يأتي مضمنًا مع ميتاتريدر 5. يمكنك فتح ميتا إديتور من واجهة ميتاتريدر عن طريق النقر على زر ميتا إديتور على شريط الأدوات القياسي، أو عن طريق الضغط على مفتاح F4 على لوحة المفاتيح. يمكنك أيضًا فتح ميتا إديتور من قائمة "ابدأ" في نظام التشغيل ويندوز.
ميتا إديتور يحتوي على العديد من الميزات المفيدة لإنشاء برامج MQL5، بما في ذلك إكمال تلقائي لأسماء القوائم، تلميحات معلومات المعلمة، أدوات البحث، أدوات التصحيح وغيرها. تُظهر الشكل 1.2 ميزة أسماء القوائم. اكتب الأحرف الأولى لعنصر اللغة MQL5، أو اسم المتغير، أو اسم الوظيفة، وسيظهر قائمة منسدلة تحتوي على جميع الكلمات الرئيسية المطابقة. قم بالتمرير عبر القائمة باستخدام مفاتيح الأسهم للأعلى وللأسفل، واختر الكلمة الرئيسية التي ترغب في استكمالها تلقائيًا بالضغط على مفتاح Enter. يمكنك أيضًا اختيار الكلمة الرئيسية من القائمة باستخدام زر الماوس الأيسر. يمكنك استدعاء مربع القائمة بأسماء القوائم في أي وقت بالضغط على Ctrl+Space على لوحة المفاتيح، أو بتحديد "أسماء القوائم" من القائمة "تحرير".
معالج MQL5
MQL5 Wizard
يُستخدم معالج MQL5 لإنشاء برنامج MQL5 جديد. لفتح معالج MQL5، انقر على الزر "جديد" على شريط الأدوات، أو حدد "جديد" من قائمة الملف. ستظهر نافذة بها الخيارات التالية:
مستشار الخبراء (قالب) - سيقوم بإنشاء ملف مستشار خبير جديد باستخدام قالب مدمج. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Experts أو مجلد فرعي محدد.
مستشار الخبراء (إنشاء) - يسمح للمستخدم بإنشاء مستشار خبير دون الحاجة إلى أي برمجة. المستشار الخبير الذي تم إنشاؤه يستخدم مكتبة MQL5 القياسية.
مؤشر مخصص - سيقوم بإنشاء ملف مؤشر مخصص جديد باستخدام قالب مدمج. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Indicators أو مجلد فرعي محدد.
نص - سيقوم بإنشاء ملف نص فارغ باستخدام قالب مدمج. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Scripts أو مجلد فرعي محدد.
مكتبة - سيقوم بإنشاء ملف مكتبة فارغ باستخدام قالب مدمج. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Libraries أو مجلد فرعي محدد.
ملف تضمين (*.mqh) - سيقوم بإنشاء ملف تضمين فارغ باستخدام قالب مدمج بامتداد .mqh. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Include أو مجلد فرعي محدد.
فئة جديدة - سيقوم بإنشاء ملف تضمين مع تعريف فئة باستخدام قالب مدمج. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Experts أو مجلد فرعي محدد.
سنقوم بالتعمق أكثر في إنشاء البرامج باستخدام معالج MQL5
الترجمة
Compilation
لترجمة برنامج MQL5، ببساطة اضغط على الزر "ترجم" على شريط الأدوات في ميتا إديتور. سيتم التحقق من الملف الحالي MQ5 وجميع الملفات المدرجة ضمنه للبحث عن الأخطاء، وسيتم إنتاج ملف EX5. ستظهر أي أخطاء أو تحذيرات في علامة التبويب "الأخطاء" في نافذة الأدوات.
يجب إصلاح الأخطاء قبل أن يمكن إنشاء ملف EX5. سيتم مناقشة عملية تصحيح الأخطاء والتصحيح في الفصل 22. يجب فحص التحذيرات، لكن في العادة يمكن تجاهلها بأمان. سيتم ترجمة البرنامج بنجاح حتى إذا كانت هناك تحذيرات.
البنية اللغوية
Syntax
MQL5 مشابه لغات البرمجة الحديثة الأخرى مثل C++، C# أو Java. إذا كنت قد برمجت بأي لغة برمجة حديثة مع بنية لغة سي بالأسلوب، ستكون بنية وبنية اللغة في MQL مألوفة للغاية بالنسبة لك.
يجب أن تنتهي التعبيرات أو العمليات في MQL5 بفاصلة منقوطة (;). يمكن أن تمتد التعبيرات عبر عدة أسطر، ولكن يجب أن يكون هناك فاصلة منقوطة في نهاية التعبير. عدم إضافة فاصلة منقوطة في نهاية تعبير هو خطأ شائع يقع فيه المبرمجون الجدد.
الاستثناء الوحيد من قاعدة الفاصلة المنقوطة هو المُشغل المُركب. المُشغل المركب يتألف من مُشغل تتبعه زوج من الأقواس ({}). في المثال أدناه، المُشغل هو التعبير if(x == 0). لا توجد فاصلة منقوطة بعد الأقواس الختامية. يجب أن تنتهي أي تعبيرات داخل الأقواس بفاصلة منقوطة.
المعرفات
Identifiers
عند تسمية المتغيرات والدوال، يجب عليك استخدام معرف فريد وواضح. يجب أن لا يكون المعرف مماثلاً لمعرف آخر في البرنامج، ولا يجب أن يتطابق مع عناصر لغة MQL5.
يمكنك استخدام الحروف والأرقام والشرطة السفلية (_)، على الرغم من أن الحرف الأول في المعرف لا يجب أن يكون رقمًا. الحد الأقصى لطول المعرف هو 64 حرفًا. هذا يتيح لك الكثير من المجال لتكون إبداعيًا، لذا استخدم معرفات واضحة ووصفية.
المعرفات حساسة لحالة الأحرف. وهذا يعني أن MyIdentifier وmyIdentifier ليستا نفسهما!
يستخدم المبرمجون الأحرف الكبيرة والصغيرة للتمييز بين أنواع مختلفة من المتغيرات والدوال والفصول. إليك مخطط التمييز الذي سنستخدمه في هذا الكتاب:
• ستبتدئ المتغيرات العامة والكائنات والفصول وأسماء الدوال بتوسيط الحرف الأول من كل كلمة. على سبيل المثال: MyFunction() أو MyVariable.
• المتغيرات المحلية والكائنات التي يتم الإعلان عنها داخل دالة ستستخدم تعويذة الجملة. وهذا حيث يكون الحرف الأول صغيرًا، ويكون الأحرف الأولى لجميع الكلمات الأخرى كبيرة. على سبيل المثال: myVariable أو localObject.
• الثوابت مكتوبة بأحرف كبيرة. استخدم الشرطة السفلية لفصل الكلمات، على سبيل المثال: MY_CONSTANT.
التعليقات
Comments
يتم استخدام التعليقات لشرح ما تفعله قسم من الشيفرة في البرنامج. سترغب في استخدام التعليقات في جميع أنحاء برنامجك للحفاظ على تنظيمه. يمكنك أيضًا استخدام التعليقات لإزالة مؤقتة لأسطر الشيفرة من برنامجك. أي سطر يتم تعليقه يتم تجاهله من قبل المترجم.
لإضافة تعليق، يجب أن تكون الحروف الأولى اثنين شرطة مائلة (//). ستضيف تعليقًا لسطر واحد من الشيفرة:
لتعليق عدة أسطر من الشيفرة، استخدم شرطة مائلة ونجمة (/*) في بداية تعليقك ونجمة وشرطة مائلة (*/) في نهايته.
تحتوي MetaEditor على مجموعة من الأوامر المفيدة للتعليق. قم بتحديد الأسطر التي ترغب في تعليقها عن طريق تمييزها بواسطة الماوس. في القائمة التحرير، تحت قائمة التعليقات، ستجد عنصر القائمة "تعليق الأسطر" سيقوم بتعليق الأسطر المحددة، بينما سيقوم عنصر "إلغاء تعليق الأسطر" بإزالة التعليقات من الأسطر المحددة. وعنصر "عنوان الوظيفة" سيقوم بإدراج ترويسة وظيفة معلقة مشابهة لتلك الموجودة في ملفات MQ5 التي تم إنشاؤها تلقائيًا:
MQL5 Programs
هناك ثلاثة أنواع من البرامج التي يمكنك إنشاؤها في MQL5:
1. الخبير المستشار هو برنامج تداول آلي يمكنه فتح وتعديل وإغلاق الطلبات. يمكنك تثبيت خبير مستشار واحد فقط في الوقت نفسه على الرسم البياني.
2. المؤشر يعرض بيانات التحليل الفني على الرسم البياني أو في نافذة منفصلة باستخدام خطوط وأعمدة وسهام وبارات/شموع أو أشياء بيانية. يمكنك تثبيت عدة مؤشرات على الرسم البياني.
3. النصي هو برنامج متخصص يقوم بأداء مهمة محددة. عندما يتم تثبيت نصي على الرسم البياني، سيتم تنفيذه مرة واحدة فقط. يمكنك تثبيت نص واحد فقط في الوقت نفسه على الرسم البياني.
أمتدادات الملفات
File Extensions
يحتوي ملف MQ5 (.mq5) على الشيفرة المصدرية لبرنامج MQL5، مثل خبير مستشار، مؤشر، نصي، أو مكتبة. هذا هو الملف الذي يتم إنشاؤه عند كتابة برنامج MQL5 في ميتا إيديتور. يمكن فتح وتحرير هذا الملف في ميتا إيديتور أو أي محرر نصي آخر.
ملف EX5 (.ex5) هو برنامج تنفيذي مجمع. عندما يتم تجميع ملف MQ5 في ميتا إيديتور، يتم إنتاج ملف EX5 بنفس اسم الملف. هذا هو الملف الذي يتم تنفيذه عندما تقوم بإلصاق برنامج MQL5 برسم بياني. ملفات EX5 هي ملفات ثنائية، ولا يمكن فتحها أو تحريرها.
ملف MQH (.mqh) هو ملف إدراج يحتوي على الشيفرة المصدرية للاستخدام في برنامج MQL5. مثل ملفات MQ5، يمكن فتح وتحرير ملف MQH في ميتا إيديتور.
أنواع ملفات أخرى
Other File Types
ملف الإدراج (.mqh) هو ملف شيفرة مصدرية يحتوي على فئات ووظائف ومتغيرات للاستخدام في برنامج MQL. ملفات الإدراج تحتوي على شيفرة مصدرية مفيدة يمكن إعادة استخدامها مرارًا وتكرارًا. عند تجميع برنامج، سيتم "تضمين" محتوى أي ملفات إدراج تم استخدامها في البرنامج في البرنامج المجمع.
سنقوم بإنشاء العديد من ملفات الإدراج خلال الدروس القادمة إن شاء الله.
المكتبة هي ملف تنفيذي يحتوي على وظائف قابلة لإعادة الاستخدام، مشابهة لملف الإدراج. تأتي المكتبات في شكل EX5 أو ملفات DLL لنظام التشغيل Windows. تُنفذ المكتبة في الذاكرة كبرنامج منفصل مع برنامج MQL الخاص بك.
المكتبات مفيدة إذا كنت ترغب في جعل وظائفك متاحة للآخرين دون الحاجة إلى جعل الشيفرة المصدرية متاحة. سنناقش المكتبات بمزيد من التفصيل إن شاء الله.
ملف إعدادات الخبير المستشار أو ملف الإعداد المسبق (.set) يحتوي على معلمات التداول لخبير مستشار. يتم تحميل ملفات الإعداد أو حفظها في مربع حوار الخصائص للخبير المستشار تحت علامة التبويب المدخلات. زر التحميل يقوم بتحميل المعلمات من ملف .set، وزر الحفظ يحفظ المعلمات الحالية في ملف .set. يمكنك أيضًا تحميل أو حفظ المعلمات في مختبر استراتيجية باستخدام القائمة المنبثقة بالنقر بزر الماوس الأيمن تحت علامة التبويب المدخلات.
مواقع الملفات:
File Locations
- مجلد برنامج ميتاتريدر 5 يقع عادة في C:\Program Files\. إذا كنت قد قمت بتثبيت ميتاتريدر 5 في مجلد آخر أو مسار آخر، قد يكون مسار التثبيت مختلفًا.
- جميع برامج MQL5 تقع تحت مجلد \MQL5 في مجلد برنامج ميتاتريدر 5 الخاص بك. بالنسبة لمسار التثبيت الافتراضي لميتاتريدر 5، فإن مسار مجلد MQL5 هو C:\Program Files\MetaTrader 5\MQL5. (قد يستخدم وسيطك اسمًا مختلفًا لمجلد \MetaTrader 5.)
- نظرًا لأن جميع برامج MQL5 تستخدم نفس امتدادات الملفات، فإن أنواع البرامج منظمة في مجلدات فرعية في مجلد \MQL5 في ميتاتريدر 5. وفيما يلي محتويات المجلدات الفرعية في مجلد MQL5:
- \Experts – يحتوي هذا المجلد على ملفات MQ5 وEX5 لخبراء المستشارين.
- \Indicators – يحتوي هذا المجلد على ملفات MQ5 وEX5 للمؤشرات.
- \Scripts – يحتوي هذا المجلد على ملفات MQ5 وEX5 للنصوص.
- \Include – يحتوي هذا المجلد على ملفات الإدراج MQH.
- \Libraries – يحتوي هذا المجلد على ملفات MQ5 وEX5 وDLL للمكتبات.
- \Images – إذا كان برنامجك يستخدم صور بتماب، فيجب أن تكون مخزنة في هذا المجلد بتنسيق .bmp.
- \Files – أي ملفات خارجية تستخدمها في برامجك، بخلاف ملفات الإدراج والمكتبات والصور أو برامج MQL الأخرى، يجب أن تكون مخزنة في هذا المجلد.
- \Presets – هذا هو المجلد الافتراضي لملفات .set التي يتم تحميلها أو حفظها من مربع حوار الخصائص لخبير المستشار أو من علامة التبويب المدخلات في مختبر الاستراتيجية.
- \Logs – تُحفظ سجلات خبراء المستشارين في هذا المجلد. يمكنك عرض هذه السجلات في علامة التبويب "الخبراء" داخل نافذة "مربع الأدوات" في واجهة ميتاتريدر الرئيسية.
أي إشارات إلى المجلدات أعلاه في هذا خلال الدروس القادمة تفترض أنها تقع تحت مجلد \MQL5 في مجلد التثبيت الخاص ببرنامج ميتاتريدر 5. لذا، إشارة إلى المجلد \Experts ستشير إلى المجلد الفرعي \MQL5\Experts في مجلد تثبيت ميتاتريدر 5.
ميتا إديتور
MetaEditor
ميتا إديتور هو بيئة تطوير متكاملة (IDE) للغة MQL5 والذي يأتي مضمنًا مع ميتاتريدر 5. يمكنك فتح ميتا إديتور من واجهة ميتاتريدر عن طريق النقر على زر ميتا إديتور على شريط الأدوات القياسي، أو عن طريق الضغط على مفتاح F4 على لوحة المفاتيح. يمكنك أيضًا فتح ميتا إديتور من قائمة "ابدأ" في نظام التشغيل ويندوز.
ميتا إديتور يحتوي على العديد من الميزات المفيدة لإنشاء برامج MQL5، بما في ذلك إكمال تلقائي لأسماء القوائم، تلميحات معلومات المعلمة، أدوات البحث، أدوات التصحيح وغيرها. تُظهر الشكل 1.2 ميزة أسماء القوائم. اكتب الأحرف الأولى لعنصر اللغة MQL5، أو اسم المتغير، أو اسم الوظيفة، وسيظهر قائمة منسدلة تحتوي على جميع الكلمات الرئيسية المطابقة. قم بالتمرير عبر القائمة باستخدام مفاتيح الأسهم للأعلى وللأسفل، واختر الكلمة الرئيسية التي ترغب في استكمالها تلقائيًا بالضغط على مفتاح Enter. يمكنك أيضًا اختيار الكلمة الرئيسية من القائمة باستخدام زر الماوس الأيسر. يمكنك استدعاء مربع القائمة بأسماء القوائم في أي وقت بالضغط على Ctrl+Space على لوحة المفاتيح، أو بتحديد "أسماء القوائم" من القائمة "تحرير".
معالج MQL5
MQL5 Wizard
يُستخدم معالج MQL5 لإنشاء برنامج MQL5 جديد. لفتح معالج MQL5، انقر على الزر "جديد" على شريط الأدوات، أو حدد "جديد" من قائمة الملف. ستظهر نافذة بها الخيارات التالية:
مستشار الخبراء (قالب) - سيقوم بإنشاء ملف مستشار خبير جديد باستخدام قالب مدمج. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Experts أو مجلد فرعي محدد.
مستشار الخبراء (إنشاء) - يسمح للمستخدم بإنشاء مستشار خبير دون الحاجة إلى أي برمجة. المستشار الخبير الذي تم إنشاؤه يستخدم مكتبة MQL5 القياسية.
مؤشر مخصص - سيقوم بإنشاء ملف مؤشر مخصص جديد باستخدام قالب مدمج. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Indicators أو مجلد فرعي محدد.
نص - سيقوم بإنشاء ملف نص فارغ باستخدام قالب مدمج. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Scripts أو مجلد فرعي محدد.
مكتبة - سيقوم بإنشاء ملف مكتبة فارغ باستخدام قالب مدمج. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Libraries أو مجلد فرعي محدد.
ملف تضمين (*.mqh) - سيقوم بإنشاء ملف تضمين فارغ باستخدام قالب مدمج بامتداد .mqh. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Include أو مجلد فرعي محدد.
فئة جديدة - سيقوم بإنشاء ملف تضمين مع تعريف فئة باستخدام قالب مدمج. يتم حفظ الملف الذي تم إنشاؤه في مجلد \MQL5\Experts أو مجلد فرعي محدد.
سنقوم بالتعمق أكثر في إنشاء البرامج باستخدام معالج MQL5
الترجمة
Compilation
لترجمة برنامج MQL5، ببساطة اضغط على الزر "ترجم" على شريط الأدوات في ميتا إديتور. سيتم التحقق من الملف الحالي MQ5 وجميع الملفات المدرجة ضمنه للبحث عن الأخطاء، وسيتم إنتاج ملف EX5. ستظهر أي أخطاء أو تحذيرات في علامة التبويب "الأخطاء" في نافذة الأدوات.
يجب إصلاح الأخطاء قبل أن يمكن إنشاء ملف EX5. سيتم مناقشة عملية تصحيح الأخطاء والتصحيح في الفصل 22. يجب فحص التحذيرات، لكن في العادة يمكن تجاهلها بأمان. سيتم ترجمة البرنامج بنجاح حتى إذا كانت هناك تحذيرات.
البنية اللغوية
Syntax
MQL5 مشابه لغات البرمجة الحديثة الأخرى مثل C++، C# أو Java. إذا كنت قد برمجت بأي لغة برمجة حديثة مع بنية لغة سي بالأسلوب، ستكون بنية وبنية اللغة في MQL مألوفة للغاية بالنسبة لك.
يجب أن تنتهي التعبيرات أو العمليات في MQL5 بفاصلة منقوطة (;). يمكن أن تمتد التعبيرات عبر عدة أسطر، ولكن يجب أن يكون هناك فاصلة منقوطة في نهاية التعبير. عدم إضافة فاصلة منقوطة في نهاية تعبير هو خطأ شائع يقع فيه المبرمجون الجدد.
كود PHP:
// A simple expression
x = y + z;
// An expression that spans multiple lines
x = (y + z)
/ (q r);
كود PHP:
// A simple compound operator
if(x == 0)
{
Print("x is equal to zero");
return;
}
المعرفات
Identifiers
عند تسمية المتغيرات والدوال، يجب عليك استخدام معرف فريد وواضح. يجب أن لا يكون المعرف مماثلاً لمعرف آخر في البرنامج، ولا يجب أن يتطابق مع عناصر لغة MQL5.
يمكنك استخدام الحروف والأرقام والشرطة السفلية (_)، على الرغم من أن الحرف الأول في المعرف لا يجب أن يكون رقمًا. الحد الأقصى لطول المعرف هو 64 حرفًا. هذا يتيح لك الكثير من المجال لتكون إبداعيًا، لذا استخدم معرفات واضحة ووصفية.
المعرفات حساسة لحالة الأحرف. وهذا يعني أن MyIdentifier وmyIdentifier ليستا نفسهما!
يستخدم المبرمجون الأحرف الكبيرة والصغيرة للتمييز بين أنواع مختلفة من المتغيرات والدوال والفصول. إليك مخطط التمييز الذي سنستخدمه في هذا الكتاب:
• ستبتدئ المتغيرات العامة والكائنات والفصول وأسماء الدوال بتوسيط الحرف الأول من كل كلمة. على سبيل المثال: MyFunction() أو MyVariable.
• المتغيرات المحلية والكائنات التي يتم الإعلان عنها داخل دالة ستستخدم تعويذة الجملة. وهذا حيث يكون الحرف الأول صغيرًا، ويكون الأحرف الأولى لجميع الكلمات الأخرى كبيرة. على سبيل المثال: myVariable أو localObject.
• الثوابت مكتوبة بأحرف كبيرة. استخدم الشرطة السفلية لفصل الكلمات، على سبيل المثال: MY_CONSTANT.
التعليقات
Comments
يتم استخدام التعليقات لشرح ما تفعله قسم من الشيفرة في البرنامج. سترغب في استخدام التعليقات في جميع أنحاء برنامجك للحفاظ على تنظيمه. يمكنك أيضًا استخدام التعليقات لإزالة مؤقتة لأسطر الشيفرة من برنامجك. أي سطر يتم تعليقه يتم تجاهله من قبل المترجم.
لإضافة تعليق، يجب أن تكون الحروف الأولى اثنين شرطة مائلة (//). ستضيف تعليقًا لسطر واحد من الشيفرة:
كود PHP:
// This is a comment
// The line of code below is commented out
// x = y + z;
كود PHP:
/* This is a multi-line comment
These lines will be ignored by the compiler
x = y + z; */
كود PHP:
// Function header generated by Edit menu > Comments > Function Header
–
–
//+------------------------------------------------------------------+
//| |
//+------------------------------------------------------------------+
تعليق