Работа с файлами

From SA-MP Wiki

Jump to: navigation, search

Работа с файлами

Урок 1. (основы)


Итак, пока у меня есть время решил написать урок по работе с файлами с помощью встроенных в SA-MP функций, я не буду углубятся в них, а просто опишу как можно записать/прочитать в/из файла данные

Начнём мы пожалуй с перечисления тех самых функций с которыми мы будим работать


Такт 1. Описание функций

fopen(const name[], filemode: mode = io_readwrite); функция служит для открытия файла и передачи ссылки на него для дальнейшей работы входными параметрами являются:

name[] - имя отрываемого файла, включает и путь до него filemode - способ открытия, по умолчанию io_readwrite, давайте поподробнее рассмотрим все способы

io_read - открывает файл с возможностью чтения, если файл не существует то произойдёт краш сервера
io_write - открывает файл и перезаписывает всё его содержимое
io_readwrite - открывает файл с возможностью чтения/записи, если файл не существует, то создаёт его
io_append - открывает файл с возможностью дозаписи файла, если файл не существует, создаёт его

fclose(File: handle); Функция служит для закрытия работы с файлом

входными параметрами являются: handle - ссылка полученная функцией fopen

fremove(const name[]); Функция служит для удаления файла, если файл не возможно удалить, то вернёт false

входными параметрами являются: name[] - имя включающее в себя и путь до файла

fwrite(File: handle, const string[]); Функция служит для записи содержимого массива в файл

входными параметрами являются: handle - ссылка полученная функцией fopen string[] - записываемый массив

fread(File: handle, string[], size = sizeof string, bool: pack = false); Функция служит для чтения построчно данных из файла

входными параметрами являются: handle - ссылка полученная функцией fopen string[] - массив куда будут записываться считанные данные size - количество считываемых в строке байт pack - запаковывать-ли строку(возможно неправильно понял так как это и не использовал)

fexist(const pattern[]); Функция служит для проверки существования файла pattern[] - имя проверяемого файла включающее в себя и путь до файла

Ну что ж, на этом я думаю пока что стоит закончить, Так как эти функции являются самыми важными для нас.


Такт 2. Примеры

Давайте приведём пример чтения и записи строки в/из файла:

Пример чтения строки из файла:

stock ReadOneString(file[],tostring[])
{
if(!fexist(file)) return -1; /* проверяем наличие файла file, если он не существует то прекращаем выполнение функции и возвращаем значение -1 */
 
new File:opnfile; // создаём файловую переменную
opnfile=fopen(file,io_read); /* открываем файл file с возможностью чтения и записываем его идентификатор в opnfile */
fread(opnfile,tostring); // читаем первую строку из файла и записываем её в tostring
fclose(opnfile); // закрываем работу с файлом
return 1; // возвращаем 1 давая знать что всё прошло успешно
}

Пример записи строки в файл:

stock WriteOneString(tofile[],string[])
{
new File:opnfile; // создаём файловую переменную
opnfile=fopen(tofile,io_append); /* Открываем файл с параметром io_append, в данном случае он больше всего подходит */
fwrite(opnfile,string); // записываем в файл строку string
fclose(opnfile);// закрываем работу с файлом
return 1; // возвращаем 1 давая знать что всё прошло успешно
}

Урок 2. (освоение)

В этом уроке мы опишем остальные стандартные функции по работе с файлами.

Такт 1. Описание функций

fputchar(File: handle, value, bool: utf8 = true); Функция служит для записи символа в файл, в случае успешной записи вернёт true, иначе false handle - ссылка полученная функцией fopen value - записываемый символ utf8 - включена-ли поддержка utf8

fgetchar(File: handle, value, bool: utf8 = true); Функция служит для чтения символа из файла handle - ссылка полученная функцией fopen value - идентификатор в который запишется utf8 - включена-ли поддержка utf8


Скоро появится описание: fblockwrite(File: handle, const buffer[], size = sizeof buffer); fblockread(File: handle, buffer[], size = sizeof buffer); fseek(File: handle, position = 0, seek_whence: whence = seek_start); flength(File: handle); fmatch(name[], const pattern[], index = 0, size = sizeof name);


Personal tools