std::fseek

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵器

打印函数 (C++23)

C 风格 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

C 风格 I/O

类型和对象
FILE fpos_t	stdinstdoutstderr
函数
文件访问 fopen freopen fclose fflush fwide setbuf setvbuf 直接输入/输出 fread fwrite 非格式化输入/输出 fgetcgetc fgets fputcputc fputs getchar gets (直到 C++14) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 格式化输入 scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	格式化输出 printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf 文件定位 ftell fgetpos fseek fsetpos rewind 错误处理 clearerr feof ferror perror 文件操作 remove rename tmpfile tmpnam

 

定义于头文件 <cstdio>
int fseek( std::FILE* stream, long offset, int origin );

设置文件流 stream 的文件位置指示器。

如果 stream 以二进制模式打开，则新位置是从文件开头测量 offset 字节，如果 origin 为 SEEK_SET，则从当前文件位置测量，如果 origin 为 SEEK_CUR，则从文件末尾测量，如果 origin 为 SEEK_END。二进制流不要求支持 SEEK_END，尤其是在输出额外的空字节时。

如果 stream 以文本模式打开，则 offset 唯一支持的值是零（适用于任何 origin）以及之前对与同一文件关联的流调用 std::ftell 返回的值（仅适用于 origin 为 SEEK_SET）。

如果 stream 是宽字符导向的，则文本流和二进制流的限制都适用（允许 std::ftell 的结果与 SEEK_SET 一起使用，允许从 SEEK_SET 和 SEEK_CUR 使用零偏移量，但不允许从 SEEK_END 使用）。

除了更改文件位置指示器之外，`fseek` 还会撤消 std::ungetc 的效果，并清除文件结束状态（如果适用）。

如果发生读写错误，则设置流的错误指示器 (std::ferror)，并且文件位置不受影响。

参数

stream	-	要修改的文件流
offset	-	相对于 origin 移动的字符数
origin	-	offset 添加到的位置。它可以是以下值之一：SEEK_SET、SEEK_CUR、SEEK_END

返回值

成功时为 ​0​，否则为非零值。

注意

在宽流中寻找到非结束位置后，下次调用任何输出函数可能会使文件的其余部分未定义，例如，通过输出不同长度的多字节序列。

POSIX 允许在现有文件末尾之外进行查找。如果在此查找之后执行输出，则从间隙读取的任何数据都将返回零字节。如果文件系统支持，这会创建一个*稀疏文件*。

POSIX 还要求如果存在任何未写入的数据，`fseek` 首先执行 fflush（但移位状态是否恢复是实现定义的）。标准 C++ 文件流保证刷新和不移位：std::basic_filebuf::seekoff。

POSIX 规定，`fseek` 在错误时应返回 -1，并设置 errno 以指示错误。

在 Windows 上，可以使用 `_fseeki64` 处理大于 2 GiB 的文件。

示例

运行此代码

#include <cassert>
#include <cstdio>
#include <cstdint>
#include <fstream>
#include <vector>
 
int main()
{
    std::ofstream("dummy.nfo") << "8 bytes\n"; // create the file
 
    std::FILE* fp = std::fopen("dummy.nfo", "rb");
    assert(fp);
 
    std::fseek(fp, 0, SEEK_END); // seek to end
    const std::size_t filesize = std::ftell(fp);
    std::vector<std::uint8_t> buffer(filesize);
 
    std::fseek(fp, 0, SEEK_SET); // seek to start
    std::fread(buffer.data(), sizeof(std::uint8_t), buffer.size(), fp);
 
    std::fclose(fp);
    std::printf("I've read %zi bytes\n", filesize);
}

可能的输出

I've read 8 bytes

另请参阅

fsetpos	将文件位置指示器移动到文件中特定位置 (函数)
fgetpos	获取文件位置指示器 (函数)
ftell	返回当前文件位置指示器 (函数)
rewind	将文件位置指示器移动到文件开头 (函数)
C 文档 用于 fseek