notmuch/util/hex-escape.h
Jani Nikula f316f7ef6a cli: remove enum names from typedefs
There are some enum typedefs with the enum name:

    typedef enum _name_t { ... } name_t;

We don't need or use the enum names _name_t for anything, and not all
of the enum typedefs have them. We have the typedefs specifically to
use the typedef name.

Use the anonymous enum in the typedefs:

    typedef enum { ... } name_t;
2021-10-23 08:39:16 -03:00

50 lines
1.1 KiB
C

#ifndef _HEX_ESCAPE_H
#define _HEX_ESCAPE_H
#ifdef __cplusplus
extern "C" {
#endif
typedef enum {
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