Уроки Pawno: инклуды Dini и mxINI

7 квітня 2013

TheDuke

Данный урок расскажет вам о функциях инклудов Dini и mxINI. Так-же вы научитесь пользоваться данными инклудами.

Приветствую дорогих читателей.

Задался вопросом, что почему-то долго не писал статейки сюда. Посмотрев категорию "Учебники" в файловом архиве GTA SA, я подумал - там что-то очень мало хороших качественных учебников, и я решил написать свой, как говорится продолжить начатую работу. Так как связь с BadMan'ом держать в скайпе не могу, пишу лично от себя.

Начну со слова Инклуд.

Include (Инклуд) - это система функций для скрипта. Основным инклудом является "a_samp" - он всегда должен быть в скриптах.

Сегодня мы изучим два простых инклуда - Dini и mxINI. Для тех, кто не знает, что это за инклуды - это простые файловые инклуды для SAMP сервера. То есть файловая система для SAMP. Данная файловая система не служит для связки сайта и сервера - этим занимается MySQL или даже SQLite, о которых я напишу чуть позже (в следующих уроках).

Как записать include?

#include IncName

# - подключение
include - обозначение подключения инклуда
IncName - как уже понятно - название инклуда.

В основном люди пишут название инклуда без формата файла (например #include a_samp), но и с форматом тоже правильно, и ошибкой не считается (например #include a_samp.inc). Мы будем подключать один из двух инклудов - Dini и mxINI (если они имеются в папке "Ваш_Сервер/pawno/includes")

#include mxINI#include Dini

Итак - чем же всё-таки различаются данные системы?

Dini - Более функциональная файловая система в плане названий функций, но она медленно передаёт и получает значения.
mxINI - Менее функциональная файловая система в плане названий функций, но быстрей получает значения.

В прошлых уроках мы изучали функции вызова сообщений в чат или на экран (Send...Message, GameText...). Так вот тут они могут нам понадобится. Мы не проходили форматирование текста. Чтобы продолжить, нам понадобится функция форматирования.

format(name, sizeof(name), "Text", Text Strings);

format - название функции форматирования
name - название форматированного текста (должен быть определённый массив "New")
sizeof(name) - переменная от массива name
"Text" - текст внутри форматирования

Что он из себя представляет? Обычный текст, в который можно вставить определённые заданные значения/названия.

Собственно какие значения/названия:

%s - Текстовое значение (+ если имеется числовое)%d - интегрированное числовое значение (например playerid)%i - интегрированное значение (заданное определённым массивом "New")%c - символ%f - десятичное числовое значение (например расстояние до определённой точки)%x - номер%% - процент значения

И, наконец, Text Strings - значение текста (приведённого в CODE (%s, %d и т.д.))

Создадим простой текст:

new code[30]; // Создаём массив в 30 символов теперь нам доступноnew name[24]; // Создаём массив в 24 символа - максимальное количество символов в имени игрока (вместо name может быть любое другое слово, только если вы собрались менять его - меняйте все name массивы в коде)GetPlayerName(playerid, name, 24); //Узнаём имя игрока (можно использовать ещё так: GetPlayerName(playerid, name, sizeof(name)); - sizeof(name) само определит, какое значение переменной у массива name)format(code, 30, "Ваш ник %s, ваш ID - %d", name, playerid);//Проверяем ник игрока и его IDSendClientMessage(playerid, -1, code);// Отправим отформатирование сообщение "code" в чат белым цветом (-1)

Довольно простенькая функция.

Итак. Теперь начнём изучение данных файловых систем. Начнём с проверки на имеющийся файл.

Dini:

dini_Exists("filename.fmt")

filename.fmt - название файла в кавычках (можно использовать отформатированный текст). В конце filename должен быть формат файла (например .txt, или .ini, или .cfg и т.д.)

mxINI:

Данной функции не имеется, но можно использовать стандартную файловую систему:

fexist("filename.ini")

filename.ini - такой-же как на Dini, но для mxINI читается только .ini формат

Например сделаем проверку на существующий файл main.txt (сохраняется всё и читается всегда с папки scriptfiles) на Dini

if(dini_Exists("main.txt")) SendClientMessage(playerid, 0xFF0000FF, "Файл main.txt существует")

Или же на FSAMP (Стандартная файловая система, так как mxINI не имеет такой функции)

if(fexist(main.txt)) SendClientMessage(playerid, 0x00FF00FF, "Файл main.txt существует");

Следующей функцией будет создание файла.

Dini:

dini_Create("filename.fmt")

filename.fmt - как обычно

mxINI:

new file = ini_createFile("filename.ini")

new file - Создаём файл
filename.ini - как обычно, но формат .ini

Например создадим простой файл на Dini

dini_Create("Main.txt");if(dini_Exists(Main.txt)) SendClientMessage(playerid, 0xFF00FFFF, "Файл Main.txt создан");

И на mxINI:

new PlayerFile = ini_createFile("Main.ini");if(fexist(Main.ini)) SendClientMessage(playerid, 0xFF0000FF, "Файл Main.ini создан");

Следующей функцией будет открытие файла.

Dini:

Данной функции не имеется, но она и не нужна, так как dini_Exists("filename") сразу открывает файл.

mxINI:

new file = ini_openFile("filename.ini");

Например откроем файл на mxINI (так как пример с Dini - dini_Exists уже разобран)

new File = ini_openFile("Main.ini");

Следующей функцией будет закрытие файла.

Dini:

В Dini не понадобится данная функция, так как файл не открывается, а проверяется и сразу читается при установке значений (функции ниже)

mxINI:

ini_closeFile(file)

file - это созданный массив с переменной файла

Например откроем и закроем файл на mxINI:

new FileName = ini_createFile("Main.ini");ini_closeFile(FileName);

Следующей функцией будет удаление файла.

Dini:

dini_Remove("filename.fmt")

mxINI:

Данной функции не имеется, но можно использовать стандартную файловую систему:

fremove("filename.ini")

Например создадим и удалим файл на Dini:

dini_Create("Main.ini");dini_Remove("Main.ini");

и на mxINI

new ForFile = ini_createFile("Main.ini");fremove("Main.ini");

Следующими функциями будут записи в файл.

Dini:

dini_Set("filename.fmt", "Line", "Text"); //Установка текстового значения dini_IntSet("filename.fmt", "Line", value); //Установка числового значенияdini_FloatSet("filename.fmt", "Line", floatvalue); //Установка числового десятичного значенияdini_BoolSet("filename.fmt", "Line", boolsmb);//Установка правдивого/лживого значения

filename.fmt - Название файла с форматом
Line - Строка (название)
Text - Текст в строке
value - числовое значение
floatvalue - десятичное числовое значение
boolsmb - значения правдивое/лживое (тут только true или false)

mxINI:

ini_setString(File, "Line", "Text"); //Установка текстового значения ini_SetInteger(File, "Line", value); //Установка числового или правдивого/лживого (1 или 0) значенияini_setFloat(File, "Line", floatvalue); //Установка числового десятичного значения

File - созданный файл (new File = ini_...File("filename.ini")
Line - строка
Text - текст
value - числовое значение (для лживого/правдивого используются 1 или 0)
floatvalue - десятичное значение

Например создадим файл с тестовыми (TEST) данными на Dini:

dini_Create("main.txt");dini_Set("main.txt", "Тест", "Это строка обозначает тестовое значение"); // Допустим в строку Тест напишется текст "Это строка обозначает тестовое значение"dini_IntSet("main.txt", "Значение", 5); //Допустим значение = 5dini_FloatSet("main.txt", "Десятичное значение", 10.261); //Допустим запишем значение 10 целых, 261 тысячная.dini_BoolSet("main.txt", "Этот файл есть в папке scriptfiles?", true); // Записано значение true к обычному, ничего не делающему тексту dini_Remove("main.txt");

Дальше mxINI:

new Test = ini_createFile("Main.ini");ini_setString(Test, "Строка", "Это действительно строка"); //Создадим строку "Строка", и запишем в неё текст "Это действительно строка"ini_setInteger(Test, "Сейчас какой год?", 2013); //Создадим строку про год, и запишем в неё информацию о данном году.ini_setFloat(Test, "Максимально допустимое значение", 12.5); //В строку со значением запишем десятичное числоfremove("Main.ini");

Следующими функциями будут чтения файлов

Dini:

dini_Get("filename.fmt", "Line"); //Чтение текстового значения со строкиdini_Int("filename.fmt", "Line"); // Чтение числового значения со строкиdini_Float("filename.fmt", "Line"); // Чтение десятичного значения со строки. Проверка записывается через "new Float:NAME" (пример ниже)dini_Bool("filename.fmt", "Line"); // Чтение булового (true/false) значения со строки. Проверка записывается через "new bool:NAME" (пример ниже)

mxINI:

ini_getString(File, "Line", returnSave); //Чтение текстового значение строки, и сохранение этого текстаini_getInteger(File, "Line", returnSave); //Чтение числового/булового (true/false) значения строки, и сохранение этого значенияini_getFloat(File, "Line", returnSave); //Чтение десятичного значения строки, и сохранение этого значения

File - созданный файл (new File = ini_...File("filename.ini")
Line - Строка
returnSave - сохранение (объявлять через new)

Например прочитаем созданные выше значения через Dini:

if(dini_Exists("Main.txt")){ SendClientMessage(playerid, 0xFF0000FF, dini_Get("Main.txt", "Тест")); //Определим строку с текстом, прочитаем, и сразу же выведем SendClientMessage(playerid, 0x00FF00FF, dini_Int("Main.txt", "Значение")); //Определим строку со значением, прочитаем, и сразу же выведем SendClientMessage(playerid, 0x0000FFFF, dini_Float("Main.txt", "Десятичное значение")); //Определим строку с десятичным значением, прочитаем, и сразу же выведем SendClientMessage(playerid, 0xFFFF00FF, dini_Bool("Main.txt", "Этот файл есть в папке scriptfiles?")); //Определим строку с буловым (true/false) значением, прочитаем, и сразу же выведем}

И сделаем такое же действие на mxINI:

if(fexist("Main.ini")) //Если файл существует{ new Req = ini_openFile("Main.ini"); //То откроем его new returnStr[18], returnInt, returnFloat; ini_getString(Req, "Строка", returnStr); //Определим строку, и запишем её данные в returnStr ini_getInteger(Req, "Сейчас какой год?", returnInt); //Определим строку, и запишем её данные в returnInt ini_getFloat(Req, "Максимально допустимое значение", returnFloat); //Определим строку, и запишем её данные в returnFloat SendClientMessage(playerid, 0xFF0000FF, returnStr); //Выведем полученное из строки с текстом SendClientMessage(playerid, 0x00FF00FF, returnInt); //Выведем полученное из строки со значение SendClientMessage(playerid, 0x0000FFFF, returnFloat); //Выведем полученное из строки с десятичным значением ini_closeFile(Req); //А потом закроем открытый файл}

Следующими функциями будут специальные файловых систем

Dini:

dini_Isset("filename.fmt", "Line"); // Проверка - имеет ли значение строкаdini_Unset("filename.fmt", "Line"); // Удаления значения одной любой строки (Srt, Float, Bool, Int)

mxINI:

ini_removeKey(File, "Line"); // Удаление значения со строки любого вида (String, Integer, Float)ini_getErrorInfo("Error"); //Информация об ошибке в текстовом виде (про данную функцию ничего не известно, так как в инклуде нет stock'a с данной функцией)

Например сделаем простенькую функцию на Dini:

if(dini_Exists("Main.txt")) //Если существует файл{ if(!dini_Isset("Main.txt", "Тест")) //То проверяем, свободна ли строчка "Тест" { dini_Unset("Main.txt", "Тест"); //Если занята, то очищаем её } else if(dini_Isset("Main.txt", "Тест")) //Но если свободна { dini_Set("Main.txt", "Тест", "Просто строка с этими 9ю словами и одной цифрой"); //То устанавливаем ей значение }}

На этом мой урок по функциям файловой системы закончен, удачи в скриптинге.

Рейтинг: 1 (1 голосів)

Busy Pedestrians: Peds Events Project

Ця модифікація — об'єднання великої кількості моїх модифікацій, пов'язаних з людьми, які пожвавлюють навколишній світ і додають величезну різноманітність у гру. Модифікації об'єднані одним загальним ifp файлом, але знаходяться кожна в окремій папці,...

Artem.1.9.9.6 112

38796 444.11 MB

3 червня 2024 GTA San Andreas

The weapon is on the player

Мод дозволяє відображати основну та другорядну зброю на гравці, якщо така є. У файлі .ini під себе можна налаштувати наступне: Включити або вимкнути відображення основної або другорядної зброї; Вибрати пріоритети для відображення, наприклад, пр...

Artem.1.9.9.6 13

5282 7.45 kB

26 жовтня 2024 GTA SA (iOS, Android)

PS2 to Mobile + Fixes

Всім привіт! Ця збірка є спробою перенести PS2 версію GTA SA з усіма її фішками та особливостями - текстурами, атмосферою, відмінною від інших версій картою та багатьом іншим з відповідною адаптацією під мобільну платформу гри. Крім усього іншого,...

Raskul 1211

258527 1024.00 kB

15 червня 2024 GTA San Andreas

Rear lights Mod v3.4

Простий мод, що додає ефект швидкості до задніх фар, коли вони включені (зазвичай вночі), при використанні нітро і при гальмуванні. У файлі .ini ви можете налаштувати безліч параметрів, таких як прозорість, розмір, стиль ефекту, дублювати ефект, пол...

Artem.1.9.9.6 28

11080 19.08 kB

28 травня 2024 GTA San Andreas

DYOM# v1.7

DYOM# — додаток для DYOM, завдяки якому створення місій стане набагато зручнішим. DYOM# - це виправлення багів, нові об'єкти, нові пікапи та безліч додаткових функцій. Повну інструкцію до додатку дивіться на офіційному сайті . ВЕРСІЯ 1.7 НЕ РЕК...

SIZZZ 46

9451 54.76 kB

21 березня 2024 GTA San Andreas

Реакція поліції на порушення правил дорожнього руху v2.0 (Fix)

У даній модифікації за порушення правил дорожнього руху вас переслідуватиме поліцейський патрульний, щоб ви сплатили штраф. Якщо не відірватися від поліції за відведений час, ви отримаєте зірки розшуку. Якщо сплатити штраф, то ви зможете далі спокій...

Artem.1.9.9.6 35

13506 165.66 kB

25 березня 2024 GTA San Andreas

Вуличні музиканти v4.0

Тепер вуличні музики по всьому штату San Andreas! У кожному місті ви можете зустріти унікальні музичні колективи, унікальних виконавців, які грають різні мелодії, і все це на таких інструментах як: Скрипка; Саксофон; Гітара; Синтезатор; Е...

Artem.1.9.9.6 51

8664 86.49 MB

1 серпня 2024 GTA San Andreas

Великий збірник транспорту у стилі SA V2

Це є величезна збірка нового транспорту V2 для GTA San Andreas (замінено більше 137 одиниць машин та ін. т/с). Особливості: Усі транспортні засоби виконані у стилі SA; Пак не псує атмосферу гри; Машини мають власний тюнінг; Усі машини ма...

Thomas_Mad 31

5021 15.26 MB

16 травня 2021 GTA 3

GTA 3 titles upscaled

Інтроролик GTA 3, збільшений у 2 рази з використанням ІІ. Оригінальний файл було взято з PlayStation версії гри.

Артём Шебунин 2

3246 42.74 MB

22 вересня 2024 GTA San Andreas

DrIVe Mod

Цей мод це поєднання моїх 4 попередніх модів, а саме: Stealing a car like in GTA 4 Stop animation like in GTA4 Starting the engine like in GTA4 Steering wheel Тепер їх об'єднує один загальний ifp файл, але ви можете видалити не ц...

Artem.1.9.9.6 24

13204 88.25 kB

12 червня 2024 GTA Vice City

Vice Extended 3.0

Даний мод додає нові ігрові механіки та змінює вже існуючі, а також покращує ігровий процес загалом, роблячи його схожим на більш сучасні GTA. Увага! Старі збереження не працюють, необхідно розпочати нову гру або скористатися збереженням, яке знахо...

Cowboy69 177

54106 55.79 MB

26 березня 2024 GTA San Andreas

Garbage Mans v1.1

Даний мод додає сміттярів, що роз'їжджають містом і збирають сміття. Зустріти їх можна рано-вранці в житлових районах міста. Update 26.03.2024 Виправлено баг, через який сміттярі могли не сповнитись навіть на стандартному транспорті. v1.1 Д...

Artem.1.9.9.6 26

6409 1.08 MB

16 квітня 2024 GTA San Andreas

CoverMod v1.3

Модифікація додає можливість ховатися за стіною, об'єктом чи машиною, з можливістю вести прицільний вогонь чи вогонь наосліп. Ви можете вести прицільний вогонь, виходячи трохи з-за кута, або якщо це низька перешкода вставаючи вгору; Вогонь на...

Artem.1.9.9.6 24

11030 153.49 kB

12 листопада 2024 GTA SA (iOS, Android)

Hot Coffee Mobile (Improved Mobile main.scm)

Доброго дня, ви потрапили на клікбейт! Що, виходить, Hot Coffee не буде? Ні, буде! Але є в цьому моді не тільки Hot Coffee, але ще й безліч найприємніших виправлень багів мобільного main.scm, покращення сюжетної лінії гри та побічних місій. З таки...

Raskul 415

103471 135.13 MB

23 жовтня 2024 GTA San Andreas

Колесо зброї Пустоти

Просте і зручне колесо зброї, яке не вибивається із загального стилю гри. Особливості: Працює як на клавіші, так і за допомогою колеса мишки; Сумісний з геймпадами (потрібен GInput); Сумісний з SAMP; Сумісність з локальним мультиплеером;...

void 19

2833 32.55 kB

Коментарі 4

Уроки Pawno: инклуды Dini и mxINI

Рекомендуемые файлы

Busy Pedestrians: Peds Events Project

The weapon is on the player

PS2 to Mobile + Fixes

Rear lights Mod v3.4

DYOM# v1.7

Реакція поліції на порушення правил дорожнього руху v2.0 (Fix)

Вуличні музиканти v4.0

Великий збірник транспорту у стилі SA V2

GTA 3 titles upscaled

DrIVe Mod

Vice Extended 3.0

Garbage Mans v1.1

CoverMod v1.3

Hot Coffee Mobile (Improved Mobile main.scm)

Колесо зброї Пустоти