fputchar

Материал из Pro-Pawn Wiki
Перейти к: навигация, поиск

Описание:

Записывает в файл 1 символ.

Параметры:

(File: handle, value, bool: utf8 = true)
File: handle Хендл открытого файла.
value Символ для записи в файл.
bool: utf8 Указывает, следует ли записывать символ в кодировке UTF-8 (от 1 до 6 байтов на символ) вместо ASCII (1 байт) (необязательный параметр, по умолчанию символ записывается в UTF-8).


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

true в случае успешной записи, иначе false.

Bug.png
Баг Pawn
Попытка передать функции неправильный хендл (т.е. не возвращённый функциями fopen() или ftemp(), либо уже закрытый с помощью fclose()) приводит к падению сервера.


Bug.png
Баг Pawn
При записи в ASCII (т.е. когда параметр utf8 равен false) функция возвращает мусорное значение.


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

main()
{
    // Создадим пустой файл и запишем в него символы 'a', 'b', 'c' и 'd'
    new File: f = fopen("1.txt", io_write);
    for (new c = 'a'; c < 'e'; c++)
        fputchar(f, c);
    fclose(f);

    // Откроем файл, считаем строку и выведем её в консоль
    new buffer[128];
    f = fopen("1.txt", io_read);
    new pos = -1;
    do {} while ((buffer[++pos] = fgetchar(f, 0)) != EOF);
    buffer[pos] = '\0';
    fclose(f);
    print(buffer); // Вывод: "abcd"
}


См. также: