Функция FWRITE( )

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

Синтаксис

FWRITE(nFileHandle, cExpression [, nCharactersWritten])

Параметры

nFileHandle

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

cExpression

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

nCharactersWritten

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

Результат

Числовой

Комментарии

В отличие от FPUTS( ), функция FWRITE( ) не вставляет в конец символьной ст оки возврат каретки с переводом строки.

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