Полезные рекомендации по написанию скриптов и составления сообщении

Полезные советы и заметки - новичкам и не только

Цитата:

1. Если для вас понятно то что вы пишите, это ещё не значит что и остальным оно будет также очевидно! :spy:

2. Иногда, при желаний помочь другим, хочется просто показать на полном примере, но оно не всегда полезно для того кто нуждается в помощи ... Если бы за меня вот так всегда всё делали когда я начинал (показывали всё примерами, а не указывали на нужное направление), то наврядли я бы развивался в изучении AutoIt'а :Beer:

3. Помимо обязательного тега code для участков кода, используйте тег more (или ht, позволяет указывать заголовок раскрывающегося текста) для больших кусков кода. Так легче читать сообщения, это поможет не отпугнуть тех, кто всё же решится вам помочь :).

4. Размещая вопрос, желательно при этом выкладывать код проблемного участка вашего скрипта.

5. Старайтесь предоставить как можно больше деталей касательно вашей проблемы (но не приувиличивая), гадать ещё никто не научился.

6. Старайтесь не выкладывать один и тот же пример в модифицированном виде, лучше всего поправьте своё первоначальное сообщение, и сообщите об этом остальным в новом. Но если всё-же модификация заслуживает отдельного-нового поста (например, если хочется сохранить и предыдущую версию примера), и в ней многие функции повторяются (не изменённые), то лучше их не выкладывать, а просто указать на предыдущую версию примера. Таким образом, не пострадает общение на форуме, качество сообщении, и читабельность форума в целом :).

7. Если у вас много времени, и так случилось что вы пишите сообщение довольно долго (пол часа скажем), то перед его отправкой лучше обновите страницу (на другом/й окне/вкладке), т.к возможно на ваш вопрос уже дали ответ, или (если вы пытаетесь помочь другим), похожее решение на ваше, уже предоставили, поэтому незачем плодить одни и те же решения/примеры, это затруднит в будущем поиск и нахождение действительно важного решения/ответа.

8. Ну и как (должно быть) известно, прежде чем что-либо спрашивать в этом (да и не только) разделе, используйте поиск, в нашем случае это:

Рекомендации по написанию скриптов

Цитата:

В Autoit существует только один тип данных - Variant , поэтому для удобства написания скриптов рекомендуется использовать следующие имена переменных:

Первый набор символов после знака доллара ($) должен определять тип данных. Следующий список определяет префиксы и типы данных используемы с ними:

$a<символ> - (Array) Массив данных - последующий символ взятый из списка ниже, определяет тип данных в массиве
$b - (Binary data) Двоичные данные
$h - (File or window handle) Дескриптор файла, окна, и т.д.
$i - (Integer) Целое число
$f - (Boolean) Логический тип, может принимать значения True или False
$n - (Floating point number) Число с плавающей точкой
$s - (String) Строка
$v - (Variant) Вариант, неопределенный тип данных, базовый тип для Autoit
$t - (Struct) Структура в стиле C/C++, для использования в DllCall, в сообщениях WM_*, при обработке данных и т.п.
$p - (Pointer) Указатель на структуру или на её элемент

Остальное имя переменной следует начинать с заглавной буквы, и оно должно отражать функциональность (свойства) переменной. Имена вроде “$iC” не приемлемы.
"$aiWeekDayNames" или "$iCounter" намного предпочтительнее.

Переведено с «User Defined Functions Standards».

P.S
От себя...
Такая манера написания скриптов уже стала почти стандартом среди AutoIt-кодеров, оно придаёт коду более читабельный и приятный вид.

to be continued... :mail1:

P.S
Любые предложения по улучшению, или исправленю вышеуказанных заметок, принимаются в ПМ.