gets, gets_s
来自 cppreference.cn
| 定义于头文件 <stdio.h> |
||
| char* gets( char* str ); |
(1) | (C11 中移除) |
| char* gets_s( char* str, rsize_t n ); |
(2) | (C11 起) |
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 | - | 要从 stdin 写入字符的字符数组 |
| n | - | 可以写入 str 所指向的数组的最大字符数 |
[编辑] 返回值
成功时返回 str，失败时返回空指针。
如果失败是由文件结束条件引起的，还会设置 stdin 上的 eof 指示器（参阅 feof()）。如果失败是由其他错误引起的，则设置 stdin 上的 error 指示器（参阅 ferror()）。
[编辑] 注意
gets() 函数不执行边界检查，因此该函数极易受到缓冲区溢出攻击。它无法安全使用（除非程序运行在限制 stdin 上可以出现内容的环境中）。因此，该函数在 C99 标准的第三个勘误中被废弃，并在 C11 标准中完全移除。fgets() 和 gets_s() 是推荐的替代品。
警告：切勿使用 gets().
[编辑] 参考
- C23 标准 (ISO/IEC 9899:2024)
- K.3.5.4.1 gets_s 函数 (p: TBD)
- C17 标准 (ISO/IEC 9899:2018)
- K.3.5.4.1 gets_s 函数 (p: TBD)
- C11 标准 (ISO/IEC 9899:2011)
- K.3.5.4.1 gets_s 函数 (p: 602-603)
- C99 标准 (ISO/IEC 9899:1999)
- 7.19.7.7 gets 函数 (p: 298)
- C89/C90 标准 (ISO/IEC 9899:1990)
- 4.9.7.7 gets 函数
[编辑] 另请参阅
| (C11)(C11)(C11) |
从 stdin、文件流或缓冲区读取格式化输入 (函数) |
| 从文件流获取字符字符串 (函数) | |
| 将字符字符串写入文件流 (函数) | |
| (动态内存 TR) |
从流中读取到自动调整大小的缓冲区，直到分隔符/行尾 (函数) |
| C++ 文档 用于 gets
| |
