labwc/include/common/grab-file.h

/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * Read file into memory
 *
 * Copyright Johan Malm 2020
 */

#ifndef LABWC_GRAB_FILE_H
#define LABWC_GRAB_FILE_H

#include "common/buf.h"

/**
 * grab_file - read file into memory buffer
 * @filename: file to read
 * Free returned buffer with buf_reset().
 */
struct buf grab_file(const char *filename);

#endif /* LABWC_GRAB_FILE_H */
Add SPDX identifiers 2021-11-13 21:56:53 +00:00			`/* SPDX-License-Identifier: GPL-2.0-only */`
s/xbm_read_file()/grab_file/() 2020-08-06 15:01:08 +01:00			`/*`
			`* Read file into memory`
			`*`
			`* Copyright Johan Malm 2020`
			`*/`

includes: identifier consistency in include guards Made all header files to have LABWC_ prefix in include guard identifers. Converted from __LABWC_ in 35 include/ files. Converted from __LAB_ in 5 include/ files. Added LABWC prefix to 3 include/ files. Added include guards to 3 include/ files. The double underscores were removed since according to C standard those "are always reserved for any use". 2023-05-13 16:10:33 +03:00			`#ifndef LABWC_GRAB_FILE_H`
			`#define LABWC_GRAB_FILE_H`
s/xbm_read_file()/grab_file/() 2020-08-06 15:01:08 +01:00
common: remove buf_init(), add BUF_INIT and buf_move() Add a BUF_INIT macro, which makes it easier to initialize a struct buf to an empty string (without a heap allocation). Add buf_move() to move the contents of one struct buf to another (the source is reset to BUF_INIT, analogous to C++ move-assignment). Use buf_reset() instead of directly calling `free(s->buf)` since the internal buf may not always be allocated by malloc() now. 2024-04-14 14:20:57 -04:00			`#include "common/buf.h"`

s/xbm_read_file()/grab_file/() 2020-08-06 15:01:08 +01:00			`/**`
			`* grab_file - read file into memory buffer`
			`* @filename: file to read`
common: remove buf_init(), add BUF_INIT and buf_move() Add a BUF_INIT macro, which makes it easier to initialize a struct buf to an empty string (without a heap allocation). Add buf_move() to move the contents of one struct buf to another (the source is reset to BUF_INIT, analogous to C++ move-assignment). Use buf_reset() instead of directly calling `free(s->buf)` since the internal buf may not always be allocated by malloc() now. 2024-04-14 14:20:57 -04:00			`* Free returned buffer with buf_reset().`
s/xbm_read_file()/grab_file/() 2020-08-06 15:01:08 +01:00			`*/`
common: remove buf_init(), add BUF_INIT and buf_move() Add a BUF_INIT macro, which makes it easier to initialize a struct buf to an empty string (without a heap allocation). Add buf_move() to move the contents of one struct buf to another (the source is reset to BUF_INIT, analogous to C++ move-assignment). Use buf_reset() instead of directly calling `free(s->buf)` since the internal buf may not always be allocated by malloc() now. 2024-04-14 14:20:57 -04:00			`struct buf grab_file(const char *filename);`
s/xbm_read_file()/grab_file/() 2020-08-06 15:01:08 +01:00
includes: identifier consistency in include guards Made all header files to have LABWC_ prefix in include guard identifers. Converted from __LABWC_ in 35 include/ files. Converted from __LAB_ in 5 include/ files. Added LABWC prefix to 3 include/ files. Added include guards to 3 include/ files. The double underscores were removed since according to C standard those "are always reserved for any use". 2023-05-13 16:10:33 +03:00			`#endif /* LABWC_GRAB_FILE_H */`