Функция FPUTS( )

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

Синтаксис

FPUTS(nFileHandle, cExpression [, nCharactersWritten])

Параметры

nFileHandle

Задает дескриптор файла, соотвествующий файлу или порту связи, куда функция FPUTS( ) собирается писать данные.

cExpression

Задает символьное выражение, которое функция FPUTS( ) пишет в файл или порт.

nCharactersWritten

Задает число символов в выражении cExpression, которые нужно записать в файл или в порт.

Если аргумент nCharactersWritten опущен, функция FPUTS( ) запишет в файл или в порт все символьное выражение cExpression целиком. Если задать аргумент nCharactersWritten, в файл или порт будет записано nCharactersWritten символов. Если значение nCharactersWritten меньше количества символов в выражении cExpression, в файл или порт записывается только nCharactersWritten символов. Если значение nCharactersWritten равно числу символов в выражении cExpression или больше его, в файл или порт записывается все выражение.

Результат

Числовой

Комментарии

Функция FPUTS( ) возвращает число байтов, записанных в файл или порт. Если FPUTS( ) не в состоянии выполнить запись в файл или порт по той или иной причине, возвращается 0.