149 lines
6.0 KiB
C
149 lines
6.0 KiB
C
#ifndef INCLUDED_C_HEX_H
|
||
#define INCLUDED_C_HEX_H
|
||
|
||
#ifndef INCLUDED_C_TYPES_H
|
||
#include <c_Types.h>
|
||
#endif /*INCLUDED_C_TYPES_H*/
|
||
|
||
|
||
/* -------------------------------------------------------------------------------------------------------------- */
|
||
/* */
|
||
|
||
|
||
void c_Hex_DumpBin(const void* data, c_size_t size, int line_size);
|
||
|
||
void c_Hex_Dump(const void *data, c_size_t size);
|
||
|
||
void c_Hex_DumpTo(const void *data, c_size_t size, void (*dump)(const char*, ...));
|
||
|
||
c_err_t c_Hex_HexToBin(const char* hex_str, void* out_bin, c_size_t bin_max_cap, c_size_t* out_size);
|
||
|
||
|
||
/**
|
||
* @brief 工业级二进制安全：二进制字节流正向解析还原为标准十六进制文本字符串
|
||
*
|
||
* @param in_bin 待转化的二进制字节流物理缓冲区首地址（二进制安全，支持 \0 内置流）
|
||
* @param bin_size 二进制字节流的绝对有效物理字节总大小 (N)
|
||
* @param uppercase 控制开关：true 导出为大写十六进制字符串（如 "4A00FE"）；false 导出为小写（如 "4a00fe"）
|
||
* @param out_hex_str 由外部声明传入、用于承接导出的十六进制可写文本缓冲区起始地址
|
||
* @param hex_max_cap 外部文本缓冲区的最大物理插槽配额上限限制（防缓冲区溢出踩踏）
|
||
*/
|
||
c_err_t c_Hex_BinToHex(const void* in_bin, c_size_t bin_size, bool uppercase, char* out_hex_str, c_size_t hex_max_cap);
|
||
|
||
|
||
/* ================================================================================ */
|
||
#define C_HEX_SET_UINT8(array, idx, u8v) ((array)[(idx)]=(u8v)&0xFF)
|
||
|
||
#define C_HEX_SET_UINT16_BE(array, idx, u16v) \
|
||
do{ \
|
||
(array)[(idx)] = ((u16v) >> 8) & 0xFF; \
|
||
(array)[(idx)+1] = ((u16v)) & 0xFF; \
|
||
}while(0)
|
||
|
||
#define C_HEX_SET_UINT16_LE(array, idx, u16v) \
|
||
do{ \
|
||
(array)[(idx)] = ((u16v)) & 0xFF; \
|
||
(array)[(idx)+1] = ((u16v) >> 8) & 0xFF; \
|
||
}while(0)
|
||
|
||
#define C_HEX_SET_UINT24_BE(array, idx, u24v) \
|
||
do{ \
|
||
(array)[(idx)] = ((u24v) >> 16) & 0xFF; \
|
||
(array)[(idx)+1] = ((u24v) >> 8) & 0xFF; \
|
||
(array)[(idx)+2] = ((u24v)) & 0xFF; \
|
||
}while(0)
|
||
|
||
#define C_HEX_SET_UINT24_LE(array, idx, u24v) \
|
||
do{ \
|
||
(array)[(idx)] = ((u24v)) & 0xFF; \
|
||
(array)[(idx)+1] = ((u24v) >> 8) & 0xFF; \
|
||
(array)[(idx)+2] = ((u24v) >> 16) & 0xFF; \
|
||
}while(0)
|
||
|
||
#define C_HEX_SET_UINT32_BE(array, idx, u32v) \
|
||
do{ \
|
||
(array)[(idx)] = ((u32v) >> 24) & 0xFF; \
|
||
(array)[(idx)+1] = ((u32v) >> 16) & 0xFF; \
|
||
(array)[(idx)+2] = ((u32v) >> 8) & 0xFF; \
|
||
(array)[(idx)+3] = ((u32v)) & 0xFF; \
|
||
}while(0)
|
||
|
||
#define C_HEX_SET_UINT32_LE(array, idx, u32v) \
|
||
do{ \
|
||
(array)[(idx)] = ((u32v)) & 0xFF; \
|
||
(array)[(idx)+1] = ((u32v) >> 8) & 0xFF; \
|
||
(array)[(idx)+2] = ((u32v) >> 16) & 0xFF; \
|
||
(array)[(idx)+3] = ((u32v) >> 24) & 0xFF; \
|
||
}while(0)
|
||
|
||
#define C_HEX_SET_UINT64_BE(array, idx, u64v) \
|
||
do{ \
|
||
(array)[(idx)] = ((u64v) >> 56) & 0xFF; \
|
||
(array)[(idx)+1] = ((u64v) >> 48) & 0xFF; \
|
||
(array)[(idx)+2] = ((u64v) >> 40) & 0xFF; \
|
||
(array)[(idx)+3] = ((u64v) >> 32) & 0xFF; \
|
||
(array)[(idx)+4] = ((u64v) >> 24) & 0xFF; \
|
||
(array)[(idx)+5] = ((u64v) >> 16) & 0xFF; \
|
||
(array)[(idx)+6] = ((u64v) >> 8) & 0xFF; \
|
||
(array)[(idx)+7] = ((u64v)) & 0xFF; \
|
||
}while(0)
|
||
|
||
#define C_HEX_SET_UINT64_LE(array, idx, u64v) \
|
||
do{ \
|
||
(array)[(idx)] = ((u64v)) & 0xFF; \
|
||
(array)[(idx)+1] = ((u64v) >> 8) & 0xFF; \
|
||
(array)[(idx)+2] = ((u64v) >> 16) & 0xFF; \
|
||
(array)[(idx)+3] = ((u64v) >> 24) & 0xFF; \
|
||
(array)[(idx)+4] = ((u64v) >> 32) & 0xFF; \
|
||
(array)[(idx)+5] = ((u64v) >> 40) & 0xFF; \
|
||
(array)[(idx)+6] = ((u64v) >> 48) & 0xFF; \
|
||
(array)[(idx)+7] = ((u64v) >> 56) & 0xFF; \
|
||
}while(0)
|
||
|
||
#define C_HEX_GET_UINT8(array, idx) (((array)[(idx)])&0xFF)
|
||
|
||
#define C_HEX_GET_UINT16_BE(array, idx) ((((array)[(idx)]&0xFF)<<8) | ((array)[(idx)+1] & 0xFF))
|
||
#define C_HEX_GET_UINT16_LE(array, idx) (((array)[(idx)]&0xFF) | (((array)[(idx)+1] & 0xFF)<<8) )
|
||
|
||
#define C_HEX_GET_UINT24_BE(array, idx) ( (((array)[(idx)]&0xFF)<<16) | (((array)[(idx)+1]&0xFF)<<8) | ((array)[(idx)+2] & 0xFF) )
|
||
#define C_HEX_GET_UINT24_LE(array, idx) ( ((array)[(idx)]&0xFF) | (((array)[(idx)+1]&0xFF)<<8) | (((array)[(idx)+2]&0xFF)<<16) )
|
||
|
||
#define C_HEX_GET_UINT32_BE(array, idx) ( \
|
||
(((array)[(idx)]&0xFF)<<24) \
|
||
| (((array)[(idx)+1]&0xFF)<<16) \
|
||
| (((array)[(idx)+2]&0xFF)<<8) \
|
||
| ((array)[(idx)+3] & 0xFF) )
|
||
|
||
#define C_HEX_GET_UINT32_LE(array, idx) ( \
|
||
((array)[(idx)]&0xFF) \
|
||
| (((array)[(idx)+1]&0xFF)<<8) \
|
||
| (((array)[(idx)+2]&0xFF)<<16) \
|
||
| (((array)[(idx)+3]&0xFF)<<24) )
|
||
|
||
|
||
#define C_HEX_GET_UINT64_BE(array, idx) ( \
|
||
((uint64_t)((array)[(idx)]&0xFF)<<56) \
|
||
| ((uint64_t)((array)[(idx)+1]&0xFF)<<48) \
|
||
| ((uint64_t)((array)[(idx)+2]&0xFF)<<40) \
|
||
| ((uint64_t)((array)[(idx)+3]&0xFF)<<32) \
|
||
| ((uint64_t)((array)[(idx)+4]&0xFF)<<24) \
|
||
| ((uint64_t)((array)[(idx)+5]&0xFF)<<16) \
|
||
| ((uint64_t)((array)[(idx)+6]&0xFF)<<8) \
|
||
| ((uint64_t)(array)[(idx)+7] & 0xFF) )
|
||
|
||
#define C_HEX_GET_UINT64_LE(array, idx) ( \
|
||
((uint64_t)(array)[(idx)]&0xFF) \
|
||
| ((uint64_t)((array)[(idx)+1]&0xFF)<<8) \
|
||
| ((uint64_t)((array)[(idx)+2]&0xFF)<<16) \
|
||
| ((uint64_t)((array)[(idx)+3]&0xFF)<<24) ) \
|
||
| ((uint64_t)((array)[(idx)+4]&0xFF)<<32) ) \
|
||
| ((uint64_t)((array)[(idx)+5]&0xFF)<<40) ) \
|
||
| ((uint64_t)((array)[(idx)+6]&0xFF)<<48) ) \
|
||
| ((uint64_t)((array)[(idx)+7]&0xFF)<<56) )
|
||
|
||
|
||
|
||
|
||
|
||
#endif /*INCLUDED_C_HEX_H*/
|