当前位置：首页 > news >正文

fseeko函数详解及使用示例

news 2026/6/6 4:53:41

fseeko()是 C 语言标准库中用于设置文件流的读写位置（文件偏移量）的函数，它是fseek()的增强版本。以下是详细解析：

函数原型

#include <stdio.h> int fseeko(FILE *stream, off_t offset, int whence);

参数说明

1.stream

指向FILE结构的指针，表示要操作的文件流

2.offset

偏移量，类型为off_t
关键优势：off_t通常是 64 位有符号整数，可以处理超过 2GB 的大文件
对比fseek()：fseek()使用long类型（通常 32 位），最大只能处理 2GB 文件

3.whence（基准位置）

SEEK_SET：从文件开头计算偏移
SEEK_CUR：从当前位置计算偏移
SEEK_END：从文件末尾计算偏移

返回值

成功：返回 0
失败：返回 -1，并设置errno

与 fseek() 的主要区别

特性	fseek()	fseeko()
偏移量类型	`long`（通常 32位）	`off_t`（通常 64位）
最大文件	2GB（在32位系统）	通常 2^63-1 字节
标准	C89/C99 标准	POSIX 标准

使用示例

示例1：基本用法

#include <stdio.h> #include <stdlib.h> int main() { FILE *fp = fopen("largefile.dat", "rb"); if (fp == NULL) { perror("fopen"); return 1; } // 跳转到文件末尾前100字节处 if (fseeko(fp, -100, SEEK_END) == -1) { perror("fseeko"); fclose(fp); return 1; } // 获取当前位置 off_t pos = ftello(fp); printf("Current position: %ld\n", (long)pos); fclose(fp); return 0; }

示例2：处理大文件

#include <stdio.h> #include <stdlib.h> #include <stdint.h> int main() { FILE *fp = fopen("huge_file.bin", "rb"); if (fp == NULL) { perror("fopen"); return 1; } // 跳转到 5GB 位置（fseek() 无法处理） off_t offset = 5LL * 1024 * 1024 * 1024; // 5GB if (fseeko(fp, offset, SEEK_SET) == -1) { perror("fseeko 5GB"); fclose(fp); return 1; } printf("Successfully seeked to 5GB\n"); fclose(fp); return 0; }

配套函数：ftello()

获取当前文件位置，返回off_t类型

off_t ftello(FILE *stream);

编译注意事项

Linux/Unix 系统

# 确保使用大文件支持 gcc -D_FILE_OFFSET_BITS=64 program.c -o program

跨平台处理

#ifdef _WIN32 #include <io.h> #define fseeko _fseeki64 #define ftello _ftelli64 #endif

常见应用场景

大文件处理
- 处理超过 2GB 的日志文件
- 操作大型数据库文件
随机访问
- 数据库索引查找
- 多媒体文件跳转（视频/音频）
文件分割/合并
- 大文件分块处理

错误处理

#include <stdio.h> #include <stdlib.h> #include <errno.h> #include <string.h> int safe_seek(FILE *fp, off_t offset, int whence) { if (fseeko(fp, offset, whence) == -1) { fprintf(stderr, "fseeko failed: %s\n", strerror(errno)); return -1; } return 0; }

注意事项

二进制与文本模式
- 在 Windows 上，文本模式 ("r","w") 和二进制模式 ("rb","wb") 行为不同
- 对于精确的偏移定位，建议使用二进制模式
缓冲影响
- 操作前可能需要调用fflush()
- 读/写操作后调用fseeko()更安全
非定位流
- 终端、管道等不支持定位操作
- 调用前应检查fseek()/fseeko()是否可用

实际案例：文件分块读取

#include <stdio.h> #include <stdlib.h> #include <stdint.h> #define CHUNK_SIZE (1024LL * 1024 * 1024) // 1GB void process_large_file(const char *filename) { FILE *fp = fopen(filename, "rb"); if (!fp) { perror("fopen"); return; } // 获取文件大小 fseeko(fp, 0, SEEK_END); off_t file_size = ftello(fp); fseeko(fp, 0, SEEK_SET); printf("File size: %ld bytes\n", (long)file_size); // 分块处理 off_t processed = 0; while (processed < file_size) { off_t chunk = (file_size - processed > CHUNK_SIZE) ? CHUNK_SIZE : file_size - processed; // 处理当前块... printf("Processing chunk at offset %ld, size %ld\n", (long)processed, (long)chunk); // 跳到下一块 processed += chunk; if (fseeko(fp, processed, SEEK_SET) == -1) { perror("fseeko"); break; } } fclose(fp); }