tmpfile, tmpfile_s
来自 cppreference.cn
定义于头文件 <stdio.h> |
||
FILE* tmpfile( void ); |
(1) | |
errno_t tmpfile_s( FILE* restrict* restrict streamptr ); |
(2) | (C11 起) |
1) 创建并打开一个临时文件。文件以更新的二进制模式打开(如同使用 fopen 加上 "wb+" 模式)。文件的文件名保证在文件系统内是唯一的。在程序运行期间,至少可以打开 TMP_MAX 个文件(此限制可能与 tmpnam 共享,并可能受 FOPEN_MAX 进一步限制)。
2) 与 (1) 相同,但至少可以打开 TMP_MAX_S 个文件(此限制可能与 tmpnam_s 共享),并且如果 streamptr 是空指针,则会调用当前安装的约束处理函数。
- 与所有带边界检查的函数一样,只有在实现定义了 __STDC_LIB_EXT1__ 并且用户在包含 <stdio.h> 之前将 __STDC_WANT_LIB_EXT1__ 定义为整数常量 1 时,才保证 tmpfile_s 可用。
此函数创建的临时文件在程序正常退出时关闭并删除。异常终止时是否删除是实现定义的。
目录 |
[编辑] 参数
1) (无)
2) 指向将被此函数调用更新的指针的指针。
[编辑] 返回值
1) 指向与文件关联的文件流的指针,如果发生错误则为空指针。
2) 如果文件创建并成功打开则返回零,如果文件未创建或未打开,或者 streamptr 为空指针则返回非零。此外,成功时,指向关联文件流的指针存储在 *streamptr 中;错误时,空指针值存储在 *streamptr 中。
[编辑] 注意
在某些实现中(例如较旧的 Linux),此函数实际上创建、打开并立即从文件系统中删除文件:只要程序持有对已删除文件的打开文件描述符,该文件就存在,但由于它已被删除,其名称不会出现在任何目录中,因此没有其他进程可以打开它。一旦文件描述符关闭,或程序终止(正常或异常),文件占用的空间就会被文件系统回收。较新的 Linux(自 3.11 或更高版本,取决于文件系统)通过 open()
系统调用中的特殊标志一步创建此类不可见的临时文件。
在某些实现中(例如 Windows),函数可能在系统目录中创建临时文件,因此需要提升权限。
[编辑] 示例
运行此代码
#define _POSIX_C_SOURCE 200112L #include <stdio.h> #include <unistd.h> int main(void) { printf("TMP_MAX = %d, FOPEN_MAX = %d\n", TMP_MAX, FOPEN_MAX); FILE* tmpf = tmpfile(); fputs("Hello, world", tmpf); rewind(tmpf); char buf[6]; fgets(buf, sizeof buf, tmpf); printf("got back from the file: '%s'\n", buf); // Linux-specific method to display the tmpfile name char fname[FILENAME_MAX], link[FILENAME_MAX] = {0}; sprintf(fname, "/proc/self/fd/%d", fileno(tmpf)); if (readlink(fname, link, sizeof link - 1) > 0) printf("File name: %s\n", link); }
可能的输出
TMP_MAX = 238328, FOPEN_MAX = 16 got back from the file: 'Hello' File name: /tmp/tmpfjptPe5 (deleted)
[编辑] 参考
- C23 标准 (ISO/IEC 9899:2024)
- 7.21.4.3 tmpfile 函数 (p: TBD)
- K.3.5.1.1 tmpfile_s 函数 (p: TBD)
- C17 标准 (ISO/IEC 9899:2018)
- 7.21.4.3 tmpfile 函数 (p: 222)
- K.3.5.1.1 tmpfile_s 函数 (p: 427)
- C11 标准 (ISO/IEC 9899:2011)
- 7.21.4.3 tmpfile 函数 (p: 303)
- K.3.5.1.1 tmpfile_s 函数 (p: 586-587)
- C99 标准 (ISO/IEC 9899:1999)
- 7.19.4.3 tmpfile 函数 (p: 269)
- C89/C90 标准 (ISO/IEC 9899:1990)
- 4.9.4.3 tmpfile 函数
[编辑] 另见
(C11) |
返回一个唯一的文件名 (函数) |
C++ 文档 for tmpfile
|