X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=src%2Futil.h;h=28f9655ff6efaf87bece7cc3bf3337d8334ba7e9;hp=2dc794370ad3c58e2a00915cf07bcb04d75099ad;hb=de12c346dc64404821d52d545e2e1b3d44230f2a;hpb=ad37dd86e75416ffc47c97b35f097012be5eeaa2 diff --git a/src/util.h b/src/util.h index 2dc79437..28f9655f 100644 --- a/src/util.h +++ b/src/util.h @@ -49,6 +49,62 @@ typedef uint32_t u32; typedef uint64_t u64; #endif +/* A pointer to 'mbchar' indicates a string of "multibyte characters" provided + * in the default encoding of the user's locale, which may be "UTF-8", + * "ISO-8859-1", "C", or any other ASCII-compatible encoding. + * "ASCII-compatible" here means any encoding where all ASCII-representable + * characters have the same representation as in ASCII itself, and any non-ASCII + * character is represented as a sequence of one or more bytes not already used + * by any ASCII character. */ +typedef char mbchar; + +/* A pointer to 'utf8char' indicates a UTF-8 encoded string */ +typedef char utf8char; + +/* Note: in some places in the code, strings of plain old 'char' are still used. + * This means that the string is being operated on in an ASCII-compatible way, + * and may be either a multibyte or UTF-8 string. */ + +/* A pointer to 'utf16lechar' indicates a UTF-16LE encoded string */ +typedef u16 utf16lechar; + +extern size_t +utf16le_strlen(const utf16lechar *s); + +/* encoding.c */ +extern void +iconv_global_cleanup(); + +extern bool wimlib_mbs_is_utf8; + +#define DECLARE_CHAR_CONVERSION_FUNCTIONS(varname1, varname2, \ + chartype1, chartype2) \ + \ +extern int \ +varname1##_to_##varname2##_nbytes(const chartype1 *in, size_t in_nbytes,\ + size_t *out_nbytes_ret); \ + \ +extern int \ +varname1##_to_##varname2##_buf(const chartype1 *in, size_t in_nbytes, \ + chartype2 *out); \ + \ +extern int \ +varname1##_to_##varname2(const chartype1 *in, size_t in_nbytes, \ + chartype2 **out_ret, \ + size_t *out_nbytes_ret); \ + +/* multi-byte string to UTF16-LE string */ +DECLARE_CHAR_CONVERSION_FUNCTIONS(mbs, utf16le, mbchar, utf16lechar); + +/* UTF16-LE string to multi-byte string */ +DECLARE_CHAR_CONVERSION_FUNCTIONS(utf16le, mbs, utf16lechar, mbchar); + +/* UTF-8 string to multi-byte string */ +DECLARE_CHAR_CONVERSION_FUNCTIONS(utf8, mbs, utf8char, mbchar); + +extern bool +utf8_str_contains_nonascii_chars(const utf8char *utf8_str); + #ifndef min #define min(a, b) ({ typeof(a) __a = (a); typeof(b) __b = (b); \ (__a < __b) ? __a : __b; }) @@ -95,58 +151,56 @@ dummy_printf(const char *format, ...) } #ifdef ENABLE_ERROR_MESSAGES -extern void wimlib_error(const char *format, ...) - FORMAT(printf, 1, 2) COLD; -extern void wimlib_error_with_errno(const char *format, ...) - FORMAT(printf, 1, 2) COLD; -extern void wimlib_warning(const char *format, ...) - FORMAT(printf, 1, 2) COLD; -extern void wimlib_warning_with_errno(const char *format, ...) - FORMAT(printf, 1, 2) COLD; -# define ERROR wimlib_error -# define ERROR_WITH_ERRNO wimlib_error_with_errno -# define WARNING wimlib_warning -# define WARNING_WITH_ERRNO wimlib_warning -#else -# define ERROR(format, ...) dummy_printf -# define ERROR_WITH_ERRNO(format, ...) dummy_printf -# define WARNING(format, ...) dummy_printf -# define WARNING_WITH_ERRNO(format, ...) dummy_printf -#endif /* ENABLE_ERROR_MESSAGES */ +extern void +wimlib_error(const char *format, ...) FORMAT(printf, 1, 2) COLD; + +extern void +wimlib_error_with_errno(const char *format, ...) FORMAT(printf, 1, 2) COLD; + +extern void +wimlib_warning(const char *format, ...) FORMAT(printf, 1, 2) COLD; + +extern void +wimlib_warning_with_errno(const char *format, ...) FORMAT(printf, 1, 2) COLD; +# define ERROR wimlib_error +# define ERROR_WITH_ERRNO wimlib_error_with_errno +# define WARNING wimlib_warning +# define WARNING_WITH_ERRNO wimlib_warning +#else /* ENABLE_ERROR_MESSAGES */ +# define ERROR(format, ...) dummy_printf(format, ## __VA_ARGS__) +# define ERROR_WITH_ERRNO(format, ...) dummy_printf(format, ## __VA_ARGS__) +# define WARNING(format, ...) dummy_printf(format, ## __VA_ARGS__) +# define WARNING_WITH_ERRNO(format, ...) dummy_printf(format, ## __VA_ARGS__) +#endif /* !ENABLE_ERROR_MESSAGES */ #if defined(ENABLE_DEBUG) || defined(ENABLE_MORE_DEBUG) -# include -# define DEBUG(format, ...) \ - ({ \ - int __errno_save = errno; \ - fprintf(stdout, "[%s %d] %s(): " format, \ - __FILE__, __LINE__, __func__, ## __VA_ARGS__); \ - putchar('\n'); \ - fflush(stdout); \ - errno = __errno_save; \ - }) +extern void +wimlib_debug(const char *file, int line, const char *func, + const char *format, ...); +# define DEBUG(format, ...) \ + wimlib_debug(__FILE__, __LINE__, __func__, format, ## __VA_ARGS__); #else -# define DEBUG(format, ...) dummy_printf(format, ## __VA_ARGS__) +# define DEBUG(format, ...) dummy_printf(format, ## __VA_ARGS__) #endif /* ENABLE_DEBUG || ENABLE_MORE_DEBUG */ #ifdef ENABLE_MORE_DEBUG -# define DEBUG2(format, ...) DEBUG(format, ## __VA_ARGS__) +# define DEBUG2(format, ...) DEBUG(format, ## __VA_ARGS__) #else -# define DEBUG2(format, ...) dummy_printf(format, ## __VA_ARGS__) +# define DEBUG2(format, ...) dummy_printf(format, ## __VA_ARGS__) #endif /* ENABLE_DEBUG */ #ifdef ENABLE_ASSERTIONS #include -# define wimlib_assert(expr) assert(expr) +# define wimlib_assert(expr) assert(expr) #else -# define wimlib_assert(expr) +# define wimlib_assert(expr) #endif #ifdef ENABLE_MORE_ASSERTIONS -#define wimlib_assert2(expr) wimlib_assert(expr) +# define wimlib_assert2(expr) wimlib_assert(expr) #else -#define wimlib_assert2(expr) +# define wimlib_assert2(expr) #endif #define BUILD_BUG_ON(condition) ((void)sizeof(char[1 - 2*!!(condition)])) @@ -157,67 +211,56 @@ extern void (*wimlib_free_func)(void *); extern void *(*wimlib_realloc_func)(void *, size_t); extern void *wimlib_calloc(size_t nmemb, size_t size); extern char *wimlib_strdup(const char *str); -# define MALLOC wimlib_malloc_func -# define FREE wimlib_free_func -# define REALLOC wimlib_realloc_func -# define CALLOC wimlib_calloc -# define STRDUP wimlib_strdup -#else -# include -# include -# define MALLOC malloc -# define FREE free -# define REALLOC realloc -# define CALLOC calloc -# define STRDUP strdup -#endif /* ENABLE_CUSTOM_MEMORY_ALLOCATOR */ +# define MALLOC wimlib_malloc_func +# define FREE wimlib_free_func +# define REALLOC wimlib_realloc_func +# define CALLOC wimlib_calloc +# define STRDUP wimlib_strdup +#else /* ENABLE_CUSTOM_MEMORY_ALLOCATOR */ +# include +# include +# define MALLOC malloc +# define FREE free +# define REALLOC realloc +# define CALLOC calloc +# define STRDUP strdup +#endif /* !ENABLE_CUSTOM_MEMORY_ALLOCATOR */ -/* encoding.c */ - -#ifdef WITH_NTFS_3G -static inline int iconv_global_init() -{ - return 0; -} - -static inline void iconv_global_cleanup() { } -#else -extern int iconv_global_init(); -extern void iconv_global_cleanup(); -#endif - -extern int utf16_to_utf8(const char *utf16_str, size_t utf16_nbytes, - char **utf8_str_ret, size_t *utf8_nbytes_ret); - -extern int utf8_to_utf16(const char *utf8_str, size_t utf8_nbytes, - char **utf16_str_ret, size_t *utf16_nbytes_ret); - /* util.c */ -extern void randomize_byte_array(u8 *p, size_t n); +extern void +randomize_byte_array(u8 *p, size_t n); -extern void randomize_char_array_with_alnum(char p[], size_t n); +extern void +randomize_char_array_with_alnum(char p[], size_t n); -extern const char *path_next_part(const char *path, - size_t *first_part_len_ret); +extern const char * +path_next_part(const char *path, size_t *first_part_len_ret); -extern const char *path_basename(const char *path); +extern const char * +path_basename(const char *path); -extern const char *path_stream_name(const char *path); +extern const char * +path_stream_name(const char *path); -extern void to_parent_name(char buf[], size_t len); +extern void +to_parent_name(char buf[], size_t len); -extern void print_string(const void *string, size_t len); +extern void +print_string(const void *string, size_t len); -extern int get_num_path_components(const char *path); +extern int +get_num_path_components(const char *path); -static inline void print_byte_field(const u8 field[], size_t len) +static inline void +print_byte_field(const u8 field[], size_t len) { while (len--) printf("%02hhx", *field++); } -static inline u32 bsr32(u32 n) +static inline u32 +bsr32(u32 n) { #if defined(__x86__) || defined(__x86_64__) asm("bsrl %0, %0;" @@ -232,4 +275,14 @@ static inline u32 bsr32(u32 n) #endif } +extern int +wimlib_fprintf(FILE *fp, const char *format, ...) + //FORMAT(printf, 2, 3) + ; + +extern int +wimlib_printf(const char *format, ...) + //FORMAT(printf, 1, 2) + ; + #endif /* _WIMLIB_UTIL_H */