تابع OnInit در MQL4 و MQL5: ستون فقرات راه‌اندازی اکسپرت ادوایزر

تابع مقداردهی اولیه (Initialization Function)، که با نام OnInit() در هر دو زبان برنامه‌نویسی MQL4 و MQL5 شناخته می‌شود، یکی از حیاتی‌ترین توابع در ساختار یک اکسپرت ادوایزر (Expert Advisor – EA)، اندیکاتور سفارشی (Custom Indicator) یا اسکریپت (Script) در پلتفرم متاتریدر است. این تابع در واقع نقطه ورود اصلی برنامه شما به دنیای اجرای زنده یا شبیه‌سازی شده است و مسئولیت انجام تمام تنظیمات لازم پیش از آغاز چرخه اصلی پردازش‌ها را بر عهده دارد. درک عمیق معماری و عملکرد صحیح OnInit نه تنها برای اجرای بی‌نقص برنامه شما ضروری است، بلکه مستقیماً بر پایداری (Stability)، کارایی (Efficiency) و قابلیت اطمینان (Reliability) استراتژی معاملاتی شما تأثیر می‌گذارد. این بخش از کد شماست که تصمیم می‌گیرد آیا برنامه می‌تواند با داده‌های بازار تعامل کند، آیا منابع لازم را تخصیص داده است، و آیا پارامترهای ورودی به درستی تفسیر شده‌اند یا خیر. عدم مدیریت صحیح این مرحله می‌تواند منجر به اشکالات پنهان (Hidden Bugs)، خطاهای اجرایی در حین ترید، یا در نهایت، شکست کامل سیستم در محیط زنده شود. بنابراین، این مقاله به تشریح کامل این تابع حیاتی در هر دو نسخه MQL پرداخته و نکات تخصصی پیرامون آن را برای برنامه‌نویسان حرفه‌ای تشریح خواهد کرد.

تعریف دقیق و نقش تابع OnInit در متاتریدر

OnInit() به عنوان تابع آغازین یا تابع راه‌اندازی شناخته می‌شود. نقش اصلی این تابع، انجام کلیه عملیات مقداردهی اولیه (Initialization) است که باید دقیقاً یک بار و پیش از شروع دریافت هر تیک (Tick) جدید یا اجرای تابع OnTick() (در EAها) یا OnCalculate() (در اندیکاتورها) انجام پذیرد. متاتریدر، پس از کامپایل موفق کد و اضافه شدن اکسپرت ادوایزر به نمودار، قبل از هرگونه فعالیت دیگر، این تابع را فراخوانی می‌کند. اگرچه ممکن است در نگاه اول ساده به نظر برسد، اما دامنه کاربرد آن بسیار گسترده است. این تابع محلی است که شما باید مطمئن شوید تمام منابع مورد نیاز EA شما تخصیص داده شده‌اند و وضعیت اولیه سیستم به درستی تنظیم شده است. این شامل بررسی صحت پارامترهای ورودی، تخصیص حافظه برای ساختارهای داده پیچیده، دریافت هندل‌ها (Handles) برای ابزارهای خارجی یا اندیکاتورهای دیگر، و حتی اطمینان از اینکه محیط اجرای فعلی (مانند نسخه متاتریدر یا دسترسی به فایل‌ها) مناسب است، می‌باشد.

به بیان دقیق‌تر، OnInit() دروازه‌ای است که از طریق آن، یک اکسپرت ادوایزر یا اندیکاتور از حالت تعریف شده به حالت فعال در بازار وارد می‌شود. اگر این دروازه به درستی تنظیم نشود، باقی قسمت‌های برنامه با داده‌های نامعتبر یا منابع از دست رفته مواجه خواهند شد و ممکن است عملیات‌های بعدی منجر به خطا یا خروجی‌های غیرمنتظره شوند. این تابع باید سریع و کارآمد باشد، زیرا تأخیر در اجرای آن مستقیماً بر زمان بارگذاری EA بر روی نمودار تأثیر می‌گذارد، هرچند که تأخیر در این مرحله معمولاً کمتر از یک ثانیه است و در محیط زنده ترید تأثیر مستقیم لحظه‌ای ندارد، اما در تست استراتژی (Strategy Testing) و بک‌تست (Backtesting)، تنظیمات نادرست می‌تواند نتایج شبیه‌سازی را به شدت مخدوش کند.

زمان اجرای OnInit در چرخه عمر اکسپرت ادوایزر

چرخه عمر یک اکسپرت ادوایزر در متاتریدر یک توالی مشخص از فراخوانی توابع است که توسط پلتفرم مدیریت می‌شود. درک این توالی برای اطمینان از اینکه کدام داده‌ها در دسترس هستند، حیاتی است. OnInit() همیشه اولین تابعی است که پس از بارگذاری موفقیت‌آمیز برنامه (پس از کامپایل و کشیدن EA بر روی نمودار) فراخوانی می‌شود.

توالی استاندارد به شرح زیر است:

1. بارگذاری و تخصیص حافظه: متاتریدر فایل اجرایی EA را بارگذاری می‌کند.
2. فراخوانی OnInit(): این تابع برای انجام تنظیمات اولیه فراخوانی می‌شود.
3. فراخوانی OnTick() (در صورت موفقیت OnInit): پس از بازگشت موفقیت‌آمیز از OnInit()، EA وارد چرخه اصلی پردازش می‌شود و برای هر تیک جدید بازار، تابع OnTick() فراخوانی می‌گردد.
4. فراخوانی‌های مکرر OnTick(): پردازش‌های معاملاتی و تحلیلی در این مرحله انجام می‌شود.
5. فراخوانی OnDeinit() (هنگام حذف یا بستن ترمینال): در زمان پایان کار یا حذف EA از نمودار، این تابع برای آزادسازی منابع فراخوانی می‌شود.

نکته کلیدی اینجاست: تا زمانی که OnInit() با موفقیت کامل نشود و مقدار INIT_SUCCEEDED را برنگرداند، تابع OnTick هرگز فراخوانی نخواهد شد. این تضمین می‌کند که هرگز یک EA بدون تنظیمات اولیه شروع به ارسال درخواست‌های معاملاتی یا تحلیل داده‌ها نمی‌کند. این مدل مبتنی بر حالت (State-based Model) تضمین می‌کند که تمام پیش‌نیازها قبل از ورود به فاز عملیاتی رعایت شده‌اند. اگر EA تلاش کند مثلاً یک ابزار معاملاتی (Trading Instrument) را قبل از مقداردهی اولیه صحیح در OnInit مدیریت کند، برنامه با شکست مواجه خواهد شد.

تفاوت رفتار OnInit در MQL4 و MQL5

اگرچه هدف اصلی در هر دو نسخه یکسان است، اما تفاوت‌های مهمی در نحوه اجرای و قابلیت‌های OnInit بین MQL4 و MQL5 وجود دارد که برنامه‌نویس باید به آن‌ها توجه کند. این تفاوت‌ها عمدتاً ناشی از معماری متفاوت پلتفرم‌ها و بهبودهای صورت گرفته در MQL5 است.

در MQL4

در MQL4، تابع OnInit() صرفاً یک تابع بازگشتی (Return Function) است که باید یک مقدار عددی صحیح (Integer) را برگرداند. این نسخه از زبان به شدت بر سادگی تمرکز دارد. در MQL4، شما معمولاً از پارامتر ورودی نه (None) استفاده می‌کنید و هیچ اطلاعاتی از محیط به این تابع ارسال نمی‌شود (مگر از طریق متغیرهای سراسری یا Global Variables که از قبل مقداردهی شده‌اند). مقدار بازگشتی آن معمولاً 0 (معادل INIT_SUCCEEDED) یا 1 (معادل INIT_FAILED) است. MQL4 ساختار کمتری برای مدیریت چند رشته‌ای (Multi-threading) یا مدیریت پیشرفته‌تر سیگنال‌ها دارد، بنابراین نیاز به مقداردهی اولیه پیچیده مانند تخصیص هندل‌های شیء گرا (Object-oriented Handles) کمتر است.

در MQL5

MQL5 پیشرفت‌های چشمگیری در این زمینه داشته است. در MQL5، تابع OnInit() پارامتر ورودی‌ای به نام const OnInitReason reason را می‌پذیرد. این پارامتری از نوع شمارشی (Enum) است که اطلاعات دقیقی در مورد دلیل فراخوانی تابع در اختیار ما قرار می‌دهد. دلایل متداول شامل:

1. INIT_COMMON: راه‌اندازی عادی EA روی نمودار.
2. INIT_CHART_CHANGE: تغییر پارامترهای نمودار (مانند تغییر تایم‌فریم یا نماد).
3. INIT_PARAMETERS: تغییر پارامترهای ورودی EA پس از اجرا.
4. INIT_ACCOUNT: تغییر حساب معاملاتی.

این اطلاعات اضافی به برنامه‌نویس اجازه می‌دهد تا عملیات مقداردهی اولیه را بر اساس شرایط خاصی تنظیم کند. به عنوان مثال، اگر OnInit به دلیل تغییر پارامترها فراخوانی شود، ممکن است نیازی به بازتخصیص کل منابع نباشد، بلکه فقط نیاز به به‌روزرسانی متغیرهای مرتبط با پارامترهای جدید باشد.

همچنین، در MQL5، مدیریت هندل‌ها (مانند هندل‌های iCustom, iMA, و OnInitIndicator برای اندیکاتورها) بسیار قوی‌تر و ساختاریافته‌تر است و این توابع تخصصی‌تر اغلب در OnInit فراخوانی می‌شوند تا منابع لازم برای فراخوانی‌های بعدی در OnTick آماده باشند. اگرچه هر دو نسخه از مقادیر بازگشتی مشابهی استفاده می‌کنند، قابلیت‌های MQL5 انعطاف‌پذیری و دقت بیشتری در مرحله راه‌اندازی فراهم می‌آورد.

ارتباط OnInit با توابع OnDeinit و OnTick

تعامل OnInit با OnTick و OnDeinit قلب تپنده هر اکسپرت ادوایزر است. این سه تابع، سه مرحله اصلی حیات یک برنامه را پوشش می‌دهند: شروع، اجرا، و پایان.

رابطه با OnTick

همانطور که اشاره شد، OnInit() پیش‌نیاز فراخوانی OnTick() است. اگر OnInit() شکست بخورد، OnTick() هرگز اجرا نخواهد شد. این رابطه تضمین می‌کند که هر بار که OnTick() اجرا می‌شود، تمام تنظیمات ضروری در مرحله OnInit تکمیل شده‌اند. برنامه‌نویس باید اطمینان حاصل کند که داده‌هایی که در OnInit مقداردهی اولیه شده‌اند (مانند سایز حجم معامله یا سطوح استاپ لاس)، به درستی در دسترس OnTick قرار گیرند. برای این منظور، معمولاً متغیرهایی که در OnInit مقداردهی می‌شوند، به صورت متغیرهای سراسری (Global Variables) یا متغیرهای عضو کلاس (Class Member Variables) در MQL5 تعریف می‌شوند تا در تمام توابع قابل دسترسی باشند.

رابطه با OnDeinit

OnDeinit() تابع پاک‌سازی (Cleanup Function) است. این تابع دقیقاً در نقطه مقابل OnInit() قرار دارد و زمانی فراخوانی می‌شود که EA در حال خروج از نمودار است یا ترمینال متاتریدر بسته می‌شود. نقش اصلی آن آزادسازی منابعی است که در OnInit() تخصیص داده شده‌اند. این منابع شامل بستن فایل‌های گزارش‌گیری، حذف اشیای گرافیکی ایجاد شده، آزادسازی حافظه تخصیص یافته به صورت دستی (اگرچه MQL به صورت خودکار حافظه مدیریت نشده را پاک می‌کند، اما مدیریت صحیح هندل‌ها مهم است)، و مهم‌تر از همه، بستن ابزارهای معاملاتی (Trading Objects) است. اگر منابع تخصیص یافته در OnInit در OnDeinit آزاد نشوند، ممکن است سیستم دچار نشت حافظه (Memory Leak) یا عدم توانایی در بازنویسی فایل‌های مورد نیاز در اجرای بعدی شود. یک OnInit خوب، همواره یک OnDeinit متناظر خواهد داشت.

بررسی کامل مقادیر بازگشتی OnInit

مقدار بازگشتی OnInit() حیاتی‌ترین بخش ارتباط EA با پلتفرم متاتریدر است. این مقدار به پلتفرم اعلام می‌کند که آیا راه‌اندازی با موفقیت انجام شده است یا خیر. در MQL4 و MQL5، این مقادیر عمدتاً ثابت هستند، اما تفسیر آن‌ها در MQL5 به دلیل وجود پارامتر reason کمی ظریف‌تر است.

INIT_SUCCEEDED (معمولاً 0 در MQL4)

اگر تابع OnInit() بدون هیچ مشکلی تکمیل شود و تمام تنظیمات لازم را با موفقیت انجام دهد، باید این مقدار یا معادل آن را برگرداند. بازگشت این مقدار به متاتریدر سیگنال می‌دهد که اجرای تابع OnTick می‌تواند آغاز شود. در MQL4، بازگرداندن 0 استاندارد است. در MQL5، اگر راه‌اندازی موفق بود، بازگرداندن مقدار مناسبی از شمارش ENUM_INIT_RESULT مورد انتظار است، که INIT_SUCCEEDED رایج‌ترین آن است.

INIT_FAILED (معمولاً 1 در MQL4)

اگر هرگونه خطای بحرانی در مرحله مقداردهی اولیه رخ دهد، برنامه‌نویس باید INIT_FAILED یا معادل آن را برگرداند. این اقدام باعث می‌شود پلتفرم متاتریدر از فراخوانی OnTick() جلوگیری کند و EA را در حالت غیرفعال نگه دارد. این حالت اغلب زمانی استفاده می‌شود که:

1. پارامترهای ورودی نامعتبر باشند (مثلاً حجم لات صفر یا منفی).
2. نقص در دریافت هندل‌های اندیکاتورها (مثلاً اندیکاتور مورد نظر روی نمودار فعال نیست یا نام اشتباهی دارد).
3. عدم دسترسی به فایل‌های مورد نیاز یا تنظیمات محیطی.

زمانی که INIT_FAILED برگردانده می‌شود، متاتریدر معمولاً یک پیغام در تب لاگ (Journal Tab) یا تب اکسپرت‌ها (Experts Tab) ثبت می‌کند و از اجرای ادامه دار جلوگیری می‌کند.

سایر مقادیر در MQL5

در MQL5، علاوه بر موفقیت و شکست کلی، ممکن است با مقادیر دیگری که بیشتر با مدیریت چرخه‌های زندگی مرتبط هستند روبرو شویم، اگرچه برای یک برنامه‌نویس EA که فقط به راه‌اندازی اولیه علاقه‌مند است، تمرکز بر روی SUCCESS و FAILED کافی است. اهمیت اصلی این است که اگر عملیاتی در OnInit شکست خورد، باید فوراً با بازگرداندن INIT_FAILED از ادامه کار جلوگیری شود.

مثال‌های عملی و واقعی از کدنویسی OnInit در MQL4 و MQL5

برای درک بهتر، چند مثال کلیدی از نحوه استفاده صحیح از OnInit ارائه می‌شود.

مثال ۱: مقداردهی اولیه متغیرهای اصلی در MQL4

در این مثال ساده MQL4، ما دو متغیر کلیدی را مقداردهی اولیه کرده و صحت آن‌ها را بررسی می‌کنیم.

//--- متغیرهای سراسری
input int MagicNumber = 12345;
input double LotSize = 0.1;
input int MovingAveragePeriod = 20;

//--- تابع OnInit در MQL4
int OnInit()
{
    // 1. بررسی صحت پارامترهای ورودی
    if(LotSize <= 0)
    {
        Print("خطا: حجم لات (LotSize) باید بزرگتر از صفر باشد.");
        return(INIT_FAILED); // در MQL4 معادل 1 یا FAILED
    }

    if(MovingAveragePeriod <= 0)
    {
        Print("خطا: دوره میانگین متحرک (Period) باید بزرگتر از صفر باشد.");
        return(INIT_FAILED);
    }
    
    // 2. مقداردهی اولیه متغیرهای داخلی بر اساس ورودی‌ها
    // در MQL4، متغیرهای ورودی به صورت خودکار مقداردهی می‌شوند، اما می‌توان آن‌ها را به متغیرهای داخلی کپی کرد یا عملیات اضافی انجام داد.
    
    // 3. ثبت موفقیت‌آمیز
    Print("OnInit MQL4: مقداردهی اولیه با موفقیت انجام شد. Magic Number: ", MagicNumber);
    
    return(INIT_SUCCEEDED); // در MQL4 معادل 0 یا SUCCEEDED
}

// ... توابع OnTick و OnDeinit در ادامه

در این کد، اگرچه متغیرهای input به صورت خودکار مقداردهی می‌شوند، ما از OnInit برای اعتبارسنجی (Validation) این ورودی‌ها استفاده می‌کنیم. اگر حجم لات غیرمجاز باشد، EA متوقف می‌شود.

مثال ۲: مقداردهی اولیه هندل‌ها و تخصیص منابع در MQL5

در MQL5، استفاده از OnInit برای دریافت هندل اندیکاتورها بسیار رایج است، زیرا این کار باید قبل از فراخوانی OnTick انجام شود.

//--- متغیرهای سراسری در MQL5
input int MagicNumber = 54321;
input int MACD_Fast_Period = 12;
input int MACD_Slow_Period = 26;

//--- هندل‌های اندیکاتورها
int macd_handle;

//--- تابع OnInit در MQL5
int OnInit(const OnInitReason reason)
{
    Print("OnInit MQL5 فراخوانی شد. دلیل: ", EnumToString(reason));

    // 1. بررسی دلیل فراخوانی (اختیاری اما مفید)
    if(reason == INIT_CHART_CHANGE)
    {
        Print("تنها پارامترها به‌روزرسانی می‌شوند، نه هندل‌ها.");
        // اگر فقط پارامترها تغییر کرده باشد، ممکن است نیازی به بازتولید هندل نباشد.
    }
    
    // 2. دریافت هندل اندیکاتور MACD
    // باید مطمئن شویم اندیکاتور مورد نیاز روی نمودار تنظیم شده است.
    macd_handle = iMACD(_Symbol, _Period, MACD_Fast_Period, MACD_Slow_Period, PRICE_CLOSE);
    
    if(macd_handle == INVALID_HANDLE)
    {
        Print("خطا در دریافت هندل MACD! احتمالاً پارامترها اشتباه است.");
        return(INIT_FAILED);
    }
    
    // 3. مقداردهی اولیه متغیرهای وابسته به محیط
    // مثلاً ایجاد یک شیء مدیریت معاملات
    CTrade trade_manager; // فرض می‌کنیم یک کلاس CTrade برای مدیریت سفارشات داریم.
    trade_manager.SetExpertMagic(MagicNumber);
    
    // 4. ثبت موفقیت‌آمیز
    Print("مقداردهی اولیه هندل‌ها و مدیریت معاملات با موفقیت انجام شد.");
    
    return(INIT_SUCCEEDED);
}

// ... OnTick باید از macd_handle برای CopyBuffer استفاده کند.

در این مثال MQL5، پارامتر reason به ما اجازه می‌دهد تا رفتار خود را بر اساس زمینه تغییر دهیم. مهم‌تر از آن، دریافت هندل اندیکاتور با استفاده از تابع سیستمی مانند iMACD در OnInit استاندارد است. اگر iMACD نتواند هندلی برگرداند (که با INVALID_HANDLE مشخص می‌شود)، بلافاصله با شکست برنامه مواجه می‌شویم.

مقداردهی اولیه متغیرها، هندل‌ها، اندیکاتورها و تایمرها در OnInit

وظیفه اصلی OnInit سازماندهی منابع است. این منابع را می‌توان به چند دسته تقسیم کرد:

مقداردهی اولیه متغیرهای محاسباتی و منطقی

این ساده‌ترین بخش است. هر متغیری که در طول اجرای OnTick به صورت مداوم تغییر نمی‌کند و باید مقدار اولیه‌ای ثابت داشته باشد (مانند ضرایب ثابت، تنظیمات ریسک نهایی پس از اعتبارسنجی ورودی‌ها، یا متغیرهای حالت (State Variables))، باید در اینجا مقداردهی شود. به عنوان مثال، تعیین اینکه آیا EA باید در حال حاضر اجازه باز کردن معامله جدید بدهد یا خیر، می‌تواند یک متغیر حالت اولیه داشته باشد.

تخصیص هندل‌ها برای اندیکاتورها

در محیط‌های MQL5 و به طور فزاینده‌ای در MQL4 (با استفاده از توابع iCustom یا ساختارهای مشابه)، دسترسی به داده‌های اندیکاتورهای دیگر نیازمند یک هندل است. این هندل باید یک بار دریافت شود و سپس در طول عمر EA نگه داشته شود. OnInit بهترین مکان برای فراخوانی توابعی مانند iMA, iCustom, iBands و غیره است. اگر این هندل‌ها در OnInit گرفته نشوند، فراخوانی آن‌ها در OnTick نه تنها کندتر است، بلکه هر بار فراخوانی باعث سربار محاسباتی می‌شود و ریسک خطای اجرای ناگهانی (Race Condition) را بالا می‌برد.

تنظیم تایمرها (Timers)

در MQL5، اگر استراتژی شما نیاز به اجرای کد در فواصل زمانی نامنظم یا دقیق‌تری نسبت به تیک‌های بازار داشته باشد (مثلاً هر 5 ثانیه فارغ از نوسانات قیمت)، شما می‌توانید تایمر (Timer) را در OnInit راه‌اندازی کنید:

[ \text{TimerSet(interval_in_milliseconds);} ]

این تابع باید در OnInit فراخوانی شود تا یک تابع OnTimer سفارشی در MQL5 فعال گردد. اگر این کار در OnInit انجام نشود، تایمر هرگز فعال نخواهد شد.

مقداردهی اولیه اشیای گرافیکی (در صورت لزوم)

اگر EA شما نیاز به نمایش عناصر دائمی روی نمودار (مانند خطوط روند، مستطیل‌ها یا نوارهای اطلاعاتی سفارشی) دارد، کد مربوط به ایجاد و تنظیم اولیه این اشیا (مانند استفاده از CreateObject, SetObjectProperty) باید در OnInit قرار گیرد. این اطمینان را می‌دهد که اشیا قبل از شروع پردازش‌های تیک، روی نمودار قابل مشاهده باشند. در این صورت، در OnDeinit باید از توابعی مانند ObjectDelete برای پاکسازی آن‌ها استفاده کرد.

مدیریت خطا و لاگ‌گیری در OnInit

مدیریت خطا (Error Handling) در OnInit به اندازه مقدار بازگشتی آن اهمیت دارد. هدف اصلی در این مرحله، شناسایی سریع هر گونه مانع برای اجرای برنامه و گزارش دقیق آن به برنامه‌نویس است.

استفاده از توابع Print و Comment

در حین اجرای OnInit، استفاده از توابع گزارش‌دهی مانند Print() برای ثبت وقایع مهم در تب اکسپرت‌ها (Experts Tab) ضروری است. این کار به شما اجازه می‌دهد مسیر اجرای کد را در زمان راه‌اندازی ردیابی کنید.

علاوه بر این، استفاده از تابع Comment() برای نمایش وضعیت فعلی EA مستقیماً روی نمودار، به خصوص در مراحل اولیه، مفید است.

ثبت خطاها با GetLastError()

در MQL4 و MQL5، پس از هر فراخوانی یک تابع سیستمی که ممکن است شکست بخورد (مانند تخصیص هندل یا باز کردن فایل)، باید فوراً وضعیت آن را با GetLastError() بررسی کرد.

اگر GetLastError() مقدار غیر صفر برگرداند، این یک خطای سیستمی است که باید ثبت شده و منجر به بازگرداندن INIT_FAILED شود.

مثال ثبت خطا در MQL5:

// تلاش برای دریافت هندل
int handle = iMA(_Symbol, _Period, 10, 0, MODE_SMA, PRICE_CLOSE);

if (handle == INVALID_HANDLE)
{
    int error_code = GetLastError();
    Print("OnInit Error: نتوانست هندل میانگین متحرک را دریافت کند. کد خطا: ", error_code);
    
    // نمایش خطا روی نمودار
    Comment("خطا در راه‌اندازی. لطفا گزارش را بررسی کنید.");
    
    return(INIT_FAILED);
}

لاگ‌گیری فایل محور

برای استراتژی‌های بسیار حیاتی، صرف ثبت در تب اکسپرت کافی نیست، زیرا لاگ‌های ترمینال پس از چند روز پاک می‌شوند یا در صورت تغییر حساب، از بین می‌روند. برنامه‌نویسان حرفه‌ای معمولاً یک فایل لاگ (Log File) باز می‌کنند (با استفاده از FileOpen در MQL5 یا FileWrite در MQL4) و تمام مراحل راه‌اندازی و هرگونه خطای بحرانی را در آن ثبت می‌کنند. این فایل باید در تابع OnInit باز شده و در OnDeinit بسته شود.

اشتباهات رایج برنامه‌نویسان در استفاده از OnInit و روش‌های جلوگیری از آن‌ها

برنامه‌نویسان مبتدی و حتی گاهی اوقات متوسط، مرتکب اشتباهاتی در استفاده از OnInit می‌شوند که می‌تواند به طور جدی عملکرد EA را مختل کند.

اشتباه ۱: انجام محاسبات سنگین در OnInit

اشتباه: تلاش برای اجرای تحلیل‌های پیچیده، مانند بک‌تست دستی داده‌های تاریخی، یا پردازش حجم عظیمی از داده‌ها در OnInit.

دلیل: اگرچه OnInit قبل از اولین تیک اجرا می‌شود، اما این تابع نباید عملیات زمان‌بر انجام دهد. متاتریدر انتظار دارد این تابع در کسری از ثانیه برگردد. محاسبات سنگین باعث می‌شود EA برای مدت طولانی روی نمودار “معلق” بماند و تجربه کاربری ضعیفی ایجاد کند. در بک‌تست نیز، این محاسبات طولانی می‌توانند باعث کندی شدید شبیه‌سازی شوند.

راه حل: عملیات محاسباتی سنگین که نیازمند داده‌های تاریخی هستند، باید در تست استراتژی (Strategy Tester) یا در تابع OnTick (با محدودیت‌های مناسب) انجام شوند، نه در OnInit. OnInit فقط باید برای مقداردهی اولیه و تخصیص منابع باشد.

اشتباه ۲: تغییر پارامترهای معاملاتی در OnInit بدون کنترل

اشتباه: اجازه دادن به EA برای تغییر پارامترهای اصلی معامله (مانند حجم لات یا حد سود/ضرر) بر اساس داده‌های موقت که ممکن است در زمان راه‌اندازی تغییر کنند.

دلیل: اگر EA پارامترهایی را که کاربر به عنوان input تعریف کرده است در OnInit دستکاری کند و این تغییرات به درستی گزارش نشوند، ممکن است در صورت تغییر مجدد تنظیمات توسط کاربر، EA گیج شود. همچنین، اگر پارامترها نامعتبر باشند و EA سعی کند آن‌ها را به زور اصلاح کند، ممکن است در مرحله بعد شکست بخورد.

راه حل: OnInit باید صرفاً برای اعتبارسنجی پارامترهای ورودی باشد. اگر نیاز به تنظیم پارامترهای بر اساس شرایط بازار (مانند اندازه لات بر اساس بالانس حساب) است، این منطق باید به گونه‌ای طراحی شود که پس از تایید صحت اولیه، در OnTick یا OnTimer اجرا شود، یا در صورت استفاده از MQL5، در واکنشی به INIT_PARAMETERS در فراخوانی بعدی OnInit مدیریت شود.

اشتباه ۳: عدم استفاده از تفاوت MQL4 و MQL5 (بیش از حد ساده‌سازی MQL5)

اشتباه: نوشتن کد MQL5 بدون استفاده از پارامتر reason در OnInit.

دلیل: نادیده گرفتن قابلیت‌های پیشرفته MQL5، به معنای از دست دادن فرصت برای بهینه‌سازی است. به عنوان مثال، اگر EA مجدداً با پارامترهای تغییر یافته بارگذاری شود، نادیده گرفتن INIT_CHART_CHANGE باعث می‌شود EA منابعی را که قبلاً تخصیص داده شده‌اند، دوباره تخصیص دهد، که این کار زائد و غیرضروری است.

راه حل: در MQL5، همیشه پارامتر reason را بررسی کنید. اگر تغییر پارامتر باعث تغییر در هندل‌های اندیکاتور شده است، فقط هندل‌ها را مجدداً مقداردهی کنید؛ نیازی به بازنویسی کل منطق نیست.

اشتباه ۴: نشت منابع (Resource Leaks)

اشتباه: تخصیص هندل‌ها، فایل‌ها یا اشیای گرافیکی در OnInit و عدم آزادسازی آن‌ها در OnDeinit.

دلیل: این امر به آرامی منابع سیستم را مصرف می‌کند. متاتریدر برای هر EA یک ظرف منابع (Resource Container) اختصاص می‌دهد. اگرچه متاتریدر در صورت خروج ناگهانی ترمینال، حافظه را آزاد می‌کند، اما برای یک اجرای نرم و حرفه‌ای، آزادسازی صریح منابع حیاتی است.

راه حل: هر فراخوانی FileOpen باید در نهایت با FileClose متناظر شود. هر هندل (در MQL5) که در OnInit دریافت شده، باید در OnDeinit بررسی شده و منابع مرتبط با آن آزاد شوند.

نکات حرفه‌ای برای بهینه‌سازی عملکرد اکسپرت با استفاده صحیح از OnInit

بهره‌برداری کامل از قابلیت‌های OnInit می‌تواند به طور چشمگیری عملکرد (Performance) و سرعت بارگذاری EA را بهبود بخشد.

Pre-fetching داده‌ها (پیش‌دریافت داده‌ها)

به جای اینکه در OnTick منتظر بمانید تا تابع CopyBuffer یا CopyRates اولین داده‌های لازم را بازیابی کند، می‌توانید در OnInit یک یا دو بار این توابع را با استفاده از پارامترهای آفست (Offset) مناسب فراخوانی کنید. این کار باعث می‌شود که در اولین تیک، داده‌های اولیه (مثلاً آخرین بسته شدن قیمت) بلافاصله در دسترس باشند و نیاز به انتظار برای یک فراخوانی موفق CopyBuffer در OnTick کاهش یابد. اگرچه این کار باعث کمی تأخیر در بارگذاری EA می‌شود، اما اجرای اولین OnTick را بسیار سریع‌تر می‌کند.

مقداردهی اولیه ساختارهای داده پیچیده (MQL5 Classes)

در MQL5، اگر از برنامه‌نویسی شیءگرا استفاده می‌کنید و کلاس‌های سفارشی (Custom Classes) برای مدیریت سبد معاملات یا تحلیل‌های پیچیده دارید، سازنده (Constructor) این کلاس‌ها باید در OnInit فراخوانی شوند. این تضمین می‌کند که شیء به درستی ساخته شده، متغیرهای داخلی آن مقداردهی اولیه شده و آماده استفاده در OnTick باشد. اگر کلاس شما نیاز به دریافت هندل‌ها یا تنظیمات اولیه دارد، باید این منطق را مستقیماً در OnInit و درون فراخوانی سازنده کلاس‌ها بگنجانید.

استفاده از CTrade در MQL5

کلاس‌های استاندارد MQL5 مانند CTrade برای مدیریت سفارشات، باید در OnInit مقداردهی اولیه شوند. این کلاس دارای متغیرهای داخلی است که باید پیکربندی شوند (مانند تنظیم Magic Number یا تنظیم سطح دقیق بودن قیمت‌ها). اطمینان از تنظیم این پارامترها در مرحله راه‌اندازی، از تداخل‌های معاملاتی ناخواسته در حین اجرای OnTick جلوگیری می‌کند.

بررسی دسترسی به فایل‌ها (File Access Permissions)

در برخی موارد، به خصوص در سرورهای مدیریت شده یا محیط‌های امنیتی بالا، ممکن است EA نتواند فایل‌ها را در پوشه MQL4/Files یا مسیرهای دیگر بنویسد یا بخواند. OnInit فرصتی عالی برای تلاش برای باز کردن یک فایل موقت و نوشتن یک خط ساده در آن است. اگر این عملیات با شکست مواجه شود (GetLastError خطا دهد)، می‌توان فهمید که محدودیت‌های سیستمی وجود دارد و EA باید قبل از ورود به معاملات، با بازگرداندن INIT_FAILED متوقف شود.

نقش OnInit در تست استراتژی و بک‌تست (Strategy Tester)

نقش OnInit در محیط تست استراتژی (Strategy Tester) بسیار حیاتی است و مستقیماً بر قابلیت اعتماد نتایج شبیه‌سازی تأثیر می‌گذارد.

شبیه‌سازی رفتار

هنگامی که یک EA را در بک‌تست اجرا می‌کنید، تستر استراتژی دقیقاً همان توالی فراخوانی را شبیه‌سازی می‌کند که در بازار زنده رخ می‌دهد. این یعنی تابع OnInit دقیقاً یک بار قبل از شروع پردازش اولین کندل (یا اولین تیک در حالت تیک واقعی) فراخوانی می‌شود.

تأثیر بر تاریخچه داده‌ها

اگر در OnInit، شما هندل یک اندیکاتور سفارشی را دریافت می‌کنید، در بک‌تست این هندل بر اساس داده‌های تاریخی موجود در تاریخچه تستر مقداردهی می‌شود. اگر مقداردهی اولیه به درستی انجام نشود، داده‌هایی که OnTick سعی در بازیابی آن‌ها خواهد داشت، ممکن است خالی باشند یا به دلیل دریافت هندل نامعتبر، منجر به خطا شوند.

بررسی پارامترهای بهینه‌سازی (Optimization Parameters)

یکی از مزایای استفاده از پارامترهای input و اعتبارسنجی در OnInit در حین بهینه‌سازی (Optimization) مشخص می‌شود. اگر شما یک محدوده بهینه‌سازی (Optimization Range) تعریف کرده باشید که منجر به ورودی‌های غیرمنطقی برای EA شود (مثلاً دوره میانگین متحرک 5000)، OnInit باید این ترکیب را شناسایی کرده و با بازگرداندن INIT_FAILED از اجرای آن تکرار جلوگیری کند. اگر OnInit شکست نخورد، تستر برای آن مجموعه پارامتر، یک نتیجه (حتی اگر منجر به هیچ معامله‌ای نشود) ثبت می‌کند، که می‌تواند نتایج بهینه‌سازی را به اشتباه هدایت کند. با بازگرداندن شکست، شما به تستر اعلام می‌کنید که آن پارامترها برای استراتژی غیرقابل اجرا هستند.

بررسی سناریوهای واقعی که OnInit شکست می‌خورد و نحوه دیباگ کردن آن‌ها

شکست OnInit معمولاً به دلیل عدم تطابق محیطی یا ورودی‌های نادرست رخ می‌دهد. درک این سناریوها برای دیباگ سریع ضروری است.

سناریو ۱: نامعتبر بودن پارامترهای اندیکاتور

موقعیت: در MQL5، شما سعی می‌کنید هندل اندیکاتور iBands را دریافت کنید اما دوره یا روش محاسبه (Mode) را به گونه‌ای تنظیم کرده‌اید که از نظر فنی در متاتریدر مجاز نیست (مثلاً دوره 0 یا روشی که با نوع قیمت سازگار نیست).

تشخیص و دیباگ:

1. بررسی لاگ: گزارش EA نشان می‌دهد که INVALID_HANDLE برای اندیکاتور برگردانده شده است.
2. استفاده از GetLastError(): بلافاصله پس از فراخوانی iBands، GetLastError() را اجرا کنید. این تابع کد خطای خاصی را برمی‌گرداند که معمولاً نشان می‌دهد کدام پارامتر غیرقانونی بوده است (مثلاً 4102 یا 4107 در برخی خطاها).
3. راه‌حل: پارامترهای ورودی را با مقادیر پیش‌فرض ایمن جایگزین کنید یا منطقی اضافه کنید که در صورت نامعتبر بودن، از INIT_FAILED استفاده کند.

سناریو ۲: مجوزهای دسترسی و امنیت (MQL5)

موقعیت: EA نیاز به دسترسی به داده‌های بازار از نماد یا حساب دیگری دارد، یا تلاش می‌کند تا فایل‌های گزارش را در مسیری بنویسد که به دلیل تنظیمات امنیتی (مانند فعال بودن گزینه “Allow DLL Imports” به درستی تنظیم نشده باشد یا دسترسی به فایل‌ها محدود شده باشد).

تشخیص و دیباگ:

1. بررسی دسترسی به فایل: اگر مشکل مربوط به فایل باشد، FileOpen با خطا مواجه می‌شود. در MQL5، این خطاها معمولاً به محدودیت‌های امنیتی مرتبط هستند که در تب Experts به صراحت ذکر می‌شوند (مانند “File access denied”).
2. بررسی دسترسی به نماد: اگر تلاش برای دریافت قیمت‌های نماد دیگر در OnInit صورت گیرد و اجازه دسترسی به نمادهای دیگر داده نشده باشد، ممکن است شکست رخ دهد.
3. راه‌حل: اطمینان حاصل کنید که در تنظیمات ترمینال (Options -> Expert Advisors)، تنظیمات امنیتی به درستی تعریف شده‌اند. در کد، با یک try-catch (در صورت استفاده از کلاس‌ها) یا بررسی GetLastError() قبل از باز کردن فایل، این خطاها را مدیریت کنید.

سناریو ۳: اشکالات مربوط به زمان‌بندی یا وابستگی‌ها

موقعیت: EA شما به شدت به یک اندیکاتور سفارشی دیگر وابسته است که به اشتباه نام‌گذاری شده یا در پوشه اشتباهی در پوشه Indicators قرار گرفته است.

تشخیص و دیباگ:

1. بررسی دقیق نام: مطمئن شوید که نام اندیکاتور در iCustom() دقیقاً با نام فایل .ex5 یا .ex4 مطابقت دارد.
2. بررسی وابستگی‌ها: اگر اندیکاتور سفارشی شما به فایل‌های DLL وابسته است و آن DLL بارگذاری نشده باشد، هندل آن اندیکاتور نمی‌تواند ایجاد شود و OnInit شکست می‌خورد.
3. راه‌حل: در زمان توسعه، همیشه از اندیکاتورهایی که از توابع سیستمی استاندارد استفاده می‌کنند (مانند iMA یا اندیکاتورهای پیش‌فرض) در OnInit استفاده کنید، مگر اینکه از بارگذاری موفقیت‌آمیز اندیکاتور سفارشی مطمئن باشید. اگر اندیکاتور سفارشی ضروری است، باید در OnInit تلاش کنید تا با استفاده از تابع IndicatorName() یا مقایسه هندل‌ها، از وجود آن اطمینان حاصل کنید.

جمع‌بندی تکمیلی: ساختاردهی قوی برای پایداری بلندمدت

تابع مقداردهی اولیه (OnInit) بیش از یک مرحله فنی برای شروع به کار اکسپرت ادوایزر است؛ این تابع سنگ بنای معماری پایدار برنامه شما محسوب می‌شود. موفقیت در این مرحله تضمین می‌کند که محیط اجرایی به درستی آماده شده است، منابع مورد نیاز تخصیص یافته‌اند و هر گونه نقص منطقی یا پیکربندی نادرست، پیش از ورود به فاز حیاتی معاملات زنده شناسایی و گزارش شده است. برای برنامه‌نویسان حرفه‌ای، استفاده از قابلیت‌های پیشرفته‌تر MQL5، به ویژه پارامتر reason، امکان ایجاد منطق‌های راه‌اندازی تطبیقی را فراهم می‌آورد که بهینه‌سازی قابل توجهی در هنگام به‌روزرسانی تنظیمات در حین اجرای زنده به همراه دارد. تمرکز بر اعتبارسنجی دقیق پارامترهای ورودی، مدیریت صحیح خطا با استفاده از GetLastError() و اطمینان از ارتباط متقابل صحیح با توابع پاک‌سازی (OnDeinit)، از اشتباهات رایج جلوگیری کرده و قابلیت اطمینان استراتژی را به میزان قابل ملاحظه‌ای افزایش می‌دهد. یک OnInit قوی، نیمی از مسیر را به سوی یک EA پایدار، سریع و قابل اعتماد در بازارهای مالی هموار می‌سازد، زیرا اطمینان می‌دهد که تمام اجزای پیچیده سیستم، از هندل‌های اندیکاتور گرفته تا اشیای گرافیکی، در لحظه مورد نیاز آماده خدمت‌رسانی هستند. سرمایه‌گذاری زمان در نوشتن یک منطق OnInit بی‌عیب و نقص، نتیجه‌ای جز افزایش اعتماد به سیستم معاملاتی شما در شرایط مختلف بازار نخواهد داشت.