PathFunctions.dll v4.2.6.0 - библиотека для MetaTrader 4

Скайп-чат поддержки продукта: skype:?chat&blob=ltRdjnFp09LOGpvbkyqno-pOvnKg-u4uFdin6S_NyAMmswdjwR7chyV729g9
Последние версии библиотек, скриптов и приложений: ftp://zhunko_Guest:abd4vsuc@ftp.zhunko.ru

Функции библиотеки производят все возможные действия с каталогами. В том числе за пределами "песочницы" МТ4.
Все функции вырабатыают исключения в случаях ошибок. Это позволит сократить время на поиск своих ошибок при отладке кода.
Функции PathCopy( ), PathDelete( ), PathMove( ) поддерживают групповые операции. В этом случае пути надо передавать в кавычках через пробел. Сам не пробовал, но должно работать.
Билиотека работает только в ОС от Windows Vista!
В библиотеке всего 12 функций:

 //=========================================================================================================
 // 1. Функция контроллирует наличие каталога. Если каталог существует, метод возвращает TRUE, иначе - FALSE.
 bool PathCheckW(string sPath); // Путь к каталогу.
 //=========================================================================================================
 // 2. Функция очищает указанный каталог от содержимого (папки и файлы).
 //    Если каталог полностью очищен, метод возвращает TRUE, иначе - FALSE. Функция работает с UNICODE-строками.
 bool PathClearContentsW(string sPath); // Путь к очищаемому каталогу с произвольным наличием слеша в конце пути.
 //=========================================================================================================
 // 3. Функция очищает указанный каталог и вложенные каталоги от файлов.
 //    Если каталог полностью очищен, метод возвращает TRUE, иначе - FALSE. Функция работает с UNICODE-строками.
 bool PathClearFromFilesW(string sPath); // Путь к очищаемому каталогу с произвольным наличием слеша в конце пути.
 //=========================================================================================================
 // 4. Функция копирует существующий каталог, включая его дочерние элементы. Если каталог существует, то функция
 //    перезаписывает их. Старые данные при этом уничтожаются. Если каталог скопирован, функция возвращает TRUE,
 //    иначе - FALSE.
 bool PathCopyW(string sExistingPath, // Имя существующего каталога или файла.
                string sNewPath);     // Имя нового каталога или файла.
 //=========================================================================================================
 // 5. Функция создаёт каталог. Если каталог создан или уже существует, функция возвращает TRUE, иначе - FALSE.
 bool PathCreateW(string sPath); // Путь к новому каталогу.
 //=========================================================================================================
 // 6. Функция удаляет любой каталог. Если каталог удалён, функция возвращает TRUE, иначе - FALSE.
 bool PathDeleteW(string sPath); // Путь к каталогу.
 //=========================================================================================================
 // 7. Функция удаляет пустой каталог. Если каталог удалён, функция возвращает TRUE, иначе - FALSE.
 bool PathDeleteEmptyW(string sPath); // Путь к каталогу.
 //=========================================================================================================
 // 8. Функция получает список каталогов и/или файлов в массив по указанному пути и маске поиска.
 //    Функция возвращает количество найденных каталогов и/или файлов. В случае ошибки функция вырабатывает
 //    исключение и возвращает -1.
 int PathGetListW(string  sPath,      // Путь к каталогу, который может содержать символы подстановки (* и ?).
                                      // Эта строка может указывать на конкретный файл типа "c:\filename.txt" или
                                      // может хранить шаблон "c:\*.*". Если указывать шаблон, то это даёт
                                      // возможность перечислить все файлы удовлетворяющие шаблону. Если
                                      // символьная строка заканчивается символом подстановки, точкой или
                                      // именем каталога, пользователь должен иметь доступ к корневому каталогу
                                      // и всем вложенным в него каталогам на пути.
                  int     nSearch,    // Выбор поиска: GL_FOLDER - поиск только каталогов.
                                      //               GL_FILE   - поиск только файлов.
                                      //               GL_ALL    - поиск каталогов и файлов.
                  string& asList[],   // Одномерный массив строк для заполнения именами файлов и каталогов.
                                      // Ячейки массива должны иметь достаточное количеством символов для приёма
                                      // имён файлов и каталогов.
                  int     nSizeList); // Размер массива списка имён файлов и каталогов.
 //=========================================================================================================
 // 9. Функция проверяет наличие пустого каталога. Функция возвращает TRUE, если каталог не пустой или FALSE,
 //    если каталог не пустой или путь не является каталогом.
 bool PathIsEmptyW(string sPath); // Путь к каталогу.
 //=========================================================================================================
 //10. Функция перемещает (переименовывает) существующий каталог, включая его дочерние элементы.
 //    Если перемещение прошло успешно, метод возвращает TRUE, иначе - FALSE.
 bool PathMoveW(string sExistingPath, // Имя существующего каталога или файла.
                string sNewPath);     // Имя нового каталога или файла.
 //=========================================================================================================
 //11. Функция создаёт символьную ссылку для указанного каталога. Если символьная ссылка создана, метод
 //    возвращает TRUE, иначе - FALSE. Функция вырабатывает исключение в случае ошибки.
 bool PathSymbolicLinkW(string sExistingDirectory,      // Имя существующего каталога.
                        string sSymbolicLinkDirectory); // Имя символьной ссылки на каталог.
 //=========================================================================================================
 //12. Функция отсекает имя файла от полного пути к файлу и возвращает путь к каталогу этого файла,
 //    содержащий входной параметр. Отличить имя файла от имени каталога невозможно. По этому надо быть
 //    уверенным, что для обработки подаётся путь с именем файла в конце. Каждый вызов функции будет отсекать от
 //    полного пути сначала имя файла, если он есть, потом имя следующего каталога, если он есть.
 string PathTrimNameFileW(string sPathFull); // Полный путь.
 //=========================================================================================================

Комплект:

1. Библиотека PathFunctions.dll.
2. Заголовочный файл библиотеки PathFunctions.mqh.
3. Тестовый скрипт с примерами Check_PathFunctions.dll.mq4.
4. Всё выше перечисленное разложенное по папкам МТ4 в архиве PathFunctions.zip.

Советы:

• Примеры использования функций библиотеки находятся в тестовом скрипте Check_PathFunctions.dll.mq4.
• Если не понятно, как пользоваться из примеров, задавайте вопросы.
• Есть предложения по совершенствованию библиотеки - предлагайте.
• Небольшое видео демонстрации работы библиотеки на примере тестового скрипта.