gets, gets_s

来自cppreference.com
< c‎ | io
 
 
文件输入/输出
函数
文件访问
直接输入/输出
无格式输入/输出
getsgets_s
(C11 前)
(C11 起)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
格式输入
格式输出
文件定位
错误处理
文件操作
 
定义于头文件 <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、文件流或缓冲区读取格式化输入
(函数) [编辑]
从文件流获取一个字符串
(函数) [编辑]
将一个字符串写入文件流
(函数) [编辑]
从流读入至动态改变大小的缓冲区,直到分隔符/行尾
(函数) [编辑]
getsC++ 文档