FileOperations - Файловые операции (поиск файлов и др.)

2013.09.04
Улучшение регулярных выражений, оптимизации

2013.08.02
Добавлено _FO_IsEmptyFolder
Удалена проблема с AU3Check

2013.06.15
Добавлено _FO_ShortFileSize
В функцию поиска файлов добавлены два параметра для исключения каталога из поиска
Улучшен параметр чуствительности к регистру, не требует указывать диапазон

2013.04.28
Поиск пустых папок теперь выдаёт ошибку при указании файла вместо папки

2013.04.27
Исправлено, если путь пустая строка, это не вызывало ошибки

2013.01.03
Удалены $i из объявления, так как они для цикла For принудительно локальные.
Tidy

2012.11.20
Добавлена функция _FO_IsDir
Добавлен CHM-файл с описанием

2012.08.08
Улучшен параметр учёта регистра
Текст локализации _FO_GetCopyName вынесен в опциональный передаваемый параметр

2012.06.09
Добавлена функция __FO_UserLocale, чтобы не учитывать регистр букв для локального языка.

2012.05.20
В функцию _FO_SearchEmptyFolders добавлен параметр $iFull - полный или относительный путь

2012.05.19
Добавлены две функции _FO_FileBackup, _FO_PathSplit

2012.05.14
Добавлены две функции _FO_FileDirReName и _FO_GetCopyName

2012.02.22
Улучшен Gui_Test_Search.au3 для с готовым выбором путей для тестирования
Использовавние ByRef увеличило скорость на 2.5%

2012.02.21
Присвоение символа "\" поставил до проверки пути, теперь путь к файлу не будет валидным

2012.02.16
Для избавления от возможных конфликтов аналогичных одноимённых функций других скриптёров AutoIt3, к функции добавлен префикс _FO
UDF названа FileOperations.au3
Добавлена функция _FO_SearchEmptyFolders - поиск пустых папок

2012.02.15
Убрал лишнюю объявленную переменную $i найденную с помощью Au3Check (не критично)
Для избавления проблем обфускации функция __MaskUnique добавлена в исключение директивами #Obfuscator_Off и #Obfuscator_On
Добавлены префиксы типов переменных

2012.01.10
Коррекция маски выведена в отдельную функцию _FO_CorrectMask
Добавлена проверка уникальности элементов маски

2011.11.27
Всвязи с тем что некоторые программы (в отличии от эксплорера) позволяют переименование файла с добавлением пробела или точки в начало имени, то функция не корректирует маску по этому критерию, то есть корректирует только в отношении окончания файла.
Исправлены некритические ошибки

2011.11.9
Символ разделителя ";" заменён на "|", по причине, что ";" может присутствовать в именах файлов, а значит в маске, что не должно препятствовать поиску. В случае конфликта с разделителем в скрипте можно использовать Opt("GUIDataSeparatorChar", Chr(1)) или использовать свой разделитель, а при передаче опций в функцию сделать замену разделителя в маске, например _FO_FileSearch($Path, StringReplace($Mask, ';', '|'))
Изменён порядок проверки валидности маски для наилучшего детектирования и/или исправления ошибок маски

2011.10.24
Исправлена ошибка при комбинайии Full=3 и Arr=1
Увеличена в 2 раза скорость работы _FO_FolderSearch

2011.10.22
Исправлен возврат функции __GetListMask

2011.10.17
Добавлен параметр $TypeMask с принудительной опцией маски

2011.10.15
Добавлен возврат ошибки @error = 3 - если не найдено файлов (кстати, спорный параметр, так как не найденность не является ошибкой а только отсутсвием результа, что является тоже результатом. В любом случае есть 2 варианта - программы, в которых отсутствие результата является ошибкой, так как нет смысла в дальнейшей обработке данных и программы, в которых отсутствие результата не вызывает проблем и затрат, обычное присоединение данных к предыдущему результату без обработки ошибок)

2011.10.14
Добавлен параметр $Include = True/False в функцию _FO_FolderSearch


2011.10.12
Исправление функции __FO_FileSearchMask

2011.10.10
Исправлено $Include=False, когда файлы без расширения не попадали в список исключений
Добавлена функция маски с обработкой регулярным выражением

1. Позиционирование моего варианта было по скорости, потому что я посчитал, что обработка списка за один проход будет быстрее чем вызов регулярного выражение на каждый файл. Обгон был в ~2 раза 0.43 мс против 0.75 мс для папки Windows, или 4 сек против 10 сек для диска C. Иногда оппоненты приводят заявления, что если уменьшить количество проверок, то это является причиной, по которой функция может работать быстрее, то есть смысл подан и многие начинают верить, хотя опять же говорится это в общем, то есть как бы и опровергать то нечего, но смысл как бы заложен. На самом деле выйгрышь только за счёт обработки регулярным выражением всего списка.

2. Функция от Melba23 добавлена в версию 3.3.9.19, а в ней регулярные выражения имеют уже новый движок, вренее тот же движок но с обновлённой версией и новыми параметрами компиляции движка PCRE, а именно: если раньше вызвать функцию регулярного выражения с пустыми параметрами в цикле, то скорость достаточно высока, то есть сам вызов не мог тормозить функцию, но тормозит её то, что якобы данные переданные для обработки и данные обрабатываемые внутри движка в разных форматах, поэтому приходится приводить к одному формату. На новом движке (с включенным флагом юникода при компиляции проекта) этой проблемы нет, а значит разрыв должен уменьшиться почти до нуля (я ещё не проверял). Во вторых добавленная в мою функуию полезный параметры "Не учитывать регистр букв для всех языков" тоже покрывается обновлённым движком, так как теперь он компилируется с поддержкой UTF16 внутри движка и теперь \w включает символы русские и вообще любые, арабские, турецкие и т.д., аналогично (?i) также не учитывает регистр и для кириллицы.

3. Многим нравится, что функция от Melba23 поддерживает сортировку, атрибуты, но я к примеру многие такие фичи считаю пустыми, так как я вполне могу отправить полученный результат в _ArraySort и будет такая же сортировка, также я могу прокрутить массив в параллельном цикле для получения атрибутов. То есть я не вижу причин, чтобы включать эти фичи в функцию дополнительным флагом, тем самым усложняя пользовательский интерфейс функции. Хотя прирост скорости всё же есть за счёт использования расширенного вызова API, которая сразу получает атрибуты и файл, то есть при указании атрибутов функция переключается на использование расширенного вызова, тем самым работает быстрее чем сумма функций получение файла и запроса атрибутов.
Кстати при запросе файлов у Melba23 используется алгоритм, который возвращает файлы в обратном порядке в пределах каждой папки и это требует обязательной сортировки, если необходимо сделать список для просмотра. Моя функция запрашивает упорядоченно, но это всё же не соответствует точной сортировке как в проводнике, так как FAT32 выдаёт полностью не сортированный порядок файлов, а NTFS выдаёт сортированный в пределах алфавита и цифр, но в остальных спец-символах сортировка не соответствует. В принципе результат получается достаточно сортированный и в 90% случаев не требует сортировки для представления результата списком. У Melba23 для представления сортировать нужно в любом случае. Но известно, что частично сортированный результат сортируется быстрее.

4. Флаг исключить маску немного удивлял тем, что мы указываем маску доступных, например "exe|dll" и указываем исключения, например jpg, но сама маска уже определяет что включать, а что будет исключено. Возможен конечно случай, когда создавая маску включения трудно описать исключения, но опять же я в реальной ситуации я не сталкивался с необходимостью, только мог выдумать причину, что это может когда то пригодиться.

5. Маска (у Melba23) использует разделитель ";", но этот символ может быть в имени файла, соответственно накладывает ограничение.

6. Многие параметры конфликтуют между собой, в зависимости ищем ли мы папку или файлы и в зависимости рекурсивный ли поиск, это немного путает, поэтому я и сделал раздельные функции для папки и файлов. Я не нахожу причин получать вместе папки и файлы для рекурсивного поиска, потому что не нахожу случаев, когда это можно обрабатывать вместе.

7. Кроме того проверку маски я вынес в отдельную функцию _FO_CorrectMask. Она не тратит слишком много времени, но разграничивает вариант, когда маска указывается внутри скрипта и программист не ошибается, так как тестирует и может применять в цикле функцию и вариант когда маска указывается пользователем и вероятность ошибки существует, то _FO_CorrectMask достаточно точно проверяет все ошибки и не пропустит неверную маску

Я добавил флаг исключения каталогов и то по причине просьбы, хотя в реальности сам я его ни разу не применял, кроме теста конечно же.