Урок 1. (основы) Итак, пока у меня есть время решил написать урок по работе с файлами с помощью встроенных в SA-MP функций, я не буду углубятся в них, а просто опишу как можно записать/прочитать в/из файла данные
Начнём мы пожалуй с перечисления тех самых функций с которыми мы будим работать
Такт 1. Описание функций
fopen(const name[], filemode: mode = io_readwrite);
функция служит для открытия файла и передачи ссылки на него для дальнейшей работы
входными параметрами являются:
name[] - имя отрываемого файла, включает и путь до него
filemode - способ открытия, по умолчанию io_readwrite, давайте поподробнее рассмотрим все способы
Quote
io_read - открывает файл с возможностью чтения, если файл не существует то произойдёт краш сервера
io_write - открывает файл и перезаписывает всё его содержимое
io_readwrite - открывает файл с возможностью чтения/записи, если файл не существует, то создаёт его
io_append - открывает файл с возможностью дозаписи файла, если файл не существует, создаёт его
[color=green]fclose(File: handle);
Функция служит для закрытия работы с файлом
входными параметрами являются:
handle - ссылка полученная функцией fopen
[color=green]fremove(const name[]);
Функция служит для удаления файла, если файл не возможно удалить, то вернёт false
входными параметрами являются:
name[] - имя включающее в себя и путь до файла
[color=green]fwrite(File: handle, const string[]);
Функция служит для записи содержимого массива в файл
входными параметрами являются:
handle - ссылка полученная функцией fopen
string[] - записываемый массив
[color=green]fread(File: handle, string[], size = sizeof string, bool: pack = false);
Функция служит для чтения построчно данных из файла
входными параметрами являются:
handle - ссылка полученная функцией fopen
string[] - массив куда будут записываться считанные данные
size - количество считываемых в строке байт
pack - запаковывать-ли строку(возможно неправильно понял ТК это и не использовал)
[color=green]fexist(const pattern[]);
Функция служит для проверки существования файла
pattern[] - имя проверяемого файла включающее в себя и путь до файла
Ну чтож, на этом я думаю пока что стоит закончить, ТК эти функции являются самыми важными для нас
Такт 2. Примеры
Давайте приведём пример чтения и записи строки в/из файла:
Пример чтения строки из файла
Quote
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 давая знать что всё прошло успешно
}
Урок 1. (основы)
Итак, пока у меня есть время решил написать урок по работе с файлами с помощью встроенных в SA-MP функций, я не буду углубятся в них, а просто опишу как можно записать/прочитать в/из файла данные
Начнём мы пожалуй с перечисления тех самых функций с которыми мы будим работать
Такт 1. Описание функций
fopen(const name[], filemode: mode = io_readwrite);
функция служит для открытия файла и передачи ссылки на него для дальнейшей работы
входными параметрами являются:
name[] - имя отрываемого файла, включает и путь до него
filemode - способ открытия, по умолчанию io_readwrite, давайте поподробнее рассмотрим все способы
Quote
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. Примеры
Давайте приведём пример чтения и записи строки в/из файла:
Пример чтения строки из файла
Quote
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 давая знать что всё прошло успешно
}
Пример записи строки в файл
Quote
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. Описание функций
[color=green]fputchar(File: handle, value, bool: utf8 = true);
Функция служит для записи символа в файл, в случае успешной записи вернёт true, иначе false
handle - ссылка полученная функцией fopen
value - записываемый символ
utf8 - включена-ли поддержка utf8
[color=green]fgetchar(File: handle, value, bool: utf8 = true);
Функция служит для чтения символа из файла
handle - ссылка полученная функцией fopen
value - идентификатор в который запишется
utf8 - включена-ли поддержка utf8
Скоро появится описание:
[color=green]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);
Источник http://wiki.sa-mp.com/