CDir Class (MT5): Navigating and Inspecting Directory Contents
Info
The CDir Class (MT5): Navigating and Inspecting Directory Contents is a Library for MetaTrader 5 that this utility class allows you to go beyond the standard mql5 sandbox to examine directory contents. You can check for the existence of files or directories, retrieve file attributes, size, and timestamps (creation, last access, last write).
Usage
This tool is typically used for enhancing chart analysis and decision making.
Platform
This Library works exclusively on MetaTrader 5 (both build 600+ and newer versions).
Setup
Place the downloaded file in MQL5/Libraries folder via File ? Open Data Folder in MetaTrader 5.
How to Install and Use CDir Class (MT5): Navigating and Inspecting Directory Contents
1. Storage: Place library files in the MQL/Libraries directory to ensure they are accessible to your projects.
2. Implementation: Include the library in your code using the #import directive, ensuring you match the exact function names and parameters.
3. Compilation: Ensure the library is present in the directory before you compile your main EA or script, as the compiler links them during this phase.
4. Management: Keep libraries organized in sub-folders if you manage many custom functions to maintain a clean project structure.
Frequently Asked Questions
Q: What is a library file used for? A: Libraries store reusable code modules, allowing you to centralize common logic used by multiple EAs or indicators.
Q: Is a library executable? A: No, libraries are non-executable files containing functions; they must be imported into an EA, indicator, or script to function.
Q: Can I update a library while the platform is running? A: You should compile your EA or script after updating a library to ensure the latest code changes are integrated.
What this tool does
This utility class allows you to go beyond the standard MQL5 sandbox to examine directory contents.
Typical Use Case
This Library excels in automated trading and technical analysis on MetaTrader 5.
Compatible Platform & Setup
This Library works on MetaTrader 5. Place the file in the MQL5/Libraries folder and restart the terminal.
Description & Settings
Related: simplified order management class for mt4/mt5 - another powerful library for MetaTrader 5 traders.
This utility class allows you to go beyond the standard MQL5 sandbox to examine directory contents.Also recommended: class calc frac - custom bar count for fractal detection - similar library with strong performance on MetaTrader 5.
You can check for the existence of files or directories, retrieve file attributes, size, and timestamps (creation, last access, last write).Directory Navigation and File System Operations in MT5
Accessing files and directories outside the default MQL5 sandbox is often necessary for tasks such as verifying file existence, retrieving file attributes, or obtaining file metadata like size and timestamps.
The provided code demonstrates how to achieve these operations using the CDir class.
The include statement #include
The `path` string variable can specify a directory path relative to the terminal's running directory. For instance, navigating two levels up can lead to user data directories shared across terminals.
While it might seem straightforward to navigate directories by simply moving up one level, this class provides flexibility for accessing specific directories like 'crashes' or 'tester', offering a more instructive approach.
Upon creating an instance of the CDir class, the `total` variable holds the count of files and subdirectories within the specified directory.
By iterating through the directory contents, you can list directories (optionally skipping shared directories). The example illustrates accessing instance data through the `file` class's working data structure.
An example of printing a portion of the directory contents, filtered to include elements starting with the letter 'm', showcases other methods for interacting with class members.
Further code examples demonstrate how to check for the existence of a specific file and determine its length.
The example script concludes with a demonstration of using references to the class instance that stores the directory content elements.
It is anticipated that most users will find this method for accessing class data highly practical.
Additional information regarding file attributes may be necessary for a complete understanding.
We hope this example and the CDir class prove valuable for your development in 2026.
Enjoy using it!
You may also like: cgv class for global variables - excellent alternative for library users on MetaTrader 5.
Source Code
/.......
⚠ Limitations & Risk Warning
- This tool is provided for educational and testing purposes only.
- Past performance does not guarantee future results.
- Trading involves substantial risk of loss. Use on a demo account first.
- Results may vary depending on market conditions, broker, and settings.
- We recommend thorough backtesting and forward testing before using with real funds.