PUTC(3S) PUTC(3S) НАЗВАНИЕ putc, putchar, fputc, putw - запись в поток символа или машинного слова СИНТАКСИС #include int putc (c, stream) char c; FILE *stream; int putchar (c) char c; int fputc (c, stream) char c; FILE *stream; int putw (w, stream) int w; FILE *stream; ОПИСАНИЕ Макрос putc записывает символ c в поток вывода stream (в позицию, задаваемую указателем файла, если он опре- делен). Макрос putchar (c) определяется как putc (c, stdout). Функция fputc выполняет те же действия, что и макрос putc; она работает медленнее, чем putc, но занимает меньше пространства на каждое использование. Кроме то- го, функцию можно передавать в качестве аргумента. Функция putw выводит машинное слово w (значение типа int) в поток вывода stream (в позицию, задаваемую ука- зателем файла, если он определен). Размер слова машин- но-зависим. Для данной системы он составляет 32 бита. Функция putw не требует и не выполняет выравнивание по границе слова в выходном файле. СМ. ТАКЖЕ fclose(3S), ferror(3S), fopen(3S), fread(3S), printf(3S), puts(3S), setbuf(3S), stdio(3S). ДИАГНОСТИКА В случае успеха описанные функции (кроме putw) возвра- щают выводимое значение. Функция putw возвращает ferror (stream). При неудаче они возвращают константу EOF. Ошибка возникает, если файл stream не открыт на запись или, если файл вывода не может расти. Так как EOF - до- пустимое целое значение, для распознавания ошибок putw нужно пользоваться функцией ferror(3S). ОГРАНИЧЕНИЯ Поскольку putc - макрос, аргумент stream вычисляется многократно, что существенно при наличии побочных эф- фектов. В частности, вызов putc (c, *f++) ведет себя нежелательным образом. В таких случаях следует исполь- зовать fputc. Из-за возможных различий в длине слова и порядке байт файлы, сформированные при помощи putw, являются машин- но-зависимыми и могут не быть прочитаны при помощи getw на другом процессоре.