gets, gets_s

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

文件输入/输出

类型与对象
FILE
fpos_t
stdinstdoutstderr
函数
文件访问 fopenfopen_s (C11) freopenfreopen_s (C11) fwide (C95) setbuf setvbuf fclose fflush 直接输入/输出 fread fwrite 无格式输入/输出 fgetc fgets fputc fputs getchar getsgets_s (C11 前)(C11) putchar puts ungetc fgetwcgetwc (C95)(C95) fgetws (C95) fputwcputwc (C95)(C95) fputws (C95) getwchar (C95) putwchar (C95) ungetwc (C95) 有格式输入 scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11) wscanffwscanfswscanfwscanf_sfwscanf_sswscanf_s (C95)(C95)(C95)(C11)(C11)(C11) vscanfvfscanfvsscanfvscanf_svfscanf_svsscanf_s (C99)(C99)(C99)(C11)(C11)(C11) vwscanfvfwscanfvswscanfvwscanf_svfwscanf_svswscanf_s (C99)(C99)(C99)(C11)(C11)(C11)	有格式输出 printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11) wprintffwprintfswprintfwprintf_sfwprintf_sswprintf_ssnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11) vprintfvfprintfvsprintfvsnprintfvprintf_svfprintf_svsprintf_svsnprintf_s (C99)(C11)(C11)(C11)(C11) vwprintfvfwprintfvswprintfvwprintf_svfwprintf_svswprintf_svsnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11) 文件寻位 ftell fgetpos fseek fsetpos rewind 错误处理 clearerr feof ferror perror 文件上的操作 remove rename tmpfiletmpfile_s (C11) tmpnamtmpnam_s (C11)

 

定义于头文件 <stdio.h>
char *gets( char *str );	(1)	(C11 中移除)
char *gets_s( char *str, rsize_t n );	(2)	(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 ，失败时为空指针。

若文件尾条件导致了失败，则附加设置 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

参阅

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