mirror of
https://git.notmuchmail.org/git/notmuch
synced 2024-12-01 07:04:10 +01:00
152b6cac5d
libnotmuch_util.a is supposed to be usable from the library and the CLI, but much the library is compiled as C++. Add in appropriate wrapping to prevent symbol mangling. These wrappers already existed in string-util.h; it seems better to be consistent.
50 lines
1.2 KiB
C
50 lines
1.2 KiB
C
#ifndef _HEX_ESCAPE_H
|
|
#define _HEX_ESCAPE_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef enum hex_status {
|
|
HEX_SUCCESS = 0,
|
|
HEX_SYNTAX_ERROR,
|
|
HEX_OUT_OF_MEMORY
|
|
} hex_status_t;
|
|
|
|
/*
|
|
* The API for hex_encode() and hex_decode() is modelled on that for
|
|
* getline.
|
|
*
|
|
* If 'out' points to a NULL pointer a char array of the appropriate
|
|
* size is allocated using talloc, and out_size is updated.
|
|
*
|
|
* If 'out' points to a non-NULL pointer, it assumed to describe an
|
|
* existing char array, with the size given in *out_size. This array
|
|
* may be resized by talloc_realloc if needed; in this case *out_size
|
|
* will also be updated.
|
|
*
|
|
* Note that it is an error to pass a NULL pointer for any parameter
|
|
* of these routines.
|
|
*/
|
|
|
|
hex_status_t
|
|
hex_encode (void *talloc_ctx, const char *in, char **out,
|
|
size_t *out_size);
|
|
|
|
hex_status_t
|
|
hex_decode (void *talloc_ctx, const char *in, char **out,
|
|
size_t *out_size);
|
|
|
|
/*
|
|
* Non-allocating hex decode to decode 's' in-place. The length of the
|
|
* result is always equal to or shorter than the length of the
|
|
* original.
|
|
*/
|
|
hex_status_t
|
|
hex_decode_inplace (char *s);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|