MQL5 Documentation

مستندات MQL5

مقدمه

MQL5، زبان برنامه‌نویسی اختصاصی پلتفرم معاملاتی MetaTrader 5، ابزاری قدرتمند برای توسعه استراتژی‌های معاملاتی خودکار، شاخص‌های تحلیلی و اسکریپت‌های کاربردی است. درک و استفاده صحیح از مستندات MQL5، کلید موفقیت در برنامه‌نویسی و بهره‌برداری از تمام پتانسیل این زبان به شمار می‌رود. این مقاله با هدف آشنایی مبتدیان با ساختار، محتوا و نحوه استفاده از مستندات MQL5 تهیه شده است.

اهمیت مستندات MQL5

مستندات MQL5، مرجع اصلی و جامع برای تمامی جنبه‌های این زبان برنامه‌نویسی است. بدون دسترسی به این مستندات، درک توابع، کلاس‌ها، متغیرها و ساختارهای زبان MQL5 عملاً غیرممکن خواهد بود. مستندات MQL5، اطلاعات دقیقی در مورد سینتکس (Syntax) زبان، پارامترهای توابع، مقادیر بازگشتی و مثال‌های کاربردی ارائه می‌دهد. همچنین، در این مستندات می‌توانید به توضیحات کاملی در مورد رویدادها (Events)، سیگنال‌ها (Signals) و انواع داده‌های موجود در MQL5 دسترسی پیدا کنید. مستندات MQL5 به شما کمک می‌کند تا:

• کدهای خود را به صورت حرفه‌ای و بدون خطا بنویسید.
• از آخرین تغییرات و به‌روزرسانی‌های زبان MQL5 آگاه شوید.
• مشکلات و خطاهای احتمالی در کدهای خود را به سرعت شناسایی و رفع کنید.
• استراتژی‌های معاملاتی پیچیده و پیشرفته‌ای را طراحی و پیاده‌سازی کنید.
• از امکانات پلتفرم MetaTrader 5 به طور کامل بهره‌مند شوید.

دسترسی به مستندات MQL5

مستندات MQL5 به دو صورت در دسترس است:

• آنلاین: از طریق وب‌سایت رسمی MQL5 ([1](https://www.mql5.com/en/docs)) می‌توانید به آخرین نسخه مستندات دسترسی داشته باشید. این روش امکان جستجو و پیمایش آسان در میان صفحات را فراهم می‌کند.
• آفلاین: درون پلتفرم MetaEditor نیز می‌توانید به مستندات MQL5 دسترسی داشته باشید. برای این کار، کافی است در MetaEditor کلید F1 را فشار دهید یا از منوی Help گزینه MQL5 Reference را انتخاب کنید. این روش برای زمانی که دسترسی به اینترنت ندارید بسیار مفید است.

ساختار مستندات MQL5

مستندات MQL5 به طور کلی به بخش‌های زیر تقسیم می‌شود:

• مفاهیم پایه: این بخش شامل توضیحات ابتدایی در مورد زبان MQL5، ساختار برنامه‌ها، انواع داده‌ها، عملگرها و دستورات کنترلی است. در این بخش، مفاهیم اساسی برنامه‌نویسی به زبان MQL5 به صورت ساده و قابل فهم توضیح داده شده‌اند.
• زبان MQL5: این بخش شامل توضیحات دقیق و جامعی در مورد تمامی عناصر زبان MQL5، از جمله متغیرها، توابع، کلاس‌ها، ساختارها و ... است. در این بخش، می‌توانید سینتکس هر عنصر را به همراه مثال‌های کاربردی مشاهده کنید. متغیرها در MQL5، توابع در MQL5، کلاس‌ها در MQL5
• توابع داخلی: این بخش حاوی لیست کاملی از توابع داخلی MQL5 است که توسط پلتفرم MetaTrader 5 ارائه شده‌اند. این توابع برای انجام عملیات مختلفی مانند دسترسی به داده‌های بازار، انجام محاسبات ریاضی، مدیریت سفارشات و ... استفاده می‌شوند. توابع مربوط به بازار، توابع مربوط به سفارشات، توابع مربوط به شاخص‌ها
• انواع داده: این بخش به طور کامل به انواع داده‌های موجود در MQL5 می‌پردازد، از جمله انواع صحیح، اعشاری، رشته‌ای، بولین و ... درک انواع داده‌ها برای نوشتن کدهای صحیح و کارآمد بسیار مهم است. انواع داده عددی، انواع داده متنی
• رویدادها: این بخش به رویدادهایی که در پلتفرم MetaTrader 5 رخ می‌دهند و می‌توانند توسط برنامه‌های MQL5 مدیریت شوند، می‌پردازد. رویدادها شامل رویدادهای مربوط به زمان، قیمت، سفارشات و ... هستند. رویدادهای Tick، رویدادهای OnTrade
• کلاس‌های پیش‌تعریف‌شده: این بخش شامل کلاس‌هایی است که توسط MQL5 به طور پیش‌فرض تعریف شده‌اند و می‌توان از آن‌ها برای انجام وظایف خاصی استفاده کرد. این کلاس‌ها شامل کلاس‌های مربوط به نمادها، سفارشات، حساب‌ها و ... هستند. کلاس CMarket، کلاس COrder
• راهنماهای عملی: این بخش شامل آموزش‌ها و مثال‌های عملی برای انجام وظایف مختلف با استفاده از MQL5 است. این بخش برای مبتدیان بسیار مفید است. ایجاد یک Expert Advisor ساده، نوشتن یک شاخص سفارشی

نحوه استفاده از مستندات MQL5

برای استفاده بهینه از مستندات MQL5، به نکات زیر توجه کنید:

• از قابلیت جستجو استفاده کنید: اگر به دنبال اطلاعات خاصی هستید، از قابلیت جستجو در مستندات استفاده کنید. با وارد کردن کلمات کلیدی مرتبط، می‌توانید به سرعت به اطلاعات مورد نظر خود دسترسی پیدا کنید.
• مثال‌ها را بررسی کنید: مستندات MQL5 شامل مثال‌های کاربردی متعددی است که می‌توانید از آن‌ها برای یادگیری نحوه استفاده از توابع و کلاس‌ها استفاده کنید. مثال‌ها را به دقت بررسی کنید و سعی کنید آن‌ها را در کدهای خود پیاده‌سازی کنید.
• به توضیحات پارامترها و مقادیر بازگشتی توجه کنید: هنگام استفاده از توابع، به توضیحات پارامترها و مقادیر بازگشتی آن‌ها توجه کنید. این اطلاعات به شما کمک می‌کنند تا توابع را به درستی فراخوانی کنید و نتایج مورد نظر را بدست آورید.
• به بخش‌های مرتبط مراجعه کنید: اگر در درک یک مفهوم خاص مشکل دارید، به بخش‌های مرتبط در مستندات مراجعه کنید. گاهی اوقات، درک یک مفهوم نیازمند بررسی مفاهیم دیگر است.
• از انجمن‌های MQL5 استفاده کنید: اگر سوالی دارید که در مستندات به آن پاسخ داده نشده است، می‌توانید از انجمن‌های MQL5 ([2](https://www.mql5.com/en/forum)) کمک بگیرید. در این انجمن‌ها می‌توانید سوالات خود را مطرح کنید و از تجربیات دیگر برنامه‌نویسان MQL5 بهره‌مند شوید.

مثال‌هایی از استفاده از مستندات MQL5

فرض کنید می‌خواهید یک Expert Advisor بنویسید که در صورت عبور قیمت از یک میانگین متحرک ساده، یک سفارش خرید باز کند. برای این کار، باید از تابع iMA() برای محاسبه میانگین متحرک استفاده کنید. با مراجعه به مستندات MQL5 و جستجوی تابع iMA()، می‌توانید اطلاعات زیر را بدست آورید:

• نام تابع: iMA
• پارامترها:

   *   symbol:' نام نماد
   *   period:' بازه زمانی
   *   ma_period:' دوره میانگین متحرک
   *   ma_shift:'  جابجایی میانگین متحرک
   *   ma_method:'  روش محاسبه میانگین متحرک
   *   applied_price:'  نوع قیمت مورد استفاده

• مقدار بازگشتی: مقدار میانگین متحرک

با استفاده از این اطلاعات، می‌توانید تابع iMA() را در کد خود فراخوانی کنید و میانگین متحرک را محاسبه کنید.

موضوعات مرتبط

• استراتژی‌های معاملاتی
• تحلیل تکنیکال
• تحلیل حجم معاملات
• اندیکاتورهای معاملاتی
• مدیریت ریسک
• بهینه‌سازی استراتژی
• بک تست
• بازارهای مالی
• فارکس
• سهام
• کالاها
• ارزهای دیجیتال
• الگوریتم‌های معاملاتی
• شبکه‌های عصبی در معاملات
• یادگیری ماشین در معاملات
• تحلیل بنیادی
• پالایش داده‌های مالی
• مدل‌سازی مالی
• ارزیابی ریسک
• تنوع‌بخشی سبد سرمایه‌گذاری

منابع اضافی

• وب‌سایت رسمی MQL5: [3](https://www.mql5.com/)
• انجمن MQL5: [4](https://www.mql5.com/en/forum)
• بلاگ MQL5: [5](https://www.mql5.com/en/blog)

نتیجه‌گیری

مستندات MQL5، ابزاری ضروری برای هر برنامه‌نویسی است که قصد دارد از زبان MQL5 و پلتفرم MetaTrader 5 استفاده کند. با درک ساختار و نحوه استفاده از این مستندات، می‌توانید به طور موثرتری برنامه‌نویسی کنید، استراتژی‌های معاملاتی خودکار را توسعه دهید و از تمام پتانسیل MQL5 بهره‌مند شوید. همیشه به یاد داشته باشید که مستندات MQL5، مرجع اصلی شما در این مسیر است.

شروع معاملات الآن

ثبت‌نام در IQ Option (حداقل واریز $10) باز کردن حساب در Pocket Option (حداقل واریز $5)

به جامعه ما بپیوندید

در کانال تلگرام ما عضو شوید @strategybin و دسترسی پیدا کنید به: ✓ سیگنال‌های معاملاتی روزانه ✓ تحلیل‌های استراتژیک انحصاری ✓ هشدارهای مربوط به روند بازار ✓ مواد آموزشی برای مبتدیان