aboutsummaryrefslogtreecommitdiffstats
path: root/util/string/hex.h
blob: 84f22ae97ef1e480884c979cf2382b4f6b5c098e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
#pragma once
 
#include <util/generic/string.h>
#include <util/generic/yexception.h>
#include <util/system/yassert.h>
 
inline static char DigitToChar(unsigned char digit) { 
    if (digit < 10) { 
        return (char)digit + '0'; 
    } 
 
    return (char)(digit - 10) + 'A'; 
} 
 
extern const char* const Char2DigitTable; 

inline static int Char2Digit(char ch) { 
    char result = Char2DigitTable[(unsigned char)ch];
    Y_ENSURE(result != '\xff', "invalid hex character " << (int)ch);
    return result;
} 
 
//! Convert a hex string of exactly 2 chars to int
/*! @example String2Byte("10") => 16 */
inline static int String2Byte(const char* s) {
    return Char2Digit(*s) * 16 + Char2Digit(*(s + 1)); 
} 
 
char* HexEncode(const void* in, size_t len, char* out);
 
TString HexEncode(const void* in, size_t len);
 
inline TString HexEncode(const TStringBuf h) {
    return HexEncode(h.data(), h.size());
}

//! Convert a hex string @c in of @c len chars (case-insensitive) to array of ints stored at @c ptr and return this array.
/*! @note len must be even (len % 2 == 0), otherwise an exception will be thrown.
 *  @return @c ptr, which is an array of chars, where each char holds the numeric value
 *          equal to the corresponding 2 digits of the input stream.
 *  @warning You must ensure that @c ptr has (len/2) allocated bytes, otherwise SIGSEGV will happen.
 *
 * @example HexDecode("beef", 4, ptr) => {190, 239}
 */
void* HexDecode(const void* in, size_t len, void* ptr);

//! Convert a hex string @c in of @c len chars (case-insensitive) to array of ints and return this array.
/*! @note len must be even (len % 2 == 0), otherwise an exception will be thrown.
 *  @return an array of chars, where each char holds the numeric value equal to the corresponding 2 digits
 *          of the input stream.
 *
 * @example HexDecode("beef", 4) => {190, 239}
 */
TString HexDecode(const void* in, size_t len);

//! Convert an ASCII hex-string (case-insensitive) to the binary form. Note that h.Size() must be even (+h % 2 == 0).
inline TString HexDecode(const TStringBuf h) {
    return HexDecode(h.data(), h.size());
}