setvbuf

控制流缓冲和缓冲区大小。

语法

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

参数

stream
指向 FILE 结构的指针。

buffer
用户分配的缓冲区。

mode
缓冲模式。

size
缓冲区大小（以字节为单位）。 允许的范围：2 <= size<= INT_MAX (2147483647)。 在内部将为 size 提供的值向下舍入为最接近的 2 的倍数。

返回值

如果成功，则返回 0。

如果 stream 为 NULL，或如果 mode 或 size 不在有效更改之内，则调用无效参数处理程序，如参数验证中所述。 如果允许执行继续，则此函数将返回 -1 并将 errno 设置为 EINVAL。

有关这些错误代码和其他错误代码的信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

注解

setvbuf 函数允许程序控制 stream 的缓冲和缓冲区大小。 stream 必须引用自该文件打开后尚未进行 I/O 操作的打开文件。 将 buffer 所指向的数组用作缓冲区，除非 buffer 是 NULL，在这种情况下，setvbuf 使用长度为 size/2 * 2 字节的自动分配的缓冲区。

此模式必须是 _IOFBF、_IOLBF 或 _IONBF。 如果 mode 是 _IOFBF 或 _IOLBF，则将 size 用作缓冲区的大小。 如果 mode 是 _IONBF，则该流取消缓冲并同时忽略 size 和 buffer。 mode 的值及其含义是：

mode 值	含义
_IOFBF	完全缓冲；也就是说，将 buffer 用作缓冲区并将 size 用作缓冲区的大小。 如果 buffer 是 NULL，则此模式使用长度为 size 字节的自动分配缓冲区。
_IOLBF	对于某些系统，此模式会提供行缓冲。 但是，对于 Win32，该行为与 _IOFBF 完全缓冲一样。
_IONBF	将不会使用缓冲区，无论 buffer 或 size。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

要求

例程	必需的标头
setvbuf	<stdio.h>

有关兼容性的详细信息，请参阅 兼容性。

库

C 运行时库的所有版本。

示例

// crt_setvbuf.c
// This program opens two streams: stream1
// and stream2. It then uses setvbuf to give stream1 a
// user-defined buffer of 1024 bytes and stream2 no buffer.
//

#include <stdio.h>

int main( void )
{
   char buf[1024];
   FILE *stream1, *stream2;

   if( fopen_s( &stream1, "data1", "a" ) == 0 &&
       fopen_s( &stream2, "data2", "w" ) == 0 )
   {
      if( setvbuf( stream1, buf, _IOFBF, sizeof( buf ) ) != 0 )
         printf( "Incorrect type or size of buffer for stream1\n" );
      else
         printf( "'stream1' now has a buffer of 1024 bytes\n" );
      if( setvbuf( stream2, NULL, _IONBF, 0 ) != 0 )
         printf( "Incorrect type or size of buffer for stream2\n" );
      else
         printf( "'stream2' now has no buffer\n" );
      _fcloseall();
   }
}

'stream1' now has a buffer of 1024 bytes
'stream2' now has no buffer

另请参阅

流 I/O
fclose、_fcloseall
fflush
fopen、_wfopen
setbuf