Просмотр исходного текста страницы Fopen

{{DISPLAYTITLE:fopen}}
{{Description
| Открывает файл для дальнейшего проведения операций чтения/записи.
}}
{{Params|const name[], filemode: mode{{=}}io_readwrite}}
{{Param
| const name[]
| Имя файла.
}}
{{Param
| filemode: mode
| [[filemode|Режим открытия файла]] (необязательный параметр; по умолчанию файл открывается в режиме чтения и записи).
}}
{{Returns
| Хендл открытого файла (преобразованный из указателя типа <code>FILE *</code> в языке C/C++ в ячейку Pawn) или <code>File:0</code>, если не удалось открыть файл.
}}
{{NoteInfo
| В SA-MP функция открывает файлы в каталоге <code>scriptfiles</code>. Например, если сервер находится в папке <code>C:\MyServer</code> и функции <code>fopen</code> указано имя <code>MyFile.txt</code>, то функция откроет файл <code>C:\MyServer\scriptfiles\MyFile.txt</code>.<br/><nowiki>
</nowiki>Тем не менее, можно заставить функцию вместо <code>scriptfiles</code> открыть файл в другом каталоге, указав перед именем файла <code>.\</code> для перехода на уровень вверх (в корневую папку сервера) и название каталога. Например, название <code>.\myfolder\MyFile.txt</code> заставит сервер открыть файл <code>C:\MyServer\myfolder\MyFile.txt</code>.
}}
{{NoteCritical
| После открытия файла не забывайте проверять возвращаемый функцией хендл (см. пример ниже). Если функция не сможет открыть файл и вернёт нулевой хендл (<code>File:0</code>), попытка использования такого хендла в других файловых функциях приведёт к '''падению сервера'''.
}}
{{Example}}
<pawn>
main()
{
	new File:f = fopen("myfile.txt", io_read);

	// Проверим, удалось ли открыть файл.
	if (f == File:0)
	{
		printf("Не удалось открыть файл!");
	}
	else
	{
		new buffer[128];
		new len;
		new linenum = 1;

		// Считываем строки, пока не достигнем конца файла.
		while ((len = fread(f, buffer)) != 0)
		{
			// fread() считывает строку вместе с '\n' на конце - убирём этот знак
			// из конца строки, чтобы не выводить лишний перенос в printf().
			buffer[len-1] = '\0';

			// Выводим номер строки и её содержимое.
			printf("%03d: %s", linenum++, buffer);
		}

		// Не забываем закрыть файл.
		fclose(f);
	}
}
</pawn>
{{SeeAlso}}
* [[fclose]]
[[Категория:Функции Pawn]]