1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
/* Licensed under LGPLv2+ - see LICENSE file for details */
#ifndef CCAN_GRAB_FILE_H
#define CCAN_GRAB_FILE_H
#include <stdio.h> // For size_t
/**
* grab_fd - read all of a file descriptor into memory
* @ctx: the context to tallocate from (often NULL)
* @fd: the file descriptor to read from
* @size: the (optional) size of the file
*
* This function reads from the given file descriptor until no more
* input is available. The content is talloced off @ctx, and the size
* of the file places in @size if it's non-NULL. For convenience, the
* byte after the end of the content will always be NUL.
*
* Example:
* // Return the first line.
* static char *read_stdin_firstline(void)
* {
* char *all, *nl;
*
* all = grab_fd(NULL, 0, NULL);
* if (!all)
* return NULL;
* nl = strchr(all, '\n');
* if (nl)
* *nl = '\0';
* return all;
* }
*/
void *grab_fd(const void *ctx, int fd, size_t *size);
/**
* grab_file - read all of a file (or stdin) into memory
* @ctx: the context to tallocate from (often NULL)
* @filename: the file to read (NULL for stdin)
* @size: the (optional) size of the file
*
* This function reads from the given file until no more input is
* available. The content is talloced off @ctx, and the size of the
* file places in @size if it's non-NULL. For convenience, the byte
* after the end of the content will always be NUL.
*
* Example:
* static char *read_file_firstline(const char *filename)
* {
* char *nl, *all;
*
* all = grab_file(NULL, filename, NULL);
* if (!all)
* return NULL;
* nl = strchr(all, '\n');
* if (nl)
* *nl = '\0';
* return all;
* }
*/
void *grab_file(const void *ctx, const char *filename, size_t *size);
#endif /* CCAN_GRAB_FILE_H */
|
