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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
/*
* InspIRCd -- Internet Relay Chat Daemon
*
* Copyright (C) 2013, 2018 Sadie Powell <sadie@witchery.services>
* Copyright (C) 2013 Daniel Vassdal <shutter@canternet.org>
* Copyright (C) 2013 Attila Molnar <attilamolnar@hush.com>
* Copyright (C) 2012 Robby <robby@chatbelgie.be>
* Copyright (C) 2010 Daniel De Graaf <danieldg@inspircd.org>
* Copyright (C) 2008 Robin Burchell <robin+git@viroteck.net>
* Copyright (C) 2008 Pippijn van Steenhoven <pip88nl@gmail.com>
* Copyright (C) 2007, 2010 Craig Edwards <brain@inspircd.org>
* Copyright (C) 2007 Dennis Friis <peavey@inspircd.org>
*
* This file is part of InspIRCd. InspIRCd is free software: you can
* redistribute it and/or modify it under the terms of the GNU General Public
* License as published by the Free Software Foundation, version 2.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
* details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#pragma once
#include <cstring>
/** Sets ret to the formatted string. last is the last parameter before ..., and format is the format in printf-style */
#define VAFORMAT(ret, last, format) \
do { \
va_list _vaList; \
va_start(_vaList, last); \
ret.assign(InspIRCd::Format(_vaList, format)); \
va_end(_vaList); \
} while (false)
namespace Base64
{
/** The default table used when handling Base64-encoded strings. */
inline constexpr const char* TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
/** Decodes a Base64-encoded byte array.
* @param data The byte array to decode from.
* @param length The length of the byte array.
* @param table The index table to use for decoding.
* @return The decoded form of the specified data.
*/
CoreExport std::string Decode(const void* data, size_t length, const char* table = nullptr);
/** Decodes a Base64-encoded string.
* @param data The string to decode from.
* @param table The index table to use for decoding.
* @return The decoded form of the specified data.
*/
inline std::string Decode(const std::string& data, const char* table = nullptr)
{
return Decode(data.c_str(), data.length(), table);
}
/** Encodes a byte array using Base64.
* @param data The byte array to encode from.
* @param length The length of the byte array.
* @param table The index table to use for encoding.
* @param padding If non-zero then the character to pad encoded strings with.
* @return The encoded form of the specified data.
*/
CoreExport std::string Encode(const void* data, size_t length, const char* table = nullptr, char padding = 0);
/** Encodes a string using Base64.
* @param data The string to encode from.
* @param table The index table to use for encoding.
* @param padding If non-zero then the character to pad encoded strings with.
* @return The encoded form of the specified data.
*/
inline std::string Encode(const std::string& data, const char* table = nullptr, char padding = 0)
{
return Encode(data.c_str(), data.length(), table, padding);
}
}
namespace Hex
{
/** The table used for encoding as a lower-case hexadecimal string. */
inline constexpr const char* TABLE_LOWER = "0123456789abcdef";
/** The table used for encoding as an upper-case hexadecimal string. */
inline constexpr const char* TABLE_UPPER = "0123456789ABCDEF";
/** Encodes a byte array using hexadecimal encoding.
* @param data The byte array to encode from.
* @param length The length of the byte array.
* @param table The index table to use for encoding.
* @param separator If non-zero then the character to separate hexadecimal digits with.
* @return The encoded form of the specified data.
*/
CoreExport std::string Encode(const void* data, size_t length, const char* table = nullptr, char separator = 0);
/** Encodes a string using Base64.
* @param data The string to encode from.
* @param table The index table to use for encoding.
* @param separator If non-zero then the character to separate hexadecimal digits with.
* @return The encoded form of the specified data.
*/
inline std::string Encode(const std::string& data, const char* table = nullptr, char separator = 0)
{
return Encode(data.c_str(), data.length(), table);
}
}
namespace Percent
{
/** The table used to determine what characters are safe within a percent-encoded string. */
inline constexpr const char* TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_.~";
/** Decodes a percent-encoded byte array.
* @param data The byte array to decode from.
* @param length The length of the byte array.
* @return The decoded form of the specified data.
*/
CoreExport std::string Decode(const void* data, size_t length);
/** Decodes a percent-encoded string.
* @param data The string to decode from.
* @return The decoded form of the specified data.
*/
inline std::string Decode(const std::string& data)
{
return Decode(data.c_str(), data.length());
}
/** Encodes a byte array using percent encoding.
* @param data The byte array to encode from.
* @param length The length of the byte array.
* @param table The index table to use for encoding.
* @param padding If non-zero then the character to pad encoded strings with.
* @return The encoded form of the specified data.
*/
CoreExport std::string Encode(const void* data, size_t length, const char* table = nullptr, char padding = 0);
/** Encodes a string using percent encoding.
* @param data The string to encode from.
* @param table The index table to use for encoding.
* @param padding If non-zero then the character to pad encoded strings with.
* @return The encoded form of the specified data.
*/
inline std::string Encode(const std::string& data, const char* table = nullptr, char padding = 0)
{
return Encode(data.c_str(), data.length(), table, padding);
}
}
|
