# C 语言标准库函数 gets

/*********************************************
 * @brief 从标准输入读取一个字符串
 * @param[out] str 保存读取到的字符串
 * @return 是（非负）否（EOF）成功
 ********************************************/
char* gets(char* str);

!subtitle:说明

从标准输入流 stdin 中读取一个字符串，以换行符（\n）或文件末尾（EOF）作为结束。

读入数组的最后一个字符后会自动添加字符串结束标志（'\0'），输入的换行符（\n）会被丢弃。

!subtitle:参数

• str - 保存读取到的字符串

!subtitle:返回值

• 返回参数 str 本身

• 失败时返回 NULL

# 示例

#include <stdio.h>

int main(void)
{
    char text[64];
    gets(text);

    return 0;
}

# 推荐阅读

• C 语言标准库函数 getchar

• C 语言标准库函数 putchar

• C 语言标准库函数 puts

• gets - cppreference

• gets - POSIX

# 参考标准

• 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