fgets

函数原型

char *fgets(char *str, int n, FILE *stream);

参数

str-- 这是指向一个字符数组的指针,该数组存储了要读取的字符串。

n-- 这是要读取的最大字符数(包括最后的空字符)。通常是使用以 str 传递的数组长度。

stream-- 这是指向 FILE 对象的指针,该 FILE 对象标识了要从中读取字符的流。

功能

从指定的流 stream 读取一行,并把它存储在str所指向的字符串内。当读取(n-1)个字符时,或者读取到换行符时,或者到达文件末尾时,它会停止,具体视情况而定。 [2]

应用说明

如果文件中的该行,不足n-1个字符,则读完该行就结束。如若该行(包括最后一个换行符)的字符数超过n-1,则fgets只返回一个不完整的行,但是,缓冲区总是以NULL字符结尾,对fgets的下一次调用会继续读该行。函数成功将返回stream,失败或读到文件结尾返回NULL。因此不能直接通过fgets的返回值来判断函数是否是出错而终止的,应该借助feof函数或者ferror函数来判断。

返回值

如果成功,该函数返回相同的 str 参数。如果到达文件末尾或者没有读取到任何字符,str 的内容保持不变,并返回一个空指针。如果发生错误,返回一个空指针。

在读字符时遇到end-of-file,则eof指示器被设置,如果还没读入任何字符就遇到这种情况,则stream保持原来的内容,返回NULL;

如果发生读入错误,error指示器被设置,返回NULL,stream的值可能被改变

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

  • 一、Python简介和环境搭建以及pip的安装 4课时实验课主要内容 【Python简介】: Python 是一个...
    _小老虎_阅读 6,339评论 0 10
  • C/C++输入输出流总结 前两天写C++实习作业,突然发现I/O是那么的陌生,打了好长时间的文件都没有打开,今天终...
    LuckTime阅读 1,808评论 0 6
  • [转]C/C++ 文件读写操作总结 在编程的过程中,文件的操作是一个经常用到的问题,在C++Builder中,可以...
    天之道天知道阅读 5,294评论 0 7
  • 最最喜欢阳光铺满整个房间的感觉,一切都是如此美好。 喜欢卧室这个小小角落,窝在窗台上,拿一本闲书悠悠的看着。或是一...
    春香亲子成长阅读 1,423评论 5 42
  • 人无好坏。 以前我看人总是喜欢因为某一缺点,就会全盘否认别人。总是喜欢盯着别人的缺点,甚至是无限制的放大对方的缺点...
    周周的笔记阅读 201评论 0 3

友情链接更多精彩内容