Fopen RU

From SA-MP Wiki

Jump to: navigation, search

fopen

Image:Farm-Fresh text lowercase.png Примечание: Название этой функции начинается со строчной буквы.


Описание:

Открывает файл для чтения или записи в него.


Параметры:
(name[], filemode:mode = io_readwrite)
name[]Имя открываемого файла.
modeРежим работы с ним (по умолчанию: io_readwrite).


Возвращаемые значения:

Хэндл файла в случае удачного открытия или 0 при ошибке.


Image:32px-Circle-style-warning.png

Важное
Примечание

Эта функция не имеет доступа к файлам, находящимся вне папки 'scriptfiles'!


Image:32px-Circle-style-warning.png

Предупреждение!

Если вы используйте io_read и файла не существует, функция возвратит ссылку NULL. Использование несуществующих ссылок в файловых функциях вызовет падение вашего сервера!


Режимы открытия:

io_read      Открыть существующий файл на чтение.
io_write     Создать файл (или очистить уже существующий) и открыть на запись.
io_readwrite Открыть файл как для чтения, так и для записи.
io_append    Открыть файл для дозаписи. В отличие от io_write, прежнее содержимое файла не удаляется.

Пример использования:

// Окрываем "file.txt" в режиме чтения
new File:handle = fopen("file.txt", io_read),
 
	// Создаём "buf"
	new buf[128];
 
// Проверяем, открыт ли файл
if(handle)
{
	// Да, открыт
 
	// Читаем весь файл и выводим его содержимое в консоль
	while(fread(handle, buf)) print(buf);
 
	// Закрываем файл
	fclose(handle);
}
else
{
	// Ошибка, файл не открылся
	print("Файл \"file.txt\" не существует, или не может быть открыт.");
}


Связанные функции

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

  • fclose - закрывает файл
Personal tools
Navigation
Toolbox
In other languages