tmpfile, tmpfile_s
Defined in header <stdio.h>
|
||
FILE *tmpfile(void); |
(1) | |
errno_t tmpfile_s(FILE * restrict * restrict streamptr); |
(2) | (since C11) |
"wb+"
mode). The filename of the file is guaranteed to be unique within the filesystem. At least TMP_MAX files may be opened during the lifetime of a program (this limit may be shared with tmpnam and may be further limited by FOPEN_MAX).streamptr
is a null pointer, the currently installed constraint handler function is called.
- As with all bounds-checked functions,
tmpfile_s
is only guaranteed to be available if __STDC_LIB_EXT1__ is defined by the implementation and if the user defines __STDC_WANT_LIB_EXT1__ to the integer constant 1 before includingstdio.h
.
The temporary file created by this function is closed and deleted when the program exits normally. Whether it's deleted on abnormal termination is implementation-defined.
Parameters
Return value
streamptr
was a null pointer. In addition, pointer to the associated file stream is stored in *streamptr
on success, and a null pointer value is stored in *streamptr
on error.Notes
On some implementations (e.g. Linux), this function actually creates, opens, and immediately deletes the file from the file system: as long as an open file descriptor to a deleted file is held by a program, the file exists, but since it was deleted, its name does not appear in any directory, so that no other process can open it. Once the file descriptor is closed, or once the program terminates (normally or abnormally), the space occupied by the file is reclaimed by the filesystem.
On some implementations (e.g. Windows), elevated privileges are required as the function may create the temporary file in a system directory.
Example
#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); }
Possible output:
TMP_MAX = 238328, FOPEN_MAX = 16 got back from the file: 'Hello' File name: /tmp/tmpfjptPe5 (deleted)
References
- C17 standard (ISO/IEC 9899:2018):
- 7.21.4.3 The tmpfile function (p: 222)
- K.3.5.1.1 The tmpfile_s function (p: 427)
- C11 standard (ISO/IEC 9899:2011):
- 7.21.4.3 The tmpfile function (p: 303)
- K.3.5.1.1 The tmpfile_s function (p: 586-587)
- C99 standard (ISO/IEC 9899:1999):
- 7.19.4.3 The tmpfile function (p: 269)
- C89/C90 standard (ISO/IEC 9899:1990):
- 4.9.4.3 The tmpfile function
See also
(C11) |
returns a unique filename (function) |