5.3  标准 I/O 库

• 基本概念

• 缓冲机制

• 熟悉的标准 I/O 函数

• 陌生的标准 I/O 函数

5.3.1  基本概念

• ANSI C 和标准 I/O 库
• 流和 FILE 对象
• 标准 FILE 对象: stdin, stdout, stderror
• 缓冲和非缓冲 I/O

5.3.2  缓冲机制

• 缓冲的目的
• 缓冲类型 1: 完全缓冲
• 缓冲类型 2: 行缓冲
• 缓冲类型 3: 无缓冲
• UNIX 的默认缓冲: 标准错误无缓冲, 其他流如果是终端设备则为行缓冲, 否则为完全缓冲.
• 在打开流, 且执行任何读写操作之前, 可以用 setbuf, setvbuf 等函数改变流的缓冲类型.

===============================================================================
        #include <stdio.h>

        void setbuf(FILE *stream, char *buf);
        void setbuffer(FILE *stream, char *buf, size_tsize);
        void setlinebuf(FILE *stream);

        int setvbuf(FILE *stream, char *buf, int mode , size_t size);
===============================================================================

• setbuf: 关闭或打开缓冲, buf 大小必须为 BUFSIZE (stdio.h)
• setvbuf: 明确指定缓冲类型, 以及缓冲区大小. type 可取 _IONBF, _IOLBF, _IOFBF 之一
• 前三个函数仅仅是 setvbuff 的别名而已.
• 刷新缓冲: fflush. stream 为 NULL 时刷新所有流

===============================================================================
        #include <stdio.h>

        int fflush(FILE *stream);
===============================================================================

5.3.3  熟悉的标准 I/O 函数

• 流的打开和关闭: fopen/fclose
• 用 fopen 打开的文件的访问许可为: S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP|S_IROTH|S_IWOTH
• 单字符输入: getc/fgetc/getchar
• getc 一般实现为宏
• 流的错误处理: ferror/feof/clearerr
• clearerr 清除错误标志和EOF标志
• 返还字符: ungetc
• 单字符输出: putc/fputc/putchar
• 行输入: gets/fgets
• 行输出: puts/fputs
• 二进制读写: fwrite/fread
• 二进制读写时的结构体对齐问题
• 流的定位: ftell/fseek/rewind, SEEK_CUR, SEEK_SET, SEEK_END
• rewind 等同于 fseek(stream, 0L, SEEK_SET), 但要清除错误标志.
• 流的定位: fgetpos/fsetpos
• 格式化输出: printf/fprintf/sprintf
• 格式化输入: scanf/fscanf/sscanf

5.3.4  陌生的标准 I/O 函数

• freopen/fdopen

===============================================================================
       #include <stdio.h>

       FILE *fopen (const char *path, const char *mode);
       FILE *fdopen (int fildes, const char *mode);
       FILE *freopen  (const  char *path, const char *mode, FILE *stream);
===============================================================================

• fileno

===============================================================================
       #include <stdio.h>

       int fileno( FILE *stream);
===============================================================================

• tmpnam/tmpfile/tempnam

===============================================================================
       #include <stdio.h>

       char *tmpnam(char *s);
       FILE *tmpfile (void);
       char *tempnam(const char *dir, const char *pfx);
===============================================================================

• 格式化输出的另一种形式: vprintf/vfprintf/vsprintf

===============================================================================
       #include <stdio.h>
       #include <stdarg.h>

       int vprintf(const char *format, va_list ap);
       int vfprintf(FILE  *stream,  const  char *format, va_list ap);
       int vsprintf(char *str, const char *format, va_list ap);
       int vsnprintf(char *str, size_t size, const char  *format, va_list ap);
-------------------------------------------------------------------------------
SAMPLE:    myMessageBox 函数

int myMessageBox (HWND hwnd, DWORD dwStyle, char* title, char* text, ...)
{
    char * buf = NULL;
    int size = 0;
    int i = 0;
    va_list args;
    int rc;

    va_start (args, text);

    do {
        size += 1000;
        if (buf) free (buf);
        buf = malloc (size);
        i = vsnprintf (buf, size, text, args);
    } while (i == size);

    va_end(args);

    rc = MessageBox (hwnd, buf, title, dwStyle);

    if (buf)
        free (buf);

    return rc;
}
===============================================================================

• 可变参数函数的参数处理: va_start/va_end

===============================================================================
        #include <stdarg.h>

        void va_start( va_list ap, last);
        type va_arg( va_list ap, type);
        void va_end( va_list ap);
-------------------------------------------------------------------------------
SAMPLE:        varg.c

        #include <stdio.h>
        #include <stdarg.h>

        void foo(char *fmt, ...)
        {
           va_list ap;
           int d;
           char c, *s;

           va_start(ap, fmt);
           while (*fmt)
                switch(*fmt++) {
                case 's':           /* string */
                     s = va_arg(ap, char *);
                     printf("string %s\n", s);
                     break;
                case 'd':           /* int */
                     d = va_arg(ap, int);
                     printf("int %d\n", d);
                     break;
                case 'c':           /* char */
                     c = va_arg(ap, char);
                     printf("char %c\n", c);
                     break;
                }
           va_end(ap);
        }

        int main (void)
        {
            foo ("ssdcds", "Hello", "world.", 50, 'a', 2000, "END");
            return 0;
        }
===============================================================================