C 参考手册

位置:首页 > C 参考手册 >文件输入/输出 > gets, gets_s

定义于头文件 <stdio.h>
char *gets( char *str );
(C11 中移除)
char *gets_s( char *str, rsize_t n );
(C11 起)
(可选)
1)stdin 读入 str 所指向的字符数组,直到发现换行符或出现文件尾。在读入数组的最后一个字符后立即写入空字符。换行符被舍弃,但不会存储于缓冲区中。
2)stdin 读取字符直到发现换行符或出现文件尾。至多写入 n-1 个字符到 str 所指向的数组,并始终写入空终止字符(除非 str 是空指针)。若发现换行符,则忽略它并且不将它计入写入缓冲区的字符数。
在运行时检测下列错误,并调用当前安装的制约处理函数:
  • n 为零
  • n 大于 RSIZE_MAX
  • str 是空指针
  • 在存储 n-1 个字符到缓冲区后没有遇到换行符或文件尾。
任何情况下,gets_s 首先结束读取并忽略来自 stdin 的字符,直到换行符、文件尾条件,或在调用制约处理前的读取错误。
同所有边界检查函数, gets_s 仅若实现定义了 __STDC_LIB_EXT1__ ,且用户在包含 <stdio.h> 前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。

参数

str - 要被写入的字符串
n - char数组的最大长度

返回值

成功时为 str ,失败时为 NULL

若文件尾条件导致了失败,则附加设置 stdin文件尾指示器(见 feof() )。若其他某些原因导致了失败,则设置 stdin错误指示器(见 ferror() )。

注意

gets() 函数不进行边界检查,从而此函数对缓冲区溢出攻击极度脆弱。无法安全使用它(除非程序运行的环境限定能出现在 stdin 上的内容)。因此,此函数在 C99 的第三次勘误中被弃用,而在 C11 标准发布时被移除。推荐的替代品是 fgets()gets_s()

绝对不要用 gets()

引用

  • C11 standard (ISO/IEC 9899:2011):
  • K.3.5.4.1 The gets_s function (p: 602-603)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.19.7.7 The gets function (p: 298)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.9.7.7 The gets function

参阅

stdin、文件流或缓冲区读取格式化输入
(函数)
从文件流获取一个字符串
(函数)
将一个字符串写入文件流
(函数)
从流读入至动态改变大小的缓冲区,直到分隔符/行尾
(函数)